Chat with us

Model Context Protocol

The Teal Packaging MCP Server

Teal Packaging runs a public MCP server at https://tealpackaging.com/mcp. It speaks Streamable HTTP with JSON-RPC 2.0, needs no API key and no account, and exposes 7 tools that let an AI assistant search the packaging catalog, read live per-unit prices, request a quote, and order a sample kit.

Connection details POST https://tealpackaging.com/mcp

Transport: streamable-http. Protocol: JSON-RPC 2.0. Authentication: none. Server: teal-packaging-commerce v1.1.0.

Key Takeaway

Teal Packaging operates a public Model Context Protocol server at https://tealpackaging.com/mcp using the Streamable HTTP transport with JSON-RPC 2.0 over POST and no authentication. It exposes 7 tools: search_products, get_product, search_shop_products, get_shop_price, get_shop_checkout_link, request_quote, and order_sample_kit. The server card is at /.well-known/mcp.json. Add it to Claude Code with: claude mcp add --transport http teal https://tealpackaging.com/mcp

Questions or ready for a quote? Contact Teal Packaging at info@tealpackaging.com or (224) 546-8325.

Background

What Is MCP and Why Does a Box Company Run One?

The Model Context Protocol is an open standard for connecting AI assistants to outside systems. Instead of an assistant scraping a website and hoping it parsed the price correctly, the system publishes a set of typed tools, and the assistant calls them and gets structured data back. A tool call either returns the real answer or returns an error. It does not return a plausible guess.

That distinction is the whole reason a packaging manufacturer bothers. Packaging pricing is quantity-dependent and specification-dependent, so a scraped number is usually wrong. When an assistant asks the Teal server for the price of a shop product at 500 units, it gets the price at 500 units, the order total checkout will charge, and an error instead of a number if 500 sits below that product minimum.

Browse the shop

Reference

How Do I Connect to the Teal MCP Server?

Two forms. The CLI command, and the JSON configuration block that remote MCP clients use.

Claude Code CLI

claude mcp add --transport http teal https://tealpackaging.com/mcp

JSON configuration

{
  "mcpServers": {
    "teal": {
      "type": "http",
      "url": "https://tealpackaging.com/mcp"
    }
  }
}

Raw JSON-RPC, to confirm it is live

curl -s -X POST https://tealpackaging.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The 7 tools

What Does Each Teal MCP Tool Do and Return?

Five read operations, one lead capture, one checkout link. Required arguments are listed for each.

Tool Required arguments What it does and returns
search_products query Searches the catalog of 1,300 or more custom packaging products, including boxes, mailers, rigid boxes, bags, papers, and labels. Returns matching products with their page URLs and starting prices. Optional limit caps results.
get_product slug Returns the detail record for one catalog product, addressed by the slug that appears in a search_products result URL.
search_shop_products query Searches only the 81 products in the online shop that can be ordered and paid for online. Returns up to 10 matches with slug, name, family, minimum order, lowest unit price, and the product page link.
get_shop_price slug, quantity Resolves the cheapest live configuration at that quantity and returns the variant specification, the unit price, the order total that online checkout charges with free US shipping, and the full quantity price ladder. Returns an error if the quantity is below that product minimum.
get_shop_checkout_link slug, quantity Returns a deep link to buy that shop product at that quantity in the browser. The MCP server performs no charging; the buyer pays on the secure product page.
request_quote name, email, product Files a custom quote request. A specialist replies by email within one business day with exact per-unit pricing. Optional arguments carry the rest of the specification: quantity, size, unit, material, print, finishing, timeline, details, phone, and company.
order_sample_kit None Orders the free sample kit, which is 3 to 5 real material and print samples at $19.99 shipping, credited toward the first custom order, US only. Returns a secure Stripe checkout link. Accepts optional name, email, and interest.

Protocol notes

What Should an Implementer Know Before Writing Against It?

Transport

