Skip to content
MCP server

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

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data