
Spree Commerce: open-source B2B and marketplace ecommerce
Admin-side MCP endpoint for managing a Spree store's catalog, reports and setup
- Pricing
- Open source
- Platforms
- API, self-hosted
- Runs
- Remotely
- Version
- 6.0.1
- Listing updated
- 3 days ago
About Spree Commerce: open-source B2B and marketplace ecommerce
Spree Commerce: open-source B2B and marketplace ecommerce is an open-source MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.
The Spree MCP server is a protocol adapter for the store back office. Once a Spree 6 store has it installed (spree add mcp, or the spree_mcp gem), an agent can merchandise the catalogue, answer reporting questions and manage store setup in plain language, under the same tenancy and permission rules as the Admin API.
The endpoint is POST /api/v3/admin/mcp on the store's own domain. Authentication is an OAuth token issued to a person, who signs in at the store and approves what the client may do. The token carries that admin's permissions, narrowed to the approval, and those permissions decide which tools the model is offered. A Spree secret API key is deliberately refused, so unattended jobs use the Admin API or the spree api CLI instead.
Tools and their schemas live in spree_core as Spree.admin_agent_tools, so an extension can register a tool without depending on this gem.
What it does
- Per-store endpoint
- Served from your own store domain at /api/v3/admin/mcp.
- Person-bound OAuth
- Tokens belong to an admin who approves what the client may do.
- Permission-filtered tools
- The model only sees tools its credential is allowed to use.
- Secret keys refused
- sk_ API keys are rejected because there is no person behind them.
- Extensible tool registry
- Extensions register tools in spree_core without depending on this gem.
- Same tools as the dashboard
- The dashboard assistant offers the same tools over another transport.
Good for
- Update product listings and merchandising by chat
- Ask reporting questions about store activity
- Adjust store setup under an admin's own permissions
- Add a custom agent tool from a Spree extension
Pricing
Open source
Open-source Spree; self-hosted with no platform fees
Prices change. Check spreecommerce.org before you buy.
Spree Commerce: open-source B2B and marketplace ecommerce FAQ
How do I add it to a store?
Run spree add mcp or add gem 'spree_mcp' to the Gemfile.
How does authentication work?
The client sends an admin to the store to sign in and approve access; the resulting OAuth token carries their permissions.
Can a nightly job use it with an API key?
No. Secret API keys are refused; such jobs should call the Admin API or use the spree api CLI.
What is Spree?
An open-source headless ecommerce platform for B2B, marketplace and multi-store setups, with no platform fees.
Is Spree Commerce: open-source B2B and marketplace ecommerce free?
Yes. Spree Commerce: open-source B2B and marketplace ecommerce is open source, so you can use and self-host it for free.
What are the best alternatives to Spree Commerce: open-source B2B and marketplace ecommerce?
The closest alternatives to Spree Commerce: open-source B2B and marketplace ecommerce are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).
Alternatives to Spree Commerce: open-source B2B and marketplace ecommerce
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce

repairinfo
MCP serverRepairability scores and spare-parts years for EU appliances and electronics
- 4 tools
- Remote
- Freemium
- Analytics and data