# commercetools vs Spree Commerce

> commercetools and Spree Commerce score within a point of each other for commerce catalogues, 71.3 and 70.4 out of 100. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/commercetools-vs-spree-commerce
- Markdown: https://www.anchorterminal.com/compare/commercetools-vs-spree-commerce.md (~2,950 tokens)
- Slim: https://www.anchorterminal.com/compare/commercetools-vs-spree-commerce.min.md (~780 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/commercetools-vs-spree-commerce.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- Updated: 2026-10-09

commercetools and Spree Commerce score within a point of each other on agent readiness, 71.3 (BB) and 70.4 (BB). Spree Commerce leads on reliability, agent ergonomics and payments & pricing. Both do commerce catalogues.

- commercetools: grade BB, 71.3/100, rank #133 of 950. Markdown https://www.anchorterminal.com/tools/commercetools.md · JSON https://www.anchorterminal.com/api/v1/tools/commercetools.json
- Spree Commerce: grade BB, 70.4/100, rank #155 of 950. Markdown https://www.anchorterminal.com/tools/spree-commerce.md · JSON https://www.anchorterminal.com/api/v1/tools/spree-commerce.json
- Best commerce platforms and checkout APIs for AI agents: https://www.anchorterminal.com/best/commerce/index.md
- All 136 commerce comparisons: https://www.anchorterminal.com/compare/commerce/index.md

## Which one, for what

### commercetools (BB)

Good for: Enterprises that already run or plan a composable commerce stack and want agents working across catalogue, pricing, carts and orders under scoped credentials.

Ahead on:
- Security & auth, 70 against 65
- Transparency & trust, 81 against 60

Also in its favour:
- A hosted endpoint, with nothing to install
- Runs on your own machine
- No incidents deducted, where Spree Commerce loses 5 points for them

Watch for: No public price. The pricing page describes order-based pricing and sends buyers to sales

### Spree Commerce (BB)

Good for: Teams that want to own a Rails commerce backend with marketplace, B2B and multi-region functions and drive it through REST.

Ahead on:
- Reliability, 82 against 73
- Agent ergonomics, 90 against 83
- Payments & pricing, 55 against 20

Also in its favour:
- Open source

Watch for: Six GitHub security advisories between 8 January and 20 July 2026, four rated High, most of them access-control flaws on guest carts, orders and addresses


## Score by category

| Category | Weight | commercetools | Spree Commerce | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 73 | 82 | Spree Commerce +9 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 86 | 85 | commercetools +1 |
| Agent ergonomics | 13% (16.2 this run) | 83 | 90 | Spree Commerce +7 |
| Security & auth | 14% (17.5 this run) | 70 | 65 | commercetools +5 |
| Payments & pricing | 10% (12.5 this run) | 20 | 55 | Spree Commerce +35 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 85 | 81 | commercetools +4 |
| Transparency & trust | 7% (8.8 this run) | 81 | 60 | commercetools +21 |
| Negative events | ≤15 | 0 | -5 | |
| **Total** | | **71.3 · BB** | **70.4 · BB** | |

## Facts side by side

| Fact | commercetools | Spree Commerce |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | commercetools GmbH | Vendo Connect Inc |
| Hosted endpoint | `https://api.{region}.commercetools.com/{projectKey}` | no (local only) |
| Transports | HTTP, Streamable HTTP, stdio | HTTP |
| Auth | OAuth | OAuth or key |
| Pricing | Paid | Freemium |
| x402 | no | no |
| Licence | Proprietary service under the commercetools Master Service Agreement. The API specifications are public, the SDKs are MIT (TypeScript, PHP) or Apache 2.0 (Java, .NET) and Commerce MCP is MIT | BSD-3-Clause for the backend, MIT for the npm packages. Enterprise Edition code is under a separate commercial licence |
| Read-only variant documented | no | yes |
| llms.txt | yes | yes |
| Last release | 2026-10-07 | 2026-07-28 |
| Terms last updated | no date given | no document linked |
| Privacy policy last updated | no date given | no document linked |
| Customer content may train models | not found in the text |  |
| Terms restrict automated access | not found in the text |  |
| Terms restrict benchmarking | yes |  |
| Terms or service can change without notice | not found in the text |  |
| Arbitration or class-action waiver | not found in the text |  |
| Popularity | 221k npm/wk | 16k stars, 1.6k npm/wk |

## Verdicts

**commercetools.** A public OpenAPI file with 822 operations, per-resource OAuth scopes and a managed MCP server whose tools an administrator selects per agent. Prices are quoted by sales only, and the HTTP API publishes no platform-wide rate limit. A 60-day trial needs no card.

**Spree Commerce.** A self-hosted BSD 3-Clause platform with public OpenAPI files for the Store and Admin APIs, scoped secret keys, documented rate limits and idempotency keys on cart and checkout calls. GitHub lists six security advisories between January and July 2026, four rated High, and the default docs describe the 6.0 release candidate while 5.6.1 is the stable release.

## Before you call either

### commercetools

1. Use the auth and API hosts for the project's region, such as auth.europe-west1.gcp.commercetools.com and api.europe-west1.gcp.commercetools.com. There are five regions
2. Send the resource's current `version` with every update or delete. On 409 ConcurrentModification, re-read the resource and retry only if the change is still needed
3. Retry 502 and 503 with exponential backoff from 200 ms, honour Retry-After, and check Content-Type before parsing an error body
4. For MCP, ask for an API Client scoped to `mcp:{projectKey}:{mcpServerKey}` and a server limited to the tools the task needs, not `all`
5. Keep page size at or under 500 and offset at or under 10,000. Product Search returns at most 100 per request

