For developers and AI agents

Coin Storage MCP server

We publish a Model Context Protocol (MCP) server so AI assistants can query our coin capsule and storage tube catalogue directly, with live prices, dimensions and coin-fit data. It is read-only and free to use. Ask an assistant “which Air-Tite capsule fits a gold sovereign and what does it cost?” and, once connected, it can answer from our real catalogue rather than guessing.

Endpoint

The server speaks JSON-RPC 2.0 over HTTP POST at:

https://coinstorage.co.uk/api/mcp

A plain GET request to the same URL returns the tool manifest, handy for a quick look or to confirm it is reachable.

Tools

The server exposes three tools:

• search_products — search the catalogue by coin name, model code, diameter or type. Optional filter for capsule or tube.
• get_product — full details for one product by SKU or slug: dimensions, price tiers, the coins it fits, and its page link.
• find_capsule_for_coin — the capsule that fits a given coin, by coin name or by diameter in millimetres. Returns the recommended direct fit and black ring options.
• create_checkout_link — create a secure Stripe Checkout link for a basket. The shopper opens the link to enter payment and delivery details and complete the purchase on the site; prices, discounts and the flat £3.99 postage are applied automatically.

Connect from Claude Desktop

Our server is remote (HTTP), so it connects through the mcp-remote bridge. Add this to your Claude Desktop configuration file, then restart the app:

{
  "mcpServers": {
    "coinstorage": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://coinstorage.co.uk/api/mcp"]
    }
  }
}

Many MCP-capable clients can connect to a remote HTTP server in a similar way. Check your client’s documentation for how it adds a remote MCP server, and point it at the endpoint above.

Try it directly

List the available tools:

curl -X POST https://coinstorage.co.uk/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Find the capsule for a gold sovereign:

curl -X POST https://coinstorage.co.uk/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"find_capsule_for_coin",
                 "arguments":{"coin":"Gold Sovereign"}}}'

Notes

The query tools return public catalogue data only. The create_checkout_link tool returns a secure link; payment and delivery details are entered by the shopper on the website, and the agent never handles card details. If you build something with it or hit a problem, we would love to hear from you at sales@coinstorage.co.uk.