protogrid

Search / io.github.apitoagents/sample-shop-mcp

Sample Shop MCP server

R0· no sign-in

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

v1.0.1 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality92strong
Trust97of 100
Uptime, 30 days100%
Latency p50318 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "sample-shop-mcp": {
      "type": "http",
      "url": "https://demo.apitoagents.com/mcp"
    }
  }
}
claude mcp add --transport http sample-shop-mcp https://demo.apitoagents.com/mcp
[mcp_servers.sample-shop-mcp]
url = "https://demo.apitoagents.com/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sample-shop-mcp": {
      "type": "remote",
      "url": "https://demo.apitoagents.com/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "sample-shop-mcp": {
      "type": "http",
      "url": "https://demo.apitoagents.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=sample-shop-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZGVtby5hcGl0b2FnZW50cy5jb20vbWNwIn0%3D"
}
{
  "servers": {
    "sample-shop-mcp": {
      "type": "http",
      "url": "https://demo.apitoagents.com/mcp"
    }
  }
}
{
  "mcpServers": {
    "sample-shop-mcp": {
      "httpUrl": "https://demo.apitoagents.com/mcp"
    }
  }
}
extensions:
  "sample-shop-mcp":
    enabled: true
    name: "sample-shop-mcp"
    type: streamable_http
    uri: "https://demo.apitoagents.com/mcp"
    timeout: 300

Quality 92 / 100strong

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene93 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
  • warn
    tools.directory_hints2 of 4 tools declare all four hints; missing: search_products (destructiveHint, idempotentHint); get_product (destructiveHint, idempotentHint)
  • pass
    tools.token_costabout 703 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know @apitoagents/[email protected]

4 tools, about 703 tokens to load them all · tool set 4ac0e1022ff3 · checked 2026-10-19 10:20 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 97 / 100

provenance90
liveness100
freshness100
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% +updated-12d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@apitoagents/[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://demo.apitoagents.com/mcp streamable-httpnoneyes100%318 ms2026-07-282026-10-19
packageregistryversionruntimesecrets
@apitoagents/sample-shop-mcpnpm1.0.1npx

Tools (4)

cancel_orderdestructiveCancel 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.
create_orderPlace 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.
get_productread-onlyReturn the full details of one product by its id (for example p-1001). Use search_products first if you only know a name.
search_productsread-onlySearch 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.apitoagents/sample-shop-mcp",
  "title": "Sample Shop MCP server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://demo.apitoagents.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.1",
  "packages": [
    {
      "version": "1.0.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@apitoagents/sample-shop-mcp",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org"
    }
  ],
  "repository": {
    "url": "https://github.com/apitoagents/mcp-examples",
    "source": "github",
    "subfolder": "typescript"
  },
  "websiteUrl": "https://apitoagents.com/docs",
  "description": "Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages."
}