### Spree Commerce

1. Send a publishable key in `X-Spree-Api-Key` on every Store API call. Add `X-Spree-Token` with the cart token for guest carts, or a customer JWT as a Bearer token
2. Send `Idempotency-Key` with the cart token or a customer JWT on cart, payment and completion calls. A request carrying only the publishable key is never cached
3. Ask for `fields` and `expand` explicitly. Relations are left out by default and `limit` stops at 100
4. Use a secret key with the narrowest scopes for the Admin API. `read_all` gives a read-only key, and the CLI's auto-minted local key is read-only
5. Read the docs under `/docs/v5` for a 5.6 store. The default docs describe 6.0, which renames shipments to fulfilments and splits carts from orders

## Questions

### Which is better for AI agents, commercetools or Spree Commerce?

commercetools and Spree Commerce score within a point of each other on agent readiness, 71.3 (BB) and 70.4 (BB). Spree Commerce leads on reliability, agent ergonomics and payments & pricing.

### Do commercetools and Spree Commerce need an API key?

commercetools uses an OAuth sign-in. Spree Commerce takes an API key or an OAuth sign-in.

### Can an agent call commercetools and Spree Commerce without installing anything?

commercetools has a hosted endpoint at https://api.{region}.commercetools.com/{projectKey}. No hosted endpoint is listed for Spree Commerce.

### Are commercetools and Spree Commerce open source?

No open-source release is listed for commercetools. Spree Commerce is open source (BSD-3-Clause for the backend, MIT for the npm packages. Enterprise Edition code is under a separate commercial licence).


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/commercetools-vs-spree-commerce.json, and with the fewest tokens: https://www.anchorterminal.com/compare/commercetools-vs-spree-commerce.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "commercetools", "b": "spree-commerce"}`. From a terminal: `anchor compare commercetools spree-commerce`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/commercetools.json and https://www.anchorterminal.com/api/v1/tools/spree-commerce.json

## Other comparisons with commercetools or Spree Commerce

- [Adobe Commerce (Magento) vs commercetools](https://www.anchorterminal.com/compare/adobe-commerce-vs-commercetools.md)
- [Adobe Commerce (Magento) vs Spree Commerce](https://www.anchorterminal.com/compare/adobe-commerce-vs-spree-commerce.md)
- [BigCommerce API + MCP vs commercetools](https://www.anchorterminal.com/compare/bigcommerce-vs-commercetools.md)
- [BigCommerce API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/bigcommerce-vs-spree-commerce.md)
- [Commerce Layer API + MCP vs commercetools](https://www.anchorterminal.com/compare/commerce-layer-vs-commercetools.md)
- [Commerce Layer API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/commerce-layer-vs-spree-commerce.md)
- [commercetools vs Ecwid by Lightspeed](https://www.anchorterminal.com/compare/commercetools-vs-ecwid.md)
- [commercetools vs Elastic Path API + MCP](https://www.anchorterminal.com/compare/commercetools-vs-elastic-path.md)
- [commercetools vs Medusa API + MCP](https://www.anchorterminal.com/compare/commercetools-vs-medusa.md)
- [commercetools vs Saleor API + MCP](https://www.anchorterminal.com/compare/commercetools-vs-saleor.md)
- [commercetools vs Shopify API + MCP](https://www.anchorterminal.com/compare/commercetools-vs-shopify.md)
- [commercetools vs Shopware](https://www.anchorterminal.com/compare/commercetools-vs-shopware.md)
- [commercetools vs Snipcart API + MCP](https://www.anchorterminal.com/compare/commercetools-vs-snipcart.md)
- [commercetools vs Square](https://www.anchorterminal.com/compare/commercetools-vs-square.md)
- [commercetools vs Swell](https://www.anchorterminal.com/compare/commercetools-vs-swell.md)
- [commercetools vs Vendure](https://www.anchorterminal.com/compare/commercetools-vs-vendure.md)
- [commercetools vs Wix Stores and eCommerce API](https://www.anchorterminal.com/compare/commercetools-vs-wix.md)
- [commercetools vs WooCommerce API + MCP](https://www.anchorterminal.com/compare/commercetools-vs-woocommerce.md)
- [Ecwid by Lightspeed vs Spree Commerce](https://www.anchorterminal.com/compare/ecwid-vs-spree-commerce.md)
- [Elastic Path API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/elastic-path-vs-spree-commerce.md)
- [Medusa API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/medusa-vs-spree-commerce.md)
- [Saleor API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/saleor-vs-spree-commerce.md)
- [Shopify API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/shopify-vs-spree-commerce.md)
- [Shopware vs Spree Commerce](https://www.anchorterminal.com/compare/shopware-vs-spree-commerce.md)
- [Snipcart API + MCP vs Spree Commerce](https://www.anchorterminal.com/compare/snipcart-vs-spree-commerce.md)
- [Spree Commerce vs Square](https://www.anchorterminal.com/compare/spree-commerce-vs-square.md)
- [Spree Commerce vs Swell](https://www.anchorterminal.com/compare/spree-commerce-vs-swell.md)
- [Spree Commerce vs Vendure](https://www.anchorterminal.com/compare/spree-commerce-vs-vendure.md)
- [Spree Commerce vs Wix Stores and eCommerce API](https://www.anchorterminal.com/compare/spree-commerce-vs-wix.md)
- [Spree Commerce vs WooCommerce API + MCP](https://www.anchorterminal.com/compare/spree-commerce-vs-woocommerce.md)