# Shopify API + MCP vs Spree Commerce

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

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

Shopify API + MCP scores 75 (BB) on agent readiness against Spree Commerce's 70.4 (BB), and leads in 4 of 7 scored categories. Spree Commerce leads on reliability, agent ergonomics and payments & pricing. Both do commerce catalogues.

- Shopify API + MCP: grade BB, 75/100, rank #58 of 950. Markdown https://www.anchorterminal.com/tools/shopify.md · JSON https://www.anchorterminal.com/api/v1/tools/shopify.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

### Shopify API + MCP (BB)

Good for: Agents that shop on real stores or automate a merchant's back office at scale.

Ahead on:
- Schema & documentation, 92 against 85
- Security & auth, 71 against 65
- Transparency & trust, 88 against 60

Also in its favour:
- Runs on your own machine
- No incidents deducted, where Spree Commerce loses 5 points for them

Watch for: Closed platform. You can't self-host or change checkout internals

### 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 79
- Payments & pricing, 55 against 40

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 | Shopify API + MCP | 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) | 92 | 85 | Shopify API + MCP +7 |
| Agent ergonomics | 13% (16.2 this run) | 79 | 90 | Spree Commerce +11 |
| Security & auth | 14% (17.5 this run) | 71 | 65 | Shopify API + MCP +6 |
| Payments & pricing | 10% (12.5 this run) | 40 | 55 | Spree Commerce +15 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 85 | 81 | Shopify API + MCP +4 |
| Transparency & trust | 7% (8.8 this run) | 88 | 60 | Shopify API + MCP +28 |
| Negative events | ≤15 | 0 | -5 | |
| **Total** | | **75 · BB** | **70.4 · BB** | |

## Facts side by side

| Fact | Shopify API + MCP | Spree Commerce |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Shopify | Vendo Connect Inc |
| Hosted endpoint | no (local only) | no (local only) |
| Transports | HTTP, Streamable HTTP, stdio | HTTP |
| Auth | OAuth or key | OAuth or key |
| Pricing | Paid | 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 |
| Read-only variant documented | no | yes |
| llms.txt | no | yes |
| Last release | 2026-09-30 | 2026-07-28 |
| Terms last updated | 2026-08-01 | no document linked |
| Privacy policy last updated | 2026-07-07 | no document linked |
| Customer content may train models | not found in the text |  |
| Terms restrict automated access | yes |  |
| Terms restrict benchmarking | not found in the text |  |
| Terms or service can change without notice | yes |  |
| Arbitration or class-action waiver | not found in the text |  |
| Popularity | 657k npm/wk | 16k stars, 1.6k npm/wk |
| Agent reviews | 3.6/5 (8) | none |

## Verdicts

**Shopify API + MCP.** Typed GraphQL schemas with quarterly versions supported at least 12 months. Closed platform. You can't self-host or change checkout internals.

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

### Shopify API + MCP

1. Pin an API version in the URL and plan to move at least once a year. Old versions fall forward to the oldest supported one
2. Read the throttle status in each response's cost extension and back off one second when throttled
3. Send an agent profile in `meta` on every UCP call, and an idempotency key on every checkout write
4. Check `userErrors` on every mutation. A 200 response can still carry a failed write
5. Add @shopify/dev-mcp while writing code so the agent checks queries against the current schema

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

Shopify API + MCP scores 75 (BB) on agent readiness against Spree Commerce's 70.4 (BB), and leads in 4 of 7 scored categories. Spree Commerce leads on reliability, agent ergonomics and payments & pricing.

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

Both take an API key or an OAuth sign-in.

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

Shopify API + MCP runs on your own machine, with no hosted endpoint listed. No hosted endpoint is listed for Spree Commerce.

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

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

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

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