io.github.apitoagents/sample-shop-mcp

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 passed

Reviewed 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.