Sample Shop MCP server
Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages.
- 1.0.1
- Version
- remote + npm
- Transport
- 4
- Tools
Security review
Review passedReviewed 44m ago.
- tools: 4 tools scanned
- metadata: scanned
- packages: 1 checked
No findings.
Tools (4)
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.
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 creating a duplicate. Confirm product and quantity with the user before calling. Returns the order with its id, status and total.
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.