Spree Commerce: open-source B2B and marketplace ecommerce
io.github.spree/ecommerce-b2b-marketplace · 15.8k stars · Ruby · BSD-3-Clause
MCP server Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Install
The repo has no one-line install. Follow its README.
Published as
- Remote
https://{store_domain}/api/v3/admin/mcpStreamable HTTP
From the server's entry in the official MCP Registry.
Files
Spree MCP Server
A Model Context Protocol server for the Spree back office. Any MCP client — Claude Code, Cursor, an in-house agent — can merchandise the catalog, answer reporting questions and manage store setup in plain language, under the same tenancy and permission rules as the Admin API.
spree add mcp # or add gem 'spree_mcp' to the Gemfile
The endpoint is POST /api/v3/admin/mcp, authenticated with a Spree secret API
key sent as X-Spree-API-Key: sk_… or Authorization: Bearer sk_…. The key's
scopes decide which tools the model is offered, so an agent is never told about
a capability its credential does not carry.
This gem is a protocol adapter and nothing more. The tools, their schemas and
the permissions gating them live in spree_core as Spree.admin_agent_tools, which
means an extension registers a tool without depending on this gem, and the
dashboard assistant offers the same tools over a different transport.
See the documentation
and docs/plans/6.0-mcp-server.md.
Facts
- Kind
- MCP server
- Repo
- spree/spree
- Group
- Uncategorized
- Stars
- 15.8k
- License
- BSD-3-Clause
- Language
- Ruby
- Last push
- 2026-11-02
- Forks
- 5,319
- MCP Registry
- io.github.spree/ecommerce-b2b-marketplace
- Homepage
- spreecommerce.org
- Topics
- ecommerce, e-commerce, ecommerce-platform, spree-commerce, marketplace, multi-tenant, multi-vendor, multi-vendor-ecommerce, ecommerce-api, ecommerce-framework, open-source, headless, headless-commerce, headless-ecommerce, b2b-commerce