Sample Shop MCP server
Sample shop MCP server in four languages, showing read, write and guarded tools
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally or Remotely
- Version
- 1.0.1
- Listing updated
- today
Similar MCP servers
About Sample Shop MCP server
Sample Shop MCP server is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
The README presents this as a teaching server for a small sample shop, built with the official TypeScript SDK. It exposes paginated product reads (search_products, get_product), an idempotent order creation tool (create_order), and a cancellation tool that refuses to run without explicit confirmation (cancel_order).
It can run locally over stdio with a single npx command, which also starts a bundled Sample Shop API on localhost, or over Streamable HTTP for remote clients. A hosted demo endpoint is available for trying it from Claude or ChatGPT without installing anything. The README says the same server exists in Python, C# and PHP, and that all four pass one shared conformance scenario.
The server is aimed at developers who want a reference for wiring an existing API into MCP clients. The docs of the vendor, API to Agents, cover building, connecting and productionising such servers, and the vendor also offers paid done-for-you setup for companies' own APIs.
Install
Run in a terminal
claude mcp add --transport http sample-shop-mcp https://demo.apitoagents.com/mcpAdd to Settings → Connectors → Add custom connector
https://demo.apitoagents.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"sample-shop-mcp": {
"url": "https://demo.apitoagents.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sample-shop-mcp": {
"type": "http",
"url": "https://demo.apitoagents.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sample-shop-mcp": {
"serverUrl": "https://demo.apitoagents.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sample-shop-mcp": {
"type": "http",
"url": "https://demo.apitoagents.com/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- search_products
- Paginated product search.
- get_product
- Fetch a single product.
- create_order
- Idempotent order creation.
- cancel_order
- Guarded cancellation that requires explicit confirmation.
What it does
- Paginated product reads
- Search and fetch product records through tools that return results in pages.
- Idempotent order creation
- The create_order tool is designed so that repeated calls do not duplicate orders.
- Guarded order cancellation
- The cancel_order tool refuses to run without an explicit confirmation step.
- Stdio and HTTP transports
- Runs over stdio for local clients or Streamable HTTP for remote connections.
- Four-language reference set
- The README says equivalent servers exist in Python, C# and PHP, sharing one conformance test.
Good for
- Learning how to structure read, write and guarded tools in an MCP server
- Testing an MCP client such as Claude Desktop or the MCP Inspector against a working example
- Using the hosted demo endpoint to try an MCP shop assistant without installing anything
- Comparing MCP server implementations across TypeScript, Python, C# and PHP
Pricing
Open source
Free MIT-licensed reference server; the vendor sells paid setup and hosting for companies' own APIs.
Prices change. Check apitoagents.com before you buy.
Sample Shop MCP server FAQ
How do I run it locally?
The README says npx @apitoagents/sample-shop-mcp starts the bundled Sample Shop API on 127.0.0.1:4010 and serves the MCP tools over stdio.
Is there a hosted version to try?
The README says a hosted copy runs at https://demo.apitoagents.com/mcp with in-memory data that resets regularly.
What license is it under?
The README states the package is released under the MIT licence.
Is Sample Shop MCP server free?
Yes. Sample Shop MCP server is open source, so you can use and self-host it for free.
How do I add Sample Shop MCP server to Claude Code?
Run this command in your terminal: claude mcp add --transport http sample-shop-mcp https://demo.apitoagents.com/mcp
What are the best alternatives to Sample Shop MCP server?
The closest alternatives to Sample Shop MCP server are MCP Foundry — Build, Test & Publish MCP Servers, meirinho.com.br, leitura para agentes and Makefile MCP.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.