Head to head · Commerce catalogues · October 2026 research run

Ecwid by Lightspeed vs Shopify API + MCP

Shopify API + MCP scores 77.4 (BB) on agent readiness against Ecwid by Lightspeed's 60.2 (C), and leads in every scored category. Both do commerce catalogues.

Best commerce platforms and checkout APIs for AI agents · All 189 commerce comparisons

Which one, for what

Ecwid by Lightspeed C

Best for An agent doing back-office work on an existing Ecwid store, such as catalogue edits, order export and discount coupons.

Also in its favour

  • A hosted endpoint, with nothing to install
  • No incidents deducted, where Shopify API + MCP loses 3 points for them

Watch for

Access tokens never expire and change only when the app is uninstalled and installed again

Shopify API + MCP BB

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

Ahead on

  • Reliability, 78 against 60
  • Schema & documentation, 92 against 66
  • Agent ergonomics, 83 against 66
  • Security & auth, 78 against 61
  • Payments & pricing, 60 against 23
  • Maintenance & community, 85 against 79
  • Transparency & trust, 89 against 72

Also in its favour

  • Agent-ready, a grade of BB or better
  • Runs on your own machine
  • Rated higher by the reviewer agents, 3.6 against 2.3 out of 5

Watch for

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

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Payments & pricing Shopify API + MCP +37

Ecwid by Lightspeed 23

No x402, MPP or L402 (0). Plan prices are public, Starter $5, Venture $35, Business $65 and Unlimited $149 a month, with nothing per call (10). No free plan or trial was found on the pricing page, and the docs say only paid plans reach the API. Developers can email API support for a free upgrade of a test store, which earns part of the line (5). A person signs up in a browser and copies the token from the admin (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 15 is 23.

Shopify API + MCP 60

No x402, MPP or L402. UCP checkout uses the buyer's normal payment methods, and Shop MCP completes purchases with Shop Pay (0). Plan prices are public, re-read on 1 November, Basic $39, Grow $105 and Advanced $399 a month ($29, $79 and $299 billed yearly), Plus from $2,300, and an Agentic plan at $0 a month for selling in AI channels (10). Development stores are free for building and testing, and the 3-day store trial needs no credit card per the pricing page (20). Catalogue, cart and checkout build tools work anonymously at the lowest rate limits with an agent profile in the request, but complete_checkout needs a token, and back-office access needs a person to create an app. Shop MCP (mcp.shop.com) searches without an API key and builds carts without sign-in, but completing a purchase needs the shopper signed in with Shop, so the line stays (10). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 40 is 60.

Schema & documentation Shopify API + MCP +26

Ecwid by Lightspeed 66

OpenAPI 3.0.3 definitions are embedded in the reference for store profile, store logo, orders and order extra fields only, marked version 0.0.1. No complete downloadable spec was found (10). llms.txt, llms-full.txt and a Markdown twin of every page (10). Reference pages state what each call does and which scopes it needs, with little on when not to use one (12). Parameters are typed in tables, and the published OpenAPI fragments carry almost no enums or required markers (9). Request and response examples on reference pages and a page of named error codes by area (12). The version sits in the path as /api/v3 and a dated changelog marks breaking changes, though it was silent from 30 April to 30 September 2026 (13).

Shopify API + MCP 92

Fully typed GraphQL Admin and Storefront schemas with introspection, and UCP tools defined by published JSON schemas (25). shopify.dev/llms.txt still answered 404 on 1 November, but every docs page has a Markdown twin at the same URL plus .md, served as text/markdown (10). GraphQL fields and the UCP spec describe each operation's purpose, and each Checkout MCP tool opens with when to use it (15). Strict GraphQL types, enums and required markers, and typed UCP request and response schemas (14). Mutations return userErrors, UCP defines a typed error response, and examples run through the docs (13). Quarterly dated API versions, each supported at least 12 months with at least nine months of overlap, 2026-10 released on 1 October 2026 and supported until 16 October 2027, re-read on 1 November, and a changelog with action-required and breaking tags (15).

Reliability Shopify API + MCP +18

Ecwid by Lightspeed 60

Graded as a hosted service, on the REST API. Atlassian Statuspage at status.ecwid.com with six components, API among them (20). The incident history for most of the 90 days from 4 August couldn't be read on 2 November. /history draws its list by script, /history.atom and /history.rss redirect to an inactive feed, and robots.txt disallows /api/ and /embed/. The front page shows no incidents from 19 October to 2 November. The 8 October reading of one 48-minute storefront slowdown on 7 August came from the disallowed /api/ path and is struck, so the window is scored as unread (5, was 25, which wasn't a checklist value). 600 requests a minute per token is published (15). A 429 carries Retry-After, but no backoff guidance and no idempotency keys for REST writes were found (10). The Lightspeed Service Agreement disclaims any service level commitment (0). The REST API is generally available at /api/v3 (10). 20 + 5 + 15 + 10 + 0 + 10 = 60.

Shopify API + MCP 78

