Skip to main content
MCP server CX Codex

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 GitHub

What 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/mcp

Step 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.

Similar MCP servers

All MCP servers for Backend and APIs →

From the same set2

Project sponsors

Companies that keep this analytics open