> ## 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

> Das Universal-Commerce-Protocol-Profil, das ein storekit-Ordering-Host unter /.well-known/ucp veröffentlicht: verkaufte Lokale und deren MCP-Cart-Endpoints.

**Für wen das ist:** eine Commerce-Plattform oder ein Agent-Host, der Kunden mit Händlern verbindet.

Ein [UCP](https://ucp.dev/2026-08-25/specification/overview/)-Client liest ein Profil, bevor er sich mit irgendetwas verbindet: welche Dienste ein Unternehmen spricht, über welchen Transport, an welchem Endpoint und welche Capabilities diese Endpoints implementieren. Ein storekit-Ordering-Host veröffentlicht dieses Profil, und die darin genannten Endpoints sind die kundenseitigen [MCP-Endpoints](/docs/de/developers/agents/ordering/mcp-endpoint).

## Pfade

| Pfad | Antwortet mit |
| - | - |
| `GET https://{host}/.well-known/ucp` | Jedes Lokal, für das der Host verkauft, jeweils als eigener Service-Eintrag |
| `GET https://{host}/{venueSlug}/.well-known/ucp` | Dieses eine Lokal |

Ein Host verkauft für viele Lokale, und jedes hat seinen eigenen MCP-Endpoint, weshalb das Host-Profil sie auflistet — begrenzt auf 25, wie jede andere für Agenten sichtbare Liste — und ein Agent, der bereits über ein Lokal spricht, liest stattdessen den Lokal-Pfad. Welche Lokale erscheinen, ergibt sich aus dem Host selbst, sodass eine Marke auf ihrer eigenen Domain die Standorte dieser Marke bewirbt und nichts anderes.

Antworten sind JSON, für 15 Minuten gecacht und für jeden Origin offen. Ein Host ohne Lokale oder ein Venue-Slug, der nicht auflösbar ist, ergibt einen `404`: Kein Profil ist besser als ein Profil ohne Endpoint darin.

## Profil

```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": {}
  }
}
```

| Feld | Bedeutung |
| - | - |
| `services["dev.ucp.shopping"]` | Ein Eintrag pro Lokal. Einträge unterscheiden sich nur im `endpoint`, und jede `id` ist der Venue-Slug, den die übrige API spricht. |
| `transport` | Nur `mcp`. Es ist der einzige Transport, den der Host anbietet; UCPs In-Page-Transport ist das eingebettete Iframe-Protokoll, auf das diese Seiten nicht lauschen. |
| `schema` | Das Binding, gegen das ein Client Aufrufe validiert, sowohl am Service-Eintrag als auch an der Capability. |
| `capabilities["dev.ucp.shopping.cart"]` | Die vier Cart-Tools am deklarierten Endpoint: `create_cart`, `get_cart`, `update_cart`, `cancel_cart`. |
| `payment_handlers` | Bewusst leer deklariert. Die Zahlung wird auf der Seite des Lokals selbst abgewickelt, es gibt also keinen Handler, gegen den eine Plattform tokenisieren könnte — ein leeres Objekt sagt „keiner angeboten", wo ein fehlender Schlüssel als unfertiges Profil gelesen würde. |

Jeder deklarierte Endpoint beantwortet einen `GET`-Probe mit `200`, und die `robots.txt` des Ordering-Hosts nennt die Agent-Crawler namentlich, sodass der Well-known-Pfad ihnen eindeutig erlaubt ist.


## Related topics

- [MCP-Endpoint](/docs/de/developers/agents/ordering/mcp-endpoint.md)
- [Übersicht der Bestell-Agenten](/docs/de/developers/agents/ordering/overview.md)
- [Event-Tracking](/docs/de/privacy-security/event-tracking.md)
- [Einführung für Entwickler](/docs/de/developers/introduction.md)
- [Authentifizierung](/docs/de/developers/mcp/authentication.md)


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