io.github.apitoagents/sample-shop-mcp

pkg:npm:@apitoagents/sample-shop-mcp

Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages.

transport:: remote + stdio
credential class:: open
repo:: https://github.com/apitoagents/mcp-examples

Owner verification

Not yet verified. Verifying proves you control this server and is free, permanently — it never changes a published score.

Start verification →

Tools

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 confirm=true.
shallow
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 creating a duplicate. Confirm product and quantity with the user before calling. Returns the order with its id, status and total.
shallow
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.
shallow
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 than claiming the list is complete. Use get_product for full details of one item. This tool does not place orders.
shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/7e65ed51-33cf-40b3-a3bc-183cdabaafc6/badge.svg)](https://vouch.tools/servers/7e65ed51-33cf-40b3-a3bc-183cdabaafc6)