home / mcp / shopify agentic mcp gateway
Provides a tri-protocol gateway enabling autonomous AI agents to discover Shopify capabilities, negotiate terms, cart, pay, and track orders via MCP tools.
Configuration
View docs{
"mcpServers": {
"kuro-tomo-shopify-agentic-mcp": {
"command": "node",
"args": [
"/absolute/path/to/shopify-agentic-mcp/dist/index.js"
],
"env": {
"SHOPIFY_API_KEY": "your_api_key",
"SHOPIFY_API_SECRET": "your_api_secret",
"SHOPIFY_ACCESS_TOKEN": "your_access_token",
"SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
"SHOPIFY_STOREFRONT_TOKEN": "your_token"
}
}
}
}You can deploy and run the Shopify Agentic MCP Gateway as a local MCP server that enables autonomous AI agents to discover, negotiate, cart, pay, and track orders against your Shopify store. It provides a five-tool MCP interface, UCP profile discovery, AP2 mandate chaining for secure payments, guardrails, and a configurable checkout workflow that can run locally or in serverless environments.
You will run the MCP server locally and connect your AI agent client to it. Start the server in stdio mode, then configure your MCP client (for example Claude Desktop) to communicate with the local process. The server exposes five MCP tools that your agent can call to search products, manage carts, negotiate terms, execute checkouts, and track orders. It also advertises UCP capabilities for store discovery and participates in the AP2 mandate chain to securely authorize payments.
Follow these concrete steps to install and run the MCP gateway locally.
# Clone the repository
git clone https://github.com/kuro-tomo/shopify-agentic-mcp.git
cd shopify-agentic-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Start the MCP server (stdio mode)
npm startConfigure your client to connect to the local MCP server. The provided example shows how to wire the MCP server into Claude Desktop by pointing to the local dist index. You should adapt paths and environment values to match your actual deployment.
{
"mcpServers": {
"shopify-agentic": {
"command": "node",
"args": ["/absolute/path/to/shopify-agentic-mcp/dist/index.js"],
"env": {
"SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
"SHOPIFY_STOREFRONT_TOKEN": "your_token"
}
}
}
}Security is enforced through the AP2 mandate chain, ensuring that values for Intent, Cart, and Payment are cryptographically signed and verified. Guardrails validate prices, inventory, mandate amounts, and state transitions throughout the checkout flow.
Use the five MCP tools to perform end-to-end autonomous shopping flows: search inventory, create or modify a cart, negotiate terms, execute a checkout with proper mandates, and track orders. The gateway supports a three-state checkout machine and can be deployed in stdio mode for local development or in a serverless environment if you provide an HTTP MCP endpoint.
If you encounter connectivity issues, ensure the MCP server process is running and the client is pointing to the correct command and environment. Verify that required Shopify credentials are provided via environment variables and that the AP2 signing keys are properly configured if you are using mandate signing in your workflow.
Search the Shopify catalog for products using query, category, price range, and limit parameters.
Create, modify, or retrieve a shopping cart with actions like create, add, remove, or get and associated IDs.
Negotiate capabilities, discounts, and shipping terms between the agent and merchant for a given cart.
Complete a purchase by validating and processing mandates through the AP2 chain for the specified checkout.
Retrieve order status and fulfillment tracking information by order ID.