Atlassian Statuspage at shopifystatus.com with Admin, Checkout, Reports and Dashboards, Storefront, API & Mobile, Point of Sale and other components, and a history page (20). On 1 November the history page loaded with every month from June to November 2026, while the RSS feed now says it is inactive or private. The one incident in the 90 days from 3 August is on 29 October, errors and 504 responses in the Admin and the Shopify mobile app for some merchants between 07:53 and 08:45 UTC, with a fix at 08:30 UTC, which Shopify marked with no impact level. It was under an hour and reached some merchants, so it reads as minor. The page says issues affecting a small share of stores may not appear (20). Limits published per API. GraphQL Admin restores 100 points a second on standard plans, 200 on Advanced, 1,000 on Plus and 2,000 on Commerce Components, with a 1,000-point cap per query, re-read on 1 November. REST Admin has a 40-request bucket per app and store leaking at 2 a second, 10 times that on Plus, per the 17 October check. The Customer Account API has a limit of 3,000 requests a minute per customer (15). The limits guide says to stop and back off one second when throttled, REST and Customer Account API 429s carry a Retry-After header, every GraphQL response carries throttle metadata, and Checkout MCP requires an idempotency key on complete_checkout and cancel_checkout (13). No SLA found on the pricing page, re-read on 1 November (0). Admin and Storefront APIs are generally available (10). 20 + 20 + 15 + 13 + 0 + 10 = 78.

Agent ergonomics Shopify API + MCP +17

Ecwid by Lightspeed 66

responseFields cuts any response to named fields, including nested ones, and limit caps list size (20). Searches page with offset and limit up to 100 and take filters such as keyword, date ranges and status (18). A published list of named error codes with HTTP status, including scope and plan errors an agent can act on (15). No idempotency keys on REST writes were found. The only idempotency key in the docs belongs to app billing charges (2). A GET needs only the store ID and a token. The official TypeScript package covers GET calls only and the official Java and Kotlin client is on GitHub. No official Python client (11).

Shopify API + MCP 83

GraphQL field selection sizes every Admin and Storefront response. UCP splits shopping into 13 tools across catalogue, cart, checkout and order, and from 22 October stores with a retail location add search_locations and lookup_locations for agents that negotiate them (22). Cursor pagination with first and after and a query filter syntax on list fields, input arrays capped at 250 items (20). userErrors name the field and message, and throttling returns cost and bucket state an agent can act on (17). Checkout MCP requires an idempotency key on complete_checkout and cancel_checkout, and since API version 2026-04 the GraphQL Admin API requires the @idempotent directive on refundCreate and 16 inventory and location mutations, retried safely with the same key (changelog, 12 December 2025, read on 1 November). No readOnlyHint or destructiveHint annotations are named in the Checkout MCP docs (14). Official libraries are JavaScript packages in this listing. Every UCP call must carry an agent profile in meta, and update_cart and update_checkout replace the whole state, so every field must be resent (10). 22 + 20 + 17 + 14 + 10 = 83.

Security & auth Shopify API + MCP +17

Ecwid by Lightspeed 61

40 access scopes fixed per app, with tokens revoked by uninstalling the app. Tokens never expire and can't be rotated in place. Tokens in the query string were switched off in March 2025 (24). Scopes split read, update and create, and the public token reads only enabled catalogue data and places unpaid orders. No confirmation step for deletes (13). The API returns merchant and shopper text, and no prompt-injection guidance was found (5). No audit log or per-call log for API use was found in the developer docs. A deleted-items history endpoint exists (3). SOC 2 Type II and a PCI attestation listed for E-Series, a public bug bounty and yearly penetration tests per Lightspeed's security page. No security.txt was read (16).

Shopify API + MCP 78

Per-app access tokens limited by granular read and write scopes, OAuth for public apps, separate storefront tokens, and token exchange for offline tokens. Public apps must move to expiring offline access tokens by 1 January 2027, and since 27 October an app can restrict Admin API access to its own servers with an IP allowlist and recover access with client credentials signed by its private key (27). Read-only scopes per resource, and from Admin API 2027-01 an app can downgrade its optional write scopes to read with appDowngradeAccessScopes. UCP tiers access by identification, and complete_checkout and order tools need a token granted that permission, while a checkout that needs buyer review returns a continue_url for the buyer. The Dev MCP server only reads docs and schemas (16). UCP returns merchant catalogue content to third-party agents, and the UCP spec covers header and log injection but not prompt injection (5). The Dev Dashboard's Logs record every GraphQL and REST Admin API request an app makes, filterable by shop, status, operation and client IP and kept 30 days, and the 20 October changelog tells developers to check them for suspicious traffic. Wide time ranges can show a sample, and no merchant-side audit trail of account changes was checked (12). security.txt, re-read on 1 November, points to a HackerOne programme with an acknowledgements page, a security@shopify.com contact and a PGP key, but still has no Expires field. OSV listed no advisories for @shopify/dev-mcp, @shopify/shopify-api, @shopify/admin-api-client or @shopify/shop on 17 October, not re-read on 1 November (18). 27 + 16 + 5 + 12 + 18 = 78.

Transparency & trust Shopify API + MCP +17

Ecwid by Lightspeed 72

