# Spree Commerce developer docs for AI agents

> Spree Commerce developer docs for AI agents is an open-source MCP server for e-commerce. Documentation endpoint that lets coding agents look up Spree Commerce APIs. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Aimed at developers building on Spree, this remote server serves the Spree documentation to AI coding agents so they can look up how to build headless B2B and marketplace stores on its APIs instead of guessing. It is hosted at spreecommerce.org/docs/mcp over Streamable HTTP.

The docs live in the main Spree repository and are built with Mintlify; the documentation text is licensed CC BY 4.0. Spree itself provides a REST API, a TypeScript SDK and a Next.js storefront, covering B2B price lists and buyer organisations, multi-vendor marketplaces, multi-store, multi-region and subscription setups. A new project starts with npx create-spree-app@latest.

Unlike Spree's admin MCP server, this one carries documentation rather than store data, so no store login is involved.

## Features

- **Hosted docs lookup:** Remote endpoint at spreecommerce.org/docs/mcp over Streamable HTTP.
- **Headless commerce coverage:** Docs for the REST API, TypeScript SDK and Next.js storefront.
- **B2B and marketplace guidance:** Covers price lists, buyer organisations and multi-vendor setups.
- **Open documentation:** The docs are CC BY 4.0 and open to contributions on GitHub.

## Good for

- Ask a coding agent how to model B2B price lists in Spree
- Look up Admin or Store API endpoints while building a storefront
- Scaffold a new store with the right commands
- Check multi-region and sales channel settings during development

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ecommerce-docs https://spreecommerce.org/docs/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://spreecommerce.org/docs/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ecommerce-docs": {
      "url": "https://spreecommerce.org/docs/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ecommerce-docs": {
      "type": "http",
      "url": "https://spreecommerce.org/docs/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ecommerce-docs": {
      "serverUrl": "https://spreecommerce.org/docs/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ecommerce-docs": {
      "type": "http",
      "url": "https://spreecommerce.org/docs/mcp"
    }
  }
}
```

## FAQ

### Does it touch my store data?

No. It serves documentation, not store data; the separate Spree MCP server handles admin tasks.

### How do I start a Spree project?

The site suggests npx create-spree-app@latest my-store.

### What licence are the docs under?

CC BY 4.0.

### Is there a free way to try Spree?

The site mentions a free sandbox, and the platform is open source with no platform fees.

### Is Spree Commerce developer docs for AI agents free?

Yes. Spree Commerce developer docs for AI agents is open source, so you can use and self-host it for free.

### How do I add Spree Commerce developer docs for AI agents to Claude Code?

Run this command in your terminal: claude mcp add --transport http ecommerce-docs https://spreecommerce.org/docs/mcp

### What are the best alternatives to Spree Commerce developer docs for AI agents?

The closest alternatives to Spree Commerce developer docs for AI agents are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/spree-commerce-developer-docs-for-ai-agents
