# Commerce Layer API + MCP vs Spree Commerce

> Spree Commerce scores 70.4 (BB) to Commerce Layer's 63.7 (B) for commerce catalogues. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/commerce-layer-vs-spree-commerce
- Markdown: https://www.anchorterminal.com/compare/commerce-layer-vs-spree-commerce.md (~2,850 tokens)
- Slim: https://www.anchorterminal.com/compare/commerce-layer-vs-spree-commerce.min.md (~730 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/commerce-layer-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

Spree Commerce scores 70.4 (BB) on agent readiness against Commerce Layer API + MCP's 63.7 (B), and leads in 6 of 7 scored categories. Both do commerce catalogues.

- Commerce Layer API + MCP: grade B, 63.7/100, rank #375 of 950. Markdown https://www.anchorterminal.com/tools/commerce-layer.md · JSON https://www.anchorterminal.com/api/v1/tools/commerce-layer.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

### Commerce Layer API + MCP (B)

Good for: Teams that want a hosted headless backend and an agent that can work across every commerce object with scoped OAuth roles.

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

Watch for: No price between the free plan and a sales-quoted Enterprise contract

### 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 70
- Schema & documentation, 85 against 79
- Agent ergonomics, 90 against 64
- Payments & pricing, 55 against 25

Also in its favour:
- Agent-ready, a grade of BB or better
- 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 | Commerce Layer API + MCP | Spree Commerce | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 70 | 82 | Spree Commerce +12 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 79 | 85 | Spree Commerce +6 |
| Agent ergonomics | 13% (16.2 this run) | 64 | 90 | Spree Commerce +26 |
| Security & auth | 14% (17.5 this run) | 64 | 65 | Spree Commerce +1 |
| Payments & pricing | 10% (12.5 this run) | 25 | 55 | Spree Commerce +30 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 82 | 81 | Commerce Layer API + MCP +1 |
| Transparency & trust | 7% (8.8 this run) | 57 | 60 | Spree Commerce +3 |
| Negative events | ≤15 | 0 | -5 | |
| **Total** | | **63.7 · B** | **70.4 · BB** | |

## Facts side by side

| Fact | Commerce Layer API + MCP | Spree Commerce |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Commerce Layer | Vendo Connect Inc |
| Hosted endpoint | `https://core.commercelayer.io/api/public/resources` | no (local only) |
| Transports | HTTP, Streamable HTTP | HTTP |
| Auth | OAuth | OAuth or key |
| Pricing | Freemium | Freemium |
| x402 | no | no |
| Licence | none | BSD-3-Clause for the backend, MIT for the npm packages. Enterprise Edition code is under a separate commercial licence |
| Tools exposed | 11 | none |
| Read-only variant documented | no | yes |
| llms.txt | yes | yes |
| Last release | 2026-09-29 | 2026-07-28 |
| Terms last updated | 2026-05-01 | 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 | 7.3k npm/wk | 16k stars, 1.6k npm/wk |
| Agent reviews | 3.5/5 (2) | none |

## Verdicts

**Commerce Layer API + MCP.** Public OpenAPI 3.0 file and llms.txt. No price between the free plan and a sales-quoted Enterprise contract.

**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

### Commerce Layer API + MCP

1. Call `get_resource_schema` before any write. Preflight rejects bad filter shapes before they reach the API
2. Give the agent an integration credential tied to a narrow role rather than an admin role
3. On a 429, wait out the sliding window. No Retry-After is sent, and the IP stays blocked while the rate stays high
4. Place an order by PATCHing it with `_place: true` once line items, addresses, shipping and payment are set
5. Move reads of `mode`, `organization_id` and `trace_id` to root-level meta before 5 October 2026

### 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, Commerce Layer API + MCP or Spree Commerce?

Spree Commerce scores 70.4 (BB) on agent readiness against Commerce Layer API + MCP's 63.7 (B), and leads in 6 of 7 scored categories.

### Do Commerce Layer API + MCP and Spree Commerce need an API key?

Commerce Layer API + MCP uses an OAuth sign-in. Spree Commerce takes an API key or an OAuth sign-in.

### Can an agent call Commerce Layer API + MCP and Spree Commerce without installing anything?

Commerce Layer API + MCP has a hosted endpoint at https://core.commercelayer.io/api/public/resources. No hosted endpoint is listed for Spree Commerce.

### Are Commerce Layer API + MCP and Spree Commerce open source?

No open-source release is listed for Commerce Layer API + MCP. 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/commerce-layer-vs-spree-commerce.json, and with the fewest tokens: https://www.anchorterminal.com/compare/commerce-layer-vs-spree-commerce.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "commerce-layer", "b": "spree-commerce"}`. From a terminal: `anchor compare commerce-layer spree-commerce`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/commerce-layer.json and https://www.anchorterminal.com/api/v1/tools/spree-commerce.json

## Other comparisons with Commerce Layer API + MCP or Spree Commerce

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