# Spree Commerce: open-source B2B and marketplace ecommerce

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15848 repo stars
- Author: spree
- License: BSD-3-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/spree/spree/tree/HEAD/spree/mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/spree-commerce-open-source-b2b-and-marketplace-ecommerce

## What it 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.

## Requirements
- Remote server: `https://{store_domain}/api/v3/admin/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http ecommerce-b2b-marketplace https://{store_domain}/api/v3/admin/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://{store_domain}/api/v3/admin/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://{store_domain}/api/v3/admin/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://{store_domain}/api/v3/admin/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://{store_domain}/api/v3/admin/mcp
```

## When to use it
- 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
- Show products in the catalog and recent orders
- Run a sales report for the last month
- Update store settings using the assistant

## Similar
- [commerce-b2b-open-code-components-integrate](https://affpapa.org/en/nevibecode/skills/commerce-b2b-open-code-components-integrate.md) — skill · 4700 installs
- [commerce-b2b-open-code-components-replace](https://affpapa.org/en/nevibecode/skills/commerce-b2b-open-code-components-replace.md) — skill · 4600 installs
- [Tidewave Rails](https://affpapa.org/en/nevibecode/mcp/tidewave-rails.md) — MCP server · ★ 476 repo stars
- [architecture-well-architected-commerce](https://affpapa.org/en/nevibecode/skills/architecture-well-architected-commerce.md) — skill · 1300 installs
- [marketplace-catalog-sync](https://affpapa.org/en/nevibecode/skills/marketplace-catalog-sync.md) — skill · 1100 installs
- [rails-cursorrules-prompt-file](https://affpapa.org/en/nevibecode/rules/rails-cursorrules-prompt-file.md) — rule · ★ 41178 repo stars

From the same set: [spree/spree](https://affpapa.org/en/nevibecode/by/spree/spree.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
