commerce-mcp-sandbox
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@commerce-mcp-sandbox search products for 'umbrella' and place an order for the cheapest one"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
commerce-mcp-sandbox
A zero-dependency mock commerce MCP server for building and testing shopping agents.
给购物类 AI agent 用的模拟商城后端:搜索、下单、模拟支付、物流自动推进、退款——全部内存模拟,没有任何真实商品与真实资金。让你在写购物 agent 时不用等真实电商接口,先把 agent 逻辑跑通。
English below | 中文说明见下半部分
Why
Every developer building a shopping agent hits the same wall: "I need a commerce backend to test against." Real APIs need credentials, contracts, and money. This sandbox gives you the full shopping lifecycle — search → order → pay → ship → deliver → refund — as an MCP server your agent can talk to, with deterministic in-memory state.
Related MCP server: Project Tango
Install & Run
Zero dependencies. Node ≥ 18.
npx commerce-mcp-sandbox # stdio mode (for MCP hosts)
npx commerce-mcp-sandbox --http # not supported yet; use node src/http.js 3300
# or clone & run:
node src/index.js # stdio
node src/http.js 3300 # HTTP mode: POST http://localhost:3300/mcpMCP host configuration
{
"mcpServers": {
"commerce-sandbox": {
"command": "npx",
"args": ["commerce-mcp-sandbox"]
}
}
}Streamable-HTTP hosts (Dify / Coze / web agents):
url: http://localhost:3300/mcpTools (7)
tool | 说明 |
| Search mock catalog (query/category/page). Prices in CNY cents. |
| Product detail with specs. |
| Create order. Requires |
| Simulate payment. Shipping auto-advances in ~5s, delivery in ~15s — so agents can exercise the full lifecycle in seconds. |
| Status + event timeline ( |
| List orders, filter by |
| Simulate refund (no real money). |
Example flow
agent: search_products {query: "umbrella"} → 1 item, ¥39.00
agent: create_order {items:[{sku:"UMB-001",qty:1}], receiver:{...}}
user: pay_order {order_no:"MOCK100001"} → paid
(wait ~5s) get_order → shipped (waybill SF...)
(wait ~15s) get_order → completed
agent: request_refund {order_no:"MOCK100001"} → refunded (simulated)Honest limits
In-memory only — restart wipes state. This is a test double, not a store.
No real payments —
pay_orderflips state; nothing is charged.Single-instance — no persistence layer by design.
Building a real shopping agent?
This sandbox is built by 源头淘 (Yuantoutao) — an open product shelf + fulfillment network for AI agents in China (MCP + REST, WeChat Pay checkout, merchant drop-shipping via ERP, automated aftersales). When your agent is ready for real goods: same tool surface, swap the endpoint, done.
Docs: https://mcp.yuantoutao.com/docs/ · llms.txt: https://mcp.yuantoutao.com/llms.txt
License
MIT
Available Tools
7 toolscreate_orderB
Create an order. Requires receiver {name, phone, address}. Idempotency is the caller's job in this sandbox (orders are in-memory).
Inputs: items (required), receiver (required), user_ref.
get_orderC
Order status + event timeline (created/paid/shipped/delivered/refunded).
Inputs: order_no (required).
get_productB
Product detail by sku, incl. specs. Read-only.
Inputs: sku (required).
list_ordersC
List orders, optionally filtered by user_ref.
Inputs: user_ref.
pay_orderA
Simulate a successful payment for an order. Shipping auto-advances (~5s) and delivery (~15s) so agents can exercise full flows.
Inputs: order_no (required).
request_refundB
Simulate a refund for a paid/shipped/completed order (no real money).
Inputs: order_no (required), reason.
search_productsC
Search the mock catalog. Prices in CNY cents (int). Read-only.
Inputs: page, query, category, page_size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a distinct resource-action pair: product search/detail, order create/pay/get/list, and refund. No overlaps or ambiguous boundaries; an agent can easily select the right tool.
All tools follow a consistent snake_case verb_noun pattern (search_products, get_product, create_order, pay_order, get_order, list_orders, request_refund). The convention is uniform and readable.
Seven tools is well-scoped for a commerce sandbox, covering the essential product and order operations without excess. Each tool earns its place.
The surface covers the core commerce lifecycle: product search/detail, order creation, payment, status, listing, and refund. Minor gaps exist (e.g., no order cancellation or update), but agents can work around these for typical sandbox flows.
Related MCP Connectors
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Live product search for AI agents across Shopify merchants and major retailers.
The E-commerce Marketplace For Every AI Agent. A Governed Catalog Of 600M+ US Products, Plus Four Agent Ready Capabilities Search, Price Comparison, Product-Vs-Product, And Detailed Q&A.
Launch and manage online stores with AI agents: products, inventory, pricing, orders and promotions.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform e-commerce operations including product search, budget-constrained shopping recommendations, and sustainability analysis. Includes a secure HTTP bridge with OAuth integration and observability features for production deployment.-
- AlicenseAqualityBmaintenanceA local-first Model Context Protocol server that provides LLM agents with structured access to e-commerce data (products, inventory, orders, sales analytics) using a realistic mock dataset, zero configuration, and a swappable DataProvider interface for live APIs.8MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to browse product catalogs, search products with filters, and initiate checkouts, generating order summaries and checkout URLs.-
- AlicenseAqualityCmaintenanceEnables building and evaluating shopping/support agents against a deterministic synthetic retail store with in-memory fixtures. Provides tools, resources, and prompts for product search, cart and order flows, inventory, and policy retrieval over stdio or Streamable HTTP.639 PyPIMIT