Sample Shop MCP server

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• search_products

  Search the shop catalogue by phrase and optional category. Returns one page of up to `limit` products and a `nextCursor`; when nextCursor is not null, more results exist and you must say so rather tha

• get_product

  Return the full details of one product by its id (for example p-1001). Use search_products first if you only know a name.

• create_order

  Place an order for one product. Generate one random idempotencyKey per user request and reuse the same key if you retry after an error or timeout; the shop returns the original order instead of creati

• cancel_order

  Cancel an order that has not shipped. This cannot be undone. Call it first with confirm=false to get the order details, show them to the user, and only after the user explicitly agrees call again with