Skip to main content
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. Voor de niet-technische installatiegidsen, zie Verbind je AI-agent.
Bèta-functie - De merchant MCP is in bèta en accounts worden vanuit een wachtlijst ingeschakeld. Vraag toegang aan, of mail mcp@storekit.com.

Endpoint

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. 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.
  • Errors zijn alleen-tekst isError: true-resultaten met een { error }-envelop met een stabiele code. Zie 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

Referentie

Authenticatie

OAuth-discovery en aanmelden, hoe het account wordt gekozen.

Tools

Elke tool met haar inputs, defaults en datumbasis.

Response-formaat

De envelop, paginering, datums, tijdzones en geld.

Errors

Errorcodes, retryregels en de vormen die clients moeten afhandelen.