Spree Commerce — Claude Code MCP server: what it does, how to install
The Spree Commerce: open-source B2B and marketplace ecommerce MCP server for Claude Code connects AI agents to the store back office for catalog management and reporting.
BSD-3-Clause ★ 15,848 updated 2026-11-16
Open on GitHubWhat Spree Commerce: open-source B2B and marketplace ecommerce does
The server acts as a protocol adapter for the Spree back office and lets AI agents manage products, answer questions, and configure the store using natural language. Permissions follow the admin OAuth token issued during sign-in, restricting available tools to what the user approves. API secret keys are intentionally rejected for this transport.
Run spree add mcp or add gem 'spree_mcp' to the Gemfile to include the server. The endpoint POST /api/v3/admin/mcp handles incoming client calls, securing every action with delegated user permissions.
What it helps with
- manage store catalog and merchandise products through AI
- query sales reports and analytics using natural language
- configure store settings via MCP tools
- enforce admin permissions on agent actions with OAuth tokens
Example prompts for the agent
- Show products in the catalog and recent orders
- Run a sales report for the last month
- Update store settings using the assistant
How to install Spree Commerce: open-source B2B and marketplace ecommerce
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http ecommerce-b2b-marketplace https://{store_domain}/api/v3/admin/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add mcp --url https://{store_domain}/api/v3/admin/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"mcp": {
"url": "https://{store_domain}/api/v3/admin/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://{store_domain}/api/v3/admin/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http mcp https://{store_domain}/api/v3/admin/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Spree Commerce: open-source B2B and marketplace ecommerce
How to install Spree Commerce in Claude Code?
Run claude mcp add --transport http ecommerce-b2b-marketplace https://{store_domain}/api/v3/admin/mcp in your terminal.
What does Spree Commerce do?
It provides an MCP server for the Spree back office, letting AI agents perform store management and reporting tasks.
What is needed to run Spree Commerce?
You need a running Spree store, the spree_mcp gem installed, and an OAuth token approved by an admin user.