Skip to main content
Glama

Server Details

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

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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

A4.5/5.0

Scored across 4 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count4/5

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.

Completeness3/5

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 tools
cancel_orderCancel an orderA
DestructiveIdempotent
Inspect

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 orderA
Idempotent
Inspect

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 detailsA
Read-only
Inspect

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 productsA
Read-only
Inspect

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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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.
      -
    • F
      license
      A
      quality
      D
      maintenance
      An 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.