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 alsstructuredContentén als JSON in het eerste tekstblok. Elke tool publiceert er eenoutputSchemavoor. Zie Response-formaat. - Errors zijn alleen-tekst
isError: true-resultaten met een{ error }-envelop met een stabielecode. 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/nextPageop 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.