# 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. Admin-side MCP endpoint for managing a Spree store's catalog, reports and setup. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Website:** https://spreecommerce.org
- **Repository:** https://github.com/spree/spree/tree/HEAD/spree/mcp
- **MCP Registry name:** io.github.spree/ecommerce-b2b-marketplace
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## 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

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/spree-commerce-open-source-b2b-and-marketplace-ecommerce
