Mock Ecommerce MCP Server

• Community server maintained by arpanm, MIT licensed, written in Java
• Read and write tools: addToCart, checkout, initiatePayment, cancelOrder, returnOrderItem
• Runs locally via mvn clean package and spring-boot:run
• SSE transport at http://localhost:8080/sse, no client credential required
• Setup documented for Claude Desktop, Claude Code and VS Code
• H2 in-memory database for dev, PostgreSQL via Docker Compose
• Bundled React data explorer browses generated products and restaurant data
• ANTHROPIC_API_KEY environment variable enables LLM product data generation

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

1. Developers building an LLM shopping assistant

   Exercising a search, cart, checkout, payment and order tracking sequence during development

   Intended outcomeThe server generates mock products on demand and returns structured JSON for each tool call, with no live store involved.

2. A team testing post-purchase agent behaviour

   Checking how an agent handles cancellations, returns, support tickets and reviews

   Intended outcomeTools such as cancelOrder, returnOrderItem, createTicket and submitProductReview move mock orders through their documented status values.

3. An engineer comparing MCP client setups

   Connecting the same server to Claude Desktop, Claude Code and VS Code

   Intended outcomeEach client points at the local SSE endpoint on port 8080 using the documented configuration, with no credential to provision.

Business size

Any stageA free MIT-licensed self-hosted server with mock data, so fit depends on running the build rather than store size.

From the server's repository, documentation and MCP directory listings.

What an agent can do

Manage products, Orders, Payments, Shipping and fulfilment, Customers, Customer service, Agentic shopping, Product content

Transport

SSE (deprecated)

Authentication

No credentialsMCP client config uses local http://localhost:8080/sse with no credential; tool-level login uses a mock platform secret 'mock-platform-secret-key'.

Package

None published; build from source

Language

Java

Licence

MIT

Repository

github.com/arpanm/MockEcomMCPServer (opens in a new tab)

Repository last updated

5 Apr 2026

mvn clean package -DskipTests && mvn spring-boot:run

Command as listed on the repository README, not tested by ecommerceguide. Check the repository README (opens in a new tab) for configuration and credentials before running it.

• Agentic commerceUse case→