UCP Manifest


GET https://app.agentcart.io/api/ucp/{slug}

Returns the store’s UCP manifest. AI agents fetch this to discover services and capabilities.

Response


{
  "ucp": {
    "version": "2026-04-08",
    "services": {
      "dev.ucp.shopping": {
        "transport": "rest/1.0",
        "endpoint": "https://app.agentcart.io/api/ucp/{slug}",
        "schema": "https://ucp.dev/schemas/shopping/rest.openapi.json"
      },
      "dev.ucp.shopping.mcp": {
        "transport": "mcp/1.0",
        "endpoint": "https://app.agentcart.io/api/ucp/{slug}/mcp",
        "schema": "https://ucp.dev/schemas/shopping/mcp.json"
      }
    },
    "capabilities": {
      "dev.ucp.shopping.catalog":     { "version": "2026-04-08" },
      "dev.ucp.shopping.checkout":    { "version": "2026-04-08" },
      "dev.ucp.shopping.cart":        { "version": "2026-04-08" },
      "dev.ucp.shopping.order":       { "version": "2026-04-08" },
      "dev.ucp.shopping.discount":    { "version": "2026-04-08" },
      "dev.ucp.shopping.fulfillment": { "version": "2026-04-08" }
    },
    "payment_handlers": {
      "redirect": {
        "type": "dev.ucp.payment.redirect",
        "redirect_url": "https://app.agentcart.io/api/ucp/{slug}/checkout-sessions"
      }
    }
  }
}

Capability advertising

Only capabilities the merchant has enabled are listed. If a store turns off discount codes under capability settings, the dev.ucp.shopping.discount key disappears from the manifest entirely — that’s how agents discover what’s available. catalog and checkout are always advertised; the others are optional.

How agents use this

Agents fetch /.well-known/ucp on the merchant’s domain. The merchant has a URL redirect pointing that to this endpoint. From the manifest, agents discover:

Which transport to use (REST or MCP)
The checkout endpoint URL
What optional capabilities are available (cart, order tracking, discounts, fulfillment quotes)