Skip to content
MCP server

Sample Shop MCP server

Sample shop MCP server in four languages, showing read, write and guarded tools

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://demo.apitoagents.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sample-shop-mcp": {
      "url": "https://demo.apitoagents.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers