MCP server

The MCP endpoint, headers an external client sends, and tool list.

POST /api/mcp-transport/http is a JSON-RPC server (initialize, tools/list, tools/call). GET returns the admitted store list.

Headers

HeaderContent
x-cart-idsJSON map of store ID to cart ID
x-cart-proofsJSON map of store ID to cart proof
x-marketplace-configOptional JSON array of selected stores, up to 20
Authorization: Bearer <token>Session token for the store named in the call only

Results may carry _meta.marketplace.clientAction of type saveCartId or saveSessionToken. Store them per store ID.

Product, cart and checkout cards need a client that renders MCP UI resources.

See MCP tools.

On this page