Agent-facing shopping bridge for grayporter.com.
This service exposes GrayPorter's live catalog, cart, and checkout through the Model Context Protocol (MCP) so AI assistants — ChatGPT, Gemini, Claude, Perplexity — can search the catalog, build carts, and continue to secure checkout on the user's behalf.
| Path | Purpose |
|---|---|
POST /mcp | MCP streamable-HTTP transport (8 tools: search_catalog, get_product, create/get/update/cancel_cart, create/cancel_checkout). |
GET /ucp/products | UCP relay — catalog search. |
GET /ucp/products/:id | UCP relay — product detail. |
POST /ucp/carts | UCP relay — create cart. |
POST /ucp/checkouts | UCP relay — create checkout session. |
POST /ucp/checkouts/:id/complete | UCP relay — capture payment + create order. |
GET /ucp/orders/:id | UCP relay — order detail (status + tracking). |
POST /ucp/orders/lookup | UCP relay — order lookup by email + order_number. |
POST /webhooks/order | Inbound — TPH order_created webhook (HMAC-SHA256 signed). |
ALL /acp/* | ACP (OpenAI Instant Checkout) — 503 coming_soon until OpenAI Merchant accounts open. |
GET /healthz | Health probe (JSON). |
GET /openapi.json | OpenAPI 3.1 manifest. |
GET /.well-known/mcp-manifest.json | MCP discovery. |
No login, no OAuth. Anyone can connect. Rate-limited at 100 requests / minute / IP.