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

> De storekit merchant MCP-server: een account-scoped MCP-endpoint dat een AI-client leest van bestellingen, menu's en refunds, plus twee writes.

**Voor wie is dit:** een ontwikkelaar die een AI-client of agent koppelt aan het eigen storekit-account van een merchant. Voor de klantzijdige oppervlakken (een agent die een openbaar menu leest en een basket bouwt), zie [Ordering-agents](/docs/nl/developers/agents/ordering/overview). Voor de niet-technische installatiegidsen, zie [Verbind je AI-agent](/docs/nl/guides/ai/overview).

> [!NOTE]
>
> **Bèta-functie** - De merchant MCP is in bèta en accounts worden vanuit een wachtlijst ingeschakeld. [Vraag toegang aan](https://t09czsyu90l.typeform.com/to/G6rIJWNv), of mail [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-responses (geen SSE-streaming) |
| Methodes | `POST` voor JSON-RPC-berichten; `GET` en `DELETE` volgens de transport-spec |
| Sessie | Stateless. `initialize` geeft een `Mcp-Session-Id`-header terug, maar verzoeken worden er niet tegen gevalideerd |
| Auth | OAuth 2.1 bearer token — zie [Authenticatie](/docs/nl/developers/mcp/authentication) |
| Discovery | `GET /.well-known/oauth-protected-resource` |

Elk verzoek maakt een verse MCP-server gebonden aan het geauthenticeerde account, verwerkt één bericht en sluit. Er wordt niets onthouden tussen calls; een gesprek draagt zelf venue-IDs en order-IDs.

## Tools

Achttien tools, allemaal binnen de scope van het geauthenticeerde account. Zestien zijn read-only (`readOnlyHint: true`); `create-discount-code` en `create-payment-link` zijn writes. De volledige inputreferentie staat op [Tools](/docs/nl/developers/mcp/tools).

| Domein | Tools |
| - | - |
| Venues | `list-venues`, `get-venue` |
| Orders | `list-orders`, `get-order`, `get-order-events` |
| Menus | `list-menus`, `get-menu` |
| Snoozing | `get-snooze-report` |
| Stats | `get-order-stats`, `list-top-products` |
| Discounts | `list-discount-codes`, `create-discount-code` |
| Refunds | `list-refunds` |
| Pay at table | `list-bills` |
| Payment links | `list-payment-links`, `get-payment-link`, `create-payment-link`, `get-payment-link-qr` |

Er zijn geen tools die orders, menu's, venues, gebruikers of instellingen muteren.

## Contract in het kort

* Elke success is een `{ data, meta }`-envelop, teruggegeven als `structuredContent` én als JSON in het eerste tekstblok. Elke tool publiceert er een `outputSchema` voor. Zie [Response-formaat](/docs/nl/developers/mcp/response-format).
* Errors zijn alleen-tekst `isError: true`-resultaten met een `{ error }`-envelop met een stabiele `code`. Zie [Errors](/docs/nl/developers/mcp/errors).
* Geld is in **minor units** met een expliciete valutacode. Datums zijn strikt ISO. Venue-scoped queries defaulten naar de tijdzone van het filiaal, account-brede queries naar UTC.
* Paginering start op pagina 1, is begrensd op 100 rijen en meldt `hasMore`/`nextPage` op basis van een lookahead van één rij in plaats van op totalen.

## Limieten

| Limiet | Waarde |
| - | - |
| Rate | 60 verzoeken per minuut per gebruiker; `429` met `Retry-After` daarboven |
| Tool-timeout | 30 seconden; een write met timeout kan nog wel voltooid zijn |
| Paginagrootte | 100 rijen (25 voor `list-top-products`) |
| Datumbereik | 90 lokale kalenderdagen, inclusief |
| Snooze-events per item | 100, gevlagd met `eventsTruncated` |

## Referentie

> **[Authenticatie](/docs/nl/developers/mcp/authentication)**
>
> OAuth-discovery en aanmelden, hoe het account wordt gekozen.

> **[Tools](/docs/nl/developers/mcp/tools)**
>
> Elke tool met haar inputs, defaults en datumbasis.

> **[Response-formaat](/docs/nl/developers/mcp/response-format)**
>
> De envelop, paginering, datums, tijdzones en geld.

> **[Errors](/docs/nl/developers/mcp/errors)**
>
> Errorcodes, retryregels en de vormen die clients moeten afhandelen.


## Related topics

- [Introductie voor ontwikkelaars](/docs/nl/developers/introduction.md)
- [Overzicht van ordering-agents](/docs/nl/developers/agents/ordering/overview.md)
- [MCP-endpoint](/docs/nl/developers/agents/ordering/mcp-endpoint.md)
- [Overzicht betaallinks](/docs/nl/payment-links/overview.md)
- [Webhooks-overzicht](/docs/nl/developers/webhooks/overview.md)


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