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

# Merchant-MCP-Übersicht

> Remote, kontobezogener MCP-Server, der einem KI-Client Lesezugriff auf storekit-Bestellungen, Menüs, Statistiken und Rechnungen sowie zwei Writes gibt.

**Für wen das ist:** ein Entwickler, der einen KI-Client oder Agenten an das eigene storekit-Konto eines Merchants anschließt. Für die kundenseitigen Oberflächen — ein Agent, der ein öffentliches Menü liest und einen Warenkorb baut — siehe [Bestell-Agenten](/docs/de/developers/agents/ordering/overview). Für die nicht-technischen Einrichtungsanleitungen siehe [Ihren KI-Agenten verbinden](/docs/de/guides/ai/overview).

> [!NOTE]
>
> **Beta-Funktion** - Das Merchant MCP befindet sich in der Beta, und Konten werden von einer Warteliste aus aktiviert. [Zugriff anfragen](https://t09czsyu90l.typeform.com/to/G6rIJWNv), oder eine E-Mail an [mcp@storekit.com](mailto:mcp@storekit.com).

## Endpoint

| | |
| - | - |
| URL | `https://mcp.storekit.com/mcp` |
| Transport | MCP [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports), JSON-Antworten (kein SSE-Streaming) |
| Methoden | `POST` für JSON-RPC-Nachrichten; `GET` und `DELETE` gemäß Transport-Spezifikation |
| Session | Zustandslos. `initialize` gibt einen `Mcp-Session-Id`-Header zurück, Anfragen werden aber nicht dagegen validiert |
| Auth | OAuth-2.1-Bearer-Token — siehe [Authentifizierung](/docs/de/developers/mcp/authentication) |
| Discovery | `GET /.well-known/oauth-protected-resource` |

Jede Anfrage erzeugt einen frischen MCP-Server, gebunden an das authentifizierte Konto, verarbeitet eine Nachricht und schließt. Zwischen Aufrufen wird nichts gespeichert; eine Konversation trägt Filial-IDs und Bestell-IDs selbst.

## Tools

Achtzehn Tools, alle auf das authentifizierte Konto beschränkt. Sechzehn sind read-only (`readOnlyHint: true`); `create-discount-code` und `create-payment-link` sind Writes. Die vollständige Input-Referenz steht auf [Tools](/docs/de/developers/mcp/tools).

| Domain | Tools |
| - | - |
| Filialen | `list-venues`, `get-venue` |
| Bestellungen | `list-orders`, `get-order`, `get-order-events` |
| Menüs | `list-menus`, `get-menu` |
| Snoozing | `get-snooze-report` |
| Statistiken | `get-order-stats`, `list-top-products` |
| Rabatte | `list-discount-codes`, `create-discount-code` |
| Rückerstattungen | `list-refunds` |
| Pay at Table | `list-bills` |
| Payment Links | `list-payment-links`, `get-payment-link`, `create-payment-link`, `get-payment-link-qr` |

Es gibt keine Tools, die Bestellungen, Menüs, Filialen, Benutzer oder Einstellungen verändern.

## Vertrag im Kurzüberblick

* Jeder Erfolg ist ein `{ data, meta }`-Envelope, zurückgegeben sowohl als `structuredContent` als auch als JSON im ersten Text-Block. Jedes Tool veröffentlicht ein `outputSchema` dafür. Siehe [Response-Format](/docs/de/developers/mcp/response-format).
* Fehler sind ausschließlich als Text vorliegende `isError: true`-Ergebnisse, die einen `{ error }`-Envelope mit einem stabilen `code` tragen. Siehe [Fehler](/docs/de/developers/mcp/errors).
* Geld ist in **Minor Units** mit explizitem Währungscode. Datumsangaben sind striktes ISO. Filialbezogene Anfragen verwenden standardmäßig die Zeitzone der Filiale, kontoweite Anfragen UTC.
* Paginierung beginnt bei Seite 1, ist auf 100 Zeilen begrenzt und meldet `hasMore`/`nextPage` über einen Ein-Zeilen-Lookahead statt über Gesamtsummen.

## Limits

| Limit | Wert |
| - | - |
| Rate | 60 Anfragen pro Minute pro Benutzer; `429` mit `Retry-After` darüber hinaus |
| Tool-Timeout | 30 Sekunden; ein abgelaufener Write kann trotzdem abgeschlossen worden sein |
| Seitengröße | 100 Zeilen (25 für `list-top-products`) |
| Datumsbereich | 90 lokale Kalendertage, inklusive |
| Snooze-Events pro Artikel | 100, gekennzeichnet mit `eventsTruncated` |

## Referenz

> **[Authentifizierung](/docs/de/developers/mcp/authentication)**
>
> OAuth-Discovery und Anmeldung, wie das Konto gewählt wird.

> **[Tools](/docs/de/developers/mcp/tools)**
>
> Jedes Tool mit seinen Inputs, Defaults und Datumsbasis.

> **[Response-Format](/docs/de/developers/mcp/response-format)**
>
> Der Envelope, Paginierung, Datumsangaben, Zeitzonen und Geld.

> **[Fehler](/docs/de/developers/mcp/errors)**
>
> Fehlercodes, Retry-Regeln und die Formen, die Clients behandeln müssen.


## Related topics

- [Einführung für Entwickler](/docs/de/developers/introduction.md)
- [Übersicht der Bestell-Agenten](/docs/de/developers/agents/ordering/overview.md)
- [Integrationen – Übersicht](/docs/de/guides/integrations/overview.md)
- [Bestellungen – Übersicht](/docs/de/guides/orders/overview.md)
- [Webhooks-Übersicht](/docs/de/developers/webhooks/overview.md)


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