Sample Shop MCP server
Server Details
Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- apitoagents/mcp-examples
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 4 tools
Each tool targets a distinct resource+action: order creation, order cancellation, single-product lookup, and catalogue search. Descriptions explicitly delimit boundaries (search_products notes it does not place orders; get_product points to search_products for name-based lookups), leaving no room for misselection.
All four tools follow a strict verb_noun snake_case pattern (create_order, cancel_order, get_product, search_products). The convention is uniform with no deviations in style or casing.
Four tools is on the low end for a shop domain but still within a reasonable, well-scoped range for a sample server. Each tool earns its place, though the surface is slightly thin given the domain's potential breadth.
Order creation and cancellation exist, but there is no way to retrieve or list existing orders (no get_order/list_orders), which is a notable lifecycle gap. Product coverage (get + search) is adequate for browsing, but the order side leaves agents without a way to check status after creation.
Available Tools
4 toolscancel_orderCancel an orderADestructiveIdempotentInspect
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.
Inputs: orderId (required), confirm.
create_orderCreate an orderAIdempotentInspect
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.
Inputs: quantity (required), productId (required), idempotencyKey (required).
get_productGet product detailsARead-onlyInspect
Return the full details of one product by its id (for example p-1001). Use search_products first if you only know a name.
Inputs: productId (required).
search_productsSearch productsARead-onlyInspect
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.
Inputs: limit, query, cursor, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Demo banking MCP server: accounts, transactions and payments. OAuth 2.1 with DPoP.
MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for a demo Nintendo Switch game shop. Enables agents to list/search games, manage the cart, and perform demo checkout while sharing state with the web UI.-
- FlicenseAqualityDmaintenanceAn MCP server that enables natural language catalog search, cart management, and checkout workflows against the Fake Store API, with strict schemas and session-persistent carts.8-
- FlicenseNot gradedqualityDmaintenanceMCP server for operating a fictional restaurant, providing tools to consult the menu, manage active orders, view shift summaries, update dish availability, and advance order statuses. Includes a playground that teaches JSON-RPC by showing live protocol interactions.1-
- FlicenseNot gradedqualityDmaintenanceDemo MCP server that exposes order and customer data as read-only tools for AI assistants, simulating a business API or internal data source.-
Glama MCP Gateway
Add one secure layer between your agents and this server.