> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# UCP-discovery

> Het Universal Commerce Protocol-profiel dat een storekit-ordering-host publiceert op /.well-known/ucp: de verkochte venues en hun MCP-cart-endpoints.

**Voor wie dit is:** een commerceplatform of agent-host die klanten met merchants verbindt.

Een [UCP](https://ucp.dev/2026-08-25/specification/overview/)-client leest een profiel voordat hij ergens verbinding mee maakt: welke services een business spreekt, over welk transport, op welk endpoint en welke capabilities die endpoints implementeren. Een storekit-ordering-host publiceert dat profiel, en de endpoints die daarin genoemd worden zijn de klantgerichte [MCP-endpoints](/docs/nl/developers/agents/ordering/mcp-endpoint).

## Paden

| Pad | Antwoordt met |
| - | - |
| `GET https://{host}/.well-known/ucp` | Elke venue waarvoor de host verkoopt, elk als eigen service-entry |
| `GET https://{host}/{venueSlug}/.well-known/ucp` | Die ene venue |

Eén host verkoopt voor veel venues en elk heeft zijn eigen MCP-endpoint, dus het host-profiel somt ze op — begrensd op 25, zoals elke andere agent-facing lijst — en een agent die het al over een venue heeft, leest in plaats daarvan het venue-pad. Welke venues verschijnen komt van de host zelf, dus een brand op zijn eigen domein adverteert de locaties van dat brand en verder niets.

Responses zijn JSON, 15 minuten gecached en open voor elke origin. Een host zonder venues, of een venue-slug die niet resolvet, is een `404`: geen profiel is beter dan een profiel zonder endpoint erin.

## Profiel

```json theme={null}
{
  "ucp": {
    "version": "2026-08-25",
    "services": {
      "dev.ucp.shopping": [
        {
          "id": "gordon-ramsay-plane-food-1",
          "version": "2026-08-25",
          "spec": "https://ucp.dev/2026-08-25/specification/overview",
          "transport": "mcp",
          "endpoint": "https://order.storekit.com/gordon-ramsay-plane-food-1/api/mcp",
          "schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
        }
      ]
    },
    "capabilities": {
      "dev.ucp.shopping.cart": [
        {
          "version": "2026-08-25",
          "spec": "https://ucp.dev/2026-08-25/specification/shopping/cart",
          "schema": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json"
        }
      ]
    },
    "payment_handlers": {}
  }
}
```

| Veld | Betekenis |
| - | - |
| `services["dev.ucp.shopping"]` | Eén entry per venue. Entries verschillen alleen in `endpoint`, en elke `id` is de venue-slug die de rest van de API spreekt. |
| `transport` | Alleen `mcp`. Het is het enige transport dat de host serveert; het in-page transport van UCP is het embedded-iframe-protocol, waar deze pagina's niet naar luisteren. |
| `schema` | De binding waartegen een client calls valideert, zowel op de service-entry als op de capability. |
| `capabilities["dev.ucp.shopping.cart"]` | De vier cart-tools op het gedeclareerde endpoint: `create_cart`, `get_cart`, `update_cart`, `cancel_cart`. |
| `payment_handlers` | Bewust leeg gedeclareerd. Betaling wordt afgehandeld op de eigen pagina van de venue, dus er is geen handler waar een platform tegen kan tokenizen — een leeg object zegt "geen aangeboden", waar een ontbrekende key zou lezen als een onvoltooid profiel. |

Elk gedeclareerd endpoint antwoordt een `GET`-probe met `200`, en de `robots.txt` van de ordering-host noemt de agent-crawlers zodat het well-known-pad ondubbelzinnig voor ze is toegestaan.


## Related topics

- [Overzicht van ordering-agents](/docs/nl/developers/agents/ordering/overview.md)
- [MCP-endpoint](/docs/nl/developers/agents/ordering/mcp-endpoint.md)
- [Event tracking](/docs/nl/privacy-security/event-tracking.md)
- [Introductie voor ontwikkelaars](/docs/nl/developers/introduction.md)
- [Authenticatie](/docs/nl/developers/mcp/authentication.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.