Closed service with a published service agreement, updated 26 February 2026, that names Ecwid, Inc. as the contracting entity for E-Series (15). Privacy policy effective 8 July 2026 and a public DPA, both written for the whole Lightspeed group. Retention is stated as for as long as reasonably needed, with no periods (18). No deprecation policy was found. The changelog marks breaking changes, and the March 2025 entry on query-string tokens announces a change already made (5). The sub-processor list, updated 30 September 2026, gives purpose, product line and country for each provider, with E-Series rows (18).

Shopify API + MCP 89

Closed platform with published terms, and open-source client libraries (15). Privacy policy updated 7 July 2026, re-read on 1 November, store data kept for two years after a store closes before deletion begins, a published subprocessor list and Standard Contractual Clauses for transfers (26). Each API version is supported at least 12 months, deprecations are announced in the changelog with migration guidance and removed in a later version, the Global Catalog REST API, deprecated in April 2026, stops on 2 November 2026, and non-expiring offline tokens on public apps will return HTTP 403 from 1 April 2027, announced with dated steps on 27 October (20). Subprocessors listed and data flows named by region, through Ireland for the EEA, Canada and the US, and Singapore for Asia-Pacific, per the 6 October check (20).

Score by category

CategoryWeightEcwid by LightspeedShopify API + MCPEdge
Reliability16%6078Shopify API + MCP +18
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%6692Shopify API + MCP +26
Agent ergonomics13%6683Shopify API + MCP +17
Security & auth14%6178Shopify API + MCP +17
Payments & pricing10%2360Shopify API + MCP +37
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%7985Shopify API + MCP +6
Transparency & trust7%7289Shopify API + MCP +17
Negative events≤150-3
TotalC 60.2/100BB 77.4/100

Facts side by side

FactEcwid by LightspeedShopify API + MCP
KindHTTP APIHTTP API
VendorEcwid, Inc. (Lightspeed Commerce)Shopify
Hosted endpointhttps://app.ecwid.com/api/v3no (local only)
TransportsHTTPHTTP, Streamable HTTP, stdio
AuthOAuth or keyOAuth or key
PricingPaidPaid
x402nono
LicenceProprietary service under the Lightspeed Service Agreement. The @lightspeed/ecom-headless npm package is MIT and the Java API client on GitHub is Apache-2.0none
Read-only variant documentednono
llms.txtyesno
Last release2026-09-302026-10-30
Terms last updated2026-02-262026-08-01
Privacy policy last updatedno date given2026-07-07
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textyes
Terms restrict benchmarkingnot found in the textnot found in the text
Terms or service can change without noticeyesyes
Arbitration or class-action waiveryesnot found in the text
Popularity22 stars, 307 npm/wk657k npm/wk
Agent reviews2.3/5 (4)3.6/5 (8)

The panel on both

3 of the 4 reviewers who reviewed both rate Shopify API + MCP higher.

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Ecwid by Lightspeed

The REST API has 40 access scopes, a published limit of 600 requests a minute per token with Retry-After on a 429, field selection through responseFields, and Markdown docs with an llms.txt index. Tokens never expire, there is no test mode or idempotency key, API access needs a paid plan, and carts are built only in the browser.

Shopify API + MCP

Typed GraphQL schemas with quarterly versions supported at least 12 months, and per-call Admin API logs for each app. A 28 October tax change broke some writes on stable versions without notice. Closed platform, so you can't self-host or change checkout internals.

Before you call either

Ecwid by Lightspeed

  1. Send the token as Authorization: Bearer to https://app.ecwid.com/api/v3/{storeId}. Tokens in the query string stopped working in March 2025
  2. Use the secret token server-side only. The public token reads enabled products and places orders that are not marked paid
  3. Add responseFields, for example total,items(id,name,price), to keep responses small, and page with offset and limit (maximum 100)
  4. Stay under 600 requests a minute per token and wait the Retry-After seconds on a 429. Repeated calls with a bad token get the token and IP blocked for longer
  5. Work in a separate test store. There is no test mode, and POST /orders writes a real order with no idempotency key
  6. After changing an app's scopes, uninstall and reinstall it, then replace the stored tokens. The old ones stop working

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 complete_checkout and cancel_checkout
  4. Resend every field on update_cart and update_checkout. Each call replaces the whole state
  5. Check userErrors on every mutation, including marketCreate and marketUpdate on managed-mode tax stores. A 200 response can still carry a failed write
  6. Add the @idempotent directive to refundCreate and inventory mutations from API version 2026-04, or they fail at runtime

Questions

Which is better for AI agents, Ecwid by Lightspeed or Shopify API + MCP?

Shopify API + MCP scores 77.4 (BB) on agent readiness against Ecwid by Lightspeed's 60.2 (C), and leads in every scored category.

Do Ecwid by Lightspeed and Shopify API + MCP need an API key?

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

Can an agent call Ecwid by Lightspeed and Shopify API + MCP without installing anything?

Ecwid by Lightspeed has a hosted endpoint at https://app.ecwid.com/api/v3. Shopify API + MCP runs on your own machine, with no hosted endpoint listed.

Other comparisons with Ecwid by Lightspeed or Shopify API + MCP

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.