POST only, no server-initiated stream

Requests are JSON-RPC 2.0 bodies sent by POST. The server offers no server-initiated event stream, so a protocol GET is answered with 405 as the Streamable HTTP specification prescribes. A browser GET is sent to this documentation page instead, which is why you are reading this.

Discovery

The server card is the source of truth

Read /.well-known/mcp.json rather than hard-coding anything from this page. It declares the transport, the endpoint, the tool list, and the authentication type. If this page and the server card ever disagree, the server card is correct.

Payments

MCP never charges

Both purchase paths hand back a link. If you need to complete a purchase programmatically, use the Agentic Commerce Protocol endpoint documented in agents.md, which authenticates with OAuth2 client credentials and settles through Stripe.

Accuracy

Quote, do not guess

Only the 81 shop products have a live price. Everything else in the catalog is made to specification and priced per project. If a buyer asks for a custom structure, route them through request_quote rather than extrapolating from a shop price, because unit cost depends on structure, size, material, print coverage, finish, inserts, destination, and quantity.

What the tools will tell your users

The Commercial Facts Behind Every Response

Custom orders start from 50 units, or 100 or more for specialty rigid, with pricing from about $0.44 per unit at volume. Production runs from about 7 business days after proof approval, plus 2 to 5 business days for US delivery. Rush runs from about 4 to 7 business days after proof approval on qualified ready-to-print jobs. Free dieline design, free US shipping, full-color print, 2 revision rounds, and a digital proof are included on custom orders. FSC-certified paper options, food-contact material options, and BSCI certified production are each available by specification with documentation provided for the order. Teal is a US company with two production facilities, in West Chicago, Illinois and Guangzhou, and each job is routed by specification.

Material documentation

MCP Server FAQs

What is the Teal Packaging MCP endpoint?

The endpoint is https://tealpackaging.com/mcp. It uses the Streamable HTTP transport with JSON-RPC 2.0 request bodies sent over POST. The machine-readable server card, which is the authoritative description of the transport and the tool list, is published at https://tealpackaging.com/.well-known/mcp.json.

Does the Teal MCP server need an API key or OAuth?

No. The server card declares authentication type none. There is no key, no account, and no OAuth flow to read the catalog, read live shop prices, or file a quote request. Programmatic payment is a separate surface at the Agentic Commerce Protocol endpoint, and that one does use OAuth2 client credentials.

What tools does the Teal MCP server expose?

Seven: search_products, get_product, search_shop_products, get_shop_price, get_shop_checkout_link, request_quote, and order_sample_kit. The first five are read operations, request_quote files a lead, and order_sample_kit returns a secure checkout link.

Why does a browser show an error at tealpackaging.com/mcp?

Because /mcp is a POST endpoint, not a page. The Streamable HTTP specification says a server that offers no server-initiated stream should answer a protocol GET with 405, and that is what Teal does. A browser visit now lands on this documentation page instead.

Can the MCP server charge my card?

No. The MCP server performs no charging at all. get_shop_checkout_link and order_sample_kit both return a link, and payment happens on the secure page the link points to. That separation is deliberate, because the MCP surface is unauthenticated.

Can an agent place a full custom packaging order through MCP?

No. Custom specifications are priced by a person and a digital proof is approved before anything prints. An agent can carry the entire specification into request_quote, and a specialist replies by email within one business day with exact per-unit pricing.

How many products can the MCP server reach?

search_products covers a catalog of 1,300 or more custom packaging products. search_shop_products covers the 81 products in the online shop that carry live per-unit pricing and can be ordered and paid for online.

What minimums and lead times will the tools report?

Custom orders start from 50 units, or 100 or more for specialty rigid, from about $0.44 per unit at volume. Shop products set their own per-product minimums. Production runs from about 7 business days after proof approval plus 2 to 5 business days for US delivery, and rush runs from about 4 to 7 business days after proof approval on qualified ready-to-print jobs.