# Teal Packaging: Agent Integration Guide

Teal Packaging (https://tealpackaging.com) is a US-based custom packaging supplier that supports
AI-agent commerce. This document describes machine-readable surfaces for autonomous agents.

## Quick facts
- Products: custom printed boxes, mailers, cartons, rigid boxes, bags, papers, labels (made-to-order)
- Minimums: set per product. Shop items start as low as 5 units; custom-made packaging starts at 50 units (specialty rigid 100+)
- Pricing: 81 products at https://tealpackaging.com/shop/ carry live per-unit pricing at every quantity break and can be ordered and paid for online; everything else is made to spec and quoted per project from $0.44/unit at volume
- Sample kit: $50, credited toward the first custom order
- Shipping: free US shipping on custom orders. Turnaround is stated per product, from about 7 business days after proof approval for in-house items up to about 12 weeks for specialty imported items, plus 2 to 5 business days US delivery

## Pricing (machine-readable)
- Full per-product pricing summary: https://tealpackaging.com/pricing.md (markdown, 81 live shop products with minimum order, price at minimum, price at volume, turnaround)
- Live authoritative pricing: the MCP tool search_products

## MCP server (any agent platform)
- Endpoint: `https://tealpackaging.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no auth required)
- Tools: `search_products`, `get_product`, `search_shop_products`, `get_shop_price`, `get_shop_checkout_link`, `request_quote`, `order_sample_kit`
- Claude Code: `claude mcp add --transport http teal https://tealpackaging.com/mcp`
- Checkout links: `get_shop_checkout_link` and `order_sample_kit` may return Teal-hosted checkout URLs.

## A2A (Agent2Agent)
- Agent Card: https://tealpackaging.com/.well-known/agent-card.json (also at /.well-known/agent.json)
- JSON-RPC endpoint: https://tealpackaging.com/a2a (method `message/send`; discovery via `agent/getAuthenticatedExtendedCard`)
- Skills: search_products, request_quote, order_sample_kit. AP2 payments extension declared (settles via ACP/Stripe).

## Agentic Checkout (ACP)
Teal exposes authenticated Agentic Commerce Protocol pilot endpoints (API version 2025-09-29).

- Base URL: `https://tealpackaging.com/acp`
- Endpoints:
  - `POST /acp/checkout_sessions`
  - `GET  /acp/checkout_sessions/{id}`
  - `POST /acp/checkout_sessions/{id}` (update)
  - `POST /acp/checkout_sessions/{id}/complete`
  - `POST /acp/checkout_sessions/{id}/cancel`
- Payment: Stripe (delegated payment token)
- Auth: per-partner Bearer API key. Agent platforms: request credentials via
  https://tealpackaging.com/contact-us/ (subject: "ACP access").

For supported shop products, Teal may return a Teal-hosted checkout URL. Payment and order completion occur on tealpackaging.com. This is external merchant checkout, not native ChatGPT or OpenAI checkout. The current OpenAI product feed marks all offers `checkout_eligible=false`.

Teal also exposes authenticated ACP pilot endpoints separately. Their availability is not evidence of OpenAI merchant approval, ChatGPT shopping visibility, or native OpenAI checkout eligibility.

## Product feed
- OpenAI/agentic format: `https://tealpackaging.com/feeds/openai-products.tsv`
  (100 exact variant-plus-quantity offers across 80 eligible product groups; all 100 search eligible; 0 OpenAI checkout eligible)
- Google Merchant format: `https://tealpackaging.com/feeds/google-merchant.php`

## Content for LLMs
- `https://tealpackaging.com/llms.txt`: entity, capabilities, canonical facts
- Product pages carry Product + Offer + FAQ JSON-LD; quotes via `https://tealpackaging.com/request-quote/`

## Humans
Sales & support: https://tealpackaging.com/contact-us/