mcp-commerce-server
Connects the commerce MCP server to a Shopify store via the Shopify Admin API, enabling catalog/product search, order lookup, low-stock inventory review, inventory adjustments, and discount creation with scoped access and preview-confirm safeguards.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-commerce-server
A Model Context Protocol server that lets AI assistants (Claude, ChatGPT, Cursor, your own agents) work with an online store, without being able to do damage.
MCP makes it easy to hand a model a set of tools. The hard part is deciding what happens when the model is confused, over-eager or being manipulated. This server is built around that question.
Safety model
Control | How |
Least-privilege keys | Each API key maps to a principal with explicit scopes ( |
PII minimisation |
|
Preview-then-confirm writes |
|
Business limits in code | Max stock change per call, max discount %, max validity. Bigger changes go to a human in the back office. |
Tool annotations |
|
Rate limits | Per principal. |
Audit log | Every call: principal, tool, outcome (ok / preview / denied / error) and a hash of the arguments, so the audit trail doesn't become a second copy of customer data. |
A confused or prompt-injected model therefore can't:
skip the human (no token without a preview),
show the user one change and execute another (the token is bound to the exact arguments),
replay an old approval (tokens are single-use and expire after 5 minutes), or
reach data its key isn't scoped for.
Related MCP server: mcp-ecom-agent-layer
Tools, resources, prompts
Name | Kind | Scope |
| tool · read-only |
|
| tool · read-only (PII masked by default) |
|
| tool · read-only |
|
| tool · destructive · preview/confirm |
|
| tool · idempotent · preview/confirm |
|
| resource |
|
| resource | — |
| prompt | — |
Read tools return both human-readable text and structuredContent for programmatic clients.
Run it
Locally with Claude Desktop (stdio):
npm ci && npm run build
node -e "console.log(require('crypto').createHash('sha256').update('sk_local_demo').digest('hex'))"{
"mcpServers": {
"commerce": {
"command": "node",
"args": ["/path/to/mcp-commerce-server/dist/stdio.js"],
"env": {
"MCP_KEYS": "desktop:<sha256-from-above>:catalog:read,orders:read,inventory:read,inventory:write",
"MCP_API_KEY": "sk_local_demo"
}
}
}
}Remotely (Streamable HTTP, stateless): MCP_KEYS=... npm run http. Clients send Authorization: Bearer <key> to POST /mcp. Each request authenticates independently; the store, confirmation service and audit log are shared.
Audit records go to stderr in stdio mode, because stdout is the protocol channel.
Tests
The tests connect a real MCP Client to the server over the SDK's in-memory transport, the same protocol path a production client uses. They cover discovery and annotations, structured output, PII masking per scope, scope denials (audited without raw arguments), schema rejection, rate limiting, and the full preview → tamper → confirm → replay cycle. They also caught a real bug: scope names contain :, which the key parser originally split on.
npm ci
npm run ci # typecheck + tests + buildThe store is an in-memory adapter behind a small interface. Point it at Shopify's Admin API (see commerce-ops-agent) or any backend.
Built by Admire T. Ndaneta. MIT licensed.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Connect AI to store orders, products and inventory with scoped access and human approvals.
MCP gateway: one connection for your AI apps, with tool policies, PII redaction and audit logs.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Connect e-commerce and marketing data to AI assistants via MCP.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage products, shopping carts, and orders in an online store through a well-defined MCP API.-
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to search products, manage carts, and cancel orders on the mcp-ecom storefront via HTTP, with server-enforced approval tokens for high-risk actions.-
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to securely call enterprise MCP tools with tenant-scoped RBAC, human approvals, audit logging, and multi-tool workflows across customer, order, document, and ticket data.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage Magento 2 / Adobe Commerce products, stock, orders, and customers through 12 read/write MCP tools with secure, audited access.AGPL 3.0