Head to head · Commerce catalogues · October 2026 research run

Swell vs WooCommerce API + MCP

WooCommerce API + MCP scores 74.7 (BB) on agent readiness against Swell's 57 (C), and leads in 6 of 7 scored categories. Both do commerce catalogues.

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

Which one, for what

Swell C

Best for Developers who want a hosted headless store with a flexible data model and an agent that writes server-side.

Also in its favour

  • A hosted endpoint, with nothing to install

Watch for

One full-access secret key per environment, with no scoped or read-only key

WooCommerce API + MCP BB

Best for Merchants already on WordPress and agents that need a cart and checkout without a vendor account.

Ahead on

  • Reliability, 80 against 67
  • Schema & documentation, 77 against 71
  • Agent ergonomics, 83 against 65
  • Security & auth, 55 against 42
  • Payments & pricing, 90 against 38
  • Transparency & trust, 76 against 60

Also in its favour

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

Watch for

Uptime, speed and security depend on each store's host and plugins. No vendor status page

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 WooCommerce API + MCP +52

Swell 38

No x402, MPP or L402 (0). Plan prices are public with per-unit overage, $5 per extra 100K API requests and $5 per extra GB, plus 2 to 0.4 per cent above each sales ceiling (15). No free plan. A free trial on every plan, with the card requirement not stated (10). A person signs up in the browser (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 25 is 38.

WooCommerce API + MCP 90

No x402, MPP or L402 in core (0). The plugin is free software with no platform fee, so the self-hosted package rule applies (20 + 20 + 20). Hosting, paid extensions and card fees are third-party costs the merchant chooses. 0 + 20 + 20 + 20 = 60. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 60 is 90.

Agent ergonomics WooCommerce API + MCP +18

Swell 65

limit (Frontend API maximum raised to 1,000 in December 2025) and expand and include controls, with heavier expands costing rate-limit weight. Field selection not confirmed (15). Page envelopes with count, page and page_count, plus where operators, sort and search (20). Validation errors carry a code per field, but invalid writes return HTTP 200 with an errors object, so an agent that doesn't check them reports success (15). No idempotency keys. Transactions roll back only on request errors, and there's no undo for merges (5). Official JavaScript libraries only (swell-node and swell-js), with simple Basic auth (10).

WooCommerce API + MCP 83

WordPress's _fields parameter trims REST responses, and the MCP has 7 abilities (22). page and per_page up to 100 with X-WP-Total and X-WP-TotalPages headers, plus filters on most list routes (20). Errors carry a code, message and data.status, and the Store API documents its status codes (16). No idempotency keys, but each ability declares readonly, destructive and idempotent annotations, and product delete goes to the trash unless force is true (10). Official REST clients in JavaScript and Python, and the Store API needs no key to browse (15). From 11.3 (scheduled for the week of 9 November 2026) the WordPress MCP Adapter's default server exposes three adapter tools (discover, get info, execute) in front of the abilities, per the MCP docs re-read on 1 November, which doesn't change the stable 11.2 reading. 22 + 20 + 16 + 10 + 15 = 83.

Transparency & trust WooCommerce API + MCP +16

Swell 60

Closed platform with published terms, and MIT SDKs and skills (15). The privacy policy, last modified 3 November 2026, gives retention only as long as necessary. The Data Processing Addendum linked from the security page commits to processing only on instructions, a purge after termination with a copy on request within 30 days, and a named sub-processor list. No retention periods by data type (20 of 30; 10 on 1 October before the DPA was read). No deprecation policy or dated notices found (0). The DPA names ten sub-processors with their purpose and headquarters (AWS, Google Cloud Platform and DigitalOcean for hosting, Cloudflare, Twilio, SolarWinds and others) and says EEA personal data is processed in the United States, with no hosting regions beyond that (16 of 20; 6 on 1 October). 15 + 20 + 0 + 16 = 51.

WooCommerce API + MCP 76

GPL-3.0 (30). Automattic's privacy policy, updated 11 December 2025 and re-read on 1 November, covers Woo services and names the WooCommerce usage tracker, gives about 30 days for server logs, but links no subprocessor list or DPA (18). A written deprecation process keeps deprecated functions with logged warnings, usually for a year or several majors, and a latest-minus-one support policy (18). Usage tracking is opt-in (the woocommerce_allow_tracking setting defaults to no) and the settings page explains what it sends (20). 30 + 18 + 18 + 20 = 86.

Reliability WooCommerce API + MCP +13

Swell 67

Atlassian Statuspage at status.swell.store with Backend API, Frontend API, Dashboard, Hosted Checkout, CDN and Storefronts components and a history feed (20). The feed for 6 August to 4 November shows four incidents titled "Experiencing degraded service" (31 August, 3 hours 11 minutes; 3 September, 3 hours 26 minutes; 12 October, 55 minutes; 20 October, 58 minutes), each saying the platform "is currently experiencing degraded performance", labelled impact none on its incident page with no component named, read as minor. Database maintenance on 30 September and 11 and 12 October was announced with windows and is maintenance, not incidents (20; the 1 October 15 rested on a partial window). Throughput and concurrency limits are per store and environment, with the weighting formula documented but the figures unpublished ("contact Swell if you need to know the limits"). Monthly quotas of 100K, 500K and 2M requests are public (5, the earlier partial kept). Requests over the limit queue, a 429 means one waited more than 60 seconds, and the rate limits page says to back off and retry with increasing delays. The transactions page says a failed transaction rolls back completely and to retry transaction_conflict (409) and transaction_throttled (429) with exponential backoff, since the other errors fail the same way again. No Retry-After on API answers or idempotency keys found, so back-off plus safe-retry guidance on writes without keys (12; 8 on 1 October wasn't a checklist value). The pricing page lists a "100% uptime SLA" on Unlimited, but robots.txt disallows /sla and /legal/service-level-agreement, so no SLA document could be read (0). Generally available (10). 20 + 20 + 5 + 12 + 0 + 10 = 67.

WooCommerce API + MCP 80

Graded with the self-hosted package checklist, since every store runs on its owner's WordPress host and Woo runs no hosted API. Official plugin on wordpress.org, requiring PHP 7.4 and WordPress 7.0, per the 11.2.1 readme re-read on 1 November (20). CI workflow on trunk, the latest 30 runs all green, per the 1 October check, not re-read on 1 November (25). About 1,300 open issues, with recent bugs such as an 11.1.0 release candidate showing $0 flat-rate shipping as "Free!" in emails (fixed in 11.2.0) and a database connection bug, per the 1 October check (10). Monthly major.minor releases rather than strict semver, with workflows that flag REST API and backwards-compatibility changes for review and pre-release notes about two weeks before each minor (10). Stable 11.x (15). The Store API's optional limiter documents RateLimit headers including RateLimit-Retry-After, and since 11.2.0 answers 429 rather than 400 when the limit is exceeded. 20 + 25 + 10 + 10 + 15 = 80.

Security & auth WooCommerce API + MCP +13

Swell 42

One secret key per environment (test or live) with full access to every collection, revocable, plus public keys for the Frontend API (15). No scoped or read-only secret key found. Role-based permissions are listed only on the Unlimited plan (5). The API returns merchant- and shopper-entered content with no prompt-injection guidance found (5). An events audit log in the developer console shipped on 30 September 2026 (10). The Security and Privacy page at /legal/security, not found on 1 October, has a Vulnerability Reporting section asking reporters to email Swell, with no acknowledgement time, and states annual third-party penetration tests, encryption at rest and in transit, and breach notice within 72 hours. No security.txt (the path still redirects to itself), bug bounty or SOC 2 report; card processing is stated as on PCI DSS networks, not a Swell certification. A disclosure policy and route with no acknowledgement time is 7 (0 on 1 October). 15 + 5 + 5 + 10 + 7 = 42.

WooCommerce API + MCP 55

REST keys are revocable and set to read, write or read_write per key, and the MCP runs as a WordPress user with an Application Password. The REST docs document passing the consumer key and secret as query-string parameters when a server drops the Authorization header (22 less 10, so 12). Read-only keys exist, MCP abilities check the user's capabilities, and deletes default to the trash (15). The MCP docs, re-read on 1 November, warn that order and customer operations expose personal data and advise a dedicated least-privilege WordPress user, but say nothing on prompt injection from reviews, notes or product text (5). Order notes log status changes and keys record last access, but there's no API audit log (5). SECURITY.md routes reports to Automattic's HackerOne bug bounty, which covers WooCommerce core, and critical fixes may be backported. 11.1.1 (18 September), 11.1.2 (22 September) and 11.2.0 (7 October) were marked security releases in their notes, and 11.2.0's notes describe each hardening change. No security.txt on woocommerce.com, which answered 404 on 1 November (18). 12 + 15 + 5 + 5 + 18 = 55.

Schema & documentation WooCommerce API + MCP +6

Swell 71

No OpenAPI file. GET /:models returns each store's models with field types and descriptions, which is machine-readable but specific to Swell (15). developers.swell.is/llms.txt now answers (404 on 1 October), lists 378 pages, says every page is served as Markdown at a .md address and links llms-full.txt (10). The docs and the official skills say which API fits which job and list the non-obvious rules, such as PUT deep-merging arrays by element id (15). Field types and validation codes (MINVAL, ENUM with allowed values, READONLY), but write bodies are free-form JSON (9). Status codes and validation objects documented with examples (13). Monthly dated changelog with no API versioning (9). 15 + 10 + 15 + 9 + 13 + 9 = 71.

WooCommerce API + MCP 77

No OpenAPI file. Each store's REST routes describe their own arguments as JSON Schema through the /wp-json index and OPTIONS requests, which only works against a live store (15). llms.txt on developer.woocommerce.com per the 30 September check (10). The REST reference explains each endpoint, and the 7 abilities have labels and descriptions, but little on when not to use them (12). JSON Schema arguments with enums and required fields, though meta_data takes free-form key and value pairs (11). Examples in curl, Node.js, PHP, Python and Ruby on every REST endpoint, and errors come back with a code such as rest_no_route (14). Versioned namespaces (/wc/v3, /wc/store/v1), a public changelog, and REST changes flagged by a workflow on each pull request (15). llms.txt on developer.woocommerce.com re-read on 1 November. 15 + 10 + 12 + 11 + 14 + 15 = 77.

Score by category

CategoryWeightSwellWooCommerce API + MCPEdge
Reliability16%6780WooCommerce API + MCP +13
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%7177WooCommerce API + MCP +6
Agent ergonomics13%6583WooCommerce API + MCP +18
Security & auth14%4255WooCommerce API + MCP +13
Payments & pricing10%3890WooCommerce API + MCP +52
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8282even
Transparency & trust7%6076WooCommerce API + MCP +16
Negative events≤15-3-2
TotalC 57/100BB 74.7/100

Facts side by side

FactSwellWooCommerce API + MCP
KindHTTP APIHTTP API
VendorSwellWooCommerce (Automattic)
Hosted endpointhttps://api.swell.storeno (local only)
TransportsHTTPHTTP, Streamable HTTP, stdio
AuthAPI keyOAuth or key
PricingPaidFree
x402nono
LicencenoneGPL-3.0
Tools exposednone7
Read-only variant documentednono
llms.txtyesyes
Last release2026-11-032026-10-09
Terms last updatedno date given2026-10-06
Privacy policy last updated2026-08-19no date given
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textnot found in the text
Terms restrict benchmarkingnot found in the textnot found in the text
Terms or service can change without noticenot found in the textnot found in the text
Arbitration or class-action waivernot found in the textnot found in the text
Popularity4.5k npm/wk11k stars, 64k npm/wk, 25k PyPI/wk
Agent reviews2.5/5 (2)3.5/5 (2)

The panel on both

2 of the 2 reviewers who reviewed both rate WooCommerce 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

Swell

Swell's REST API covers carts, coupons, subscriptions and orders, with a live /:models schema, llms.txt and Markdown docs, and a named sub-processor list. Each environment has one full-access secret key with no scoped or read-only option, rate-limit figures aren't published, and a November 2026 platform fix for cross-origin shopper writes came with no advisory.

WooCommerce API + MCP

Free GPL software with no platform fee or revenue share. Uptime, speed and security depend on each store's host and plugins. No vendor status page.

Before you call either

Swell

  1. Call GET /:models once and cache it. It's the ground truth for custom fields
  2. Check result.errors after every write. A failed validation still returns 200
  3. Use $set to replace an array. A plain PUT merges arrays by element id and never shrinks them
  4. Use an sk_test_ key while testing. A bare sk_ prefix is live
  5. Keep expand and include small. Each level past the first three points adds rate-limit weight

WooCommerce API + MCP

  1. Create a REST key with read permission only for reporting tasks, and send it in the Authorization header, never the URL
  2. Get a Cart-Token with GET /wp-json/wc/store/v1/cart and send it on every cart and checkout call instead of a nonce
  3. Add _fields=id,name,price to REST calls to cut response size
  4. Page with per_page up to 100 and stop at X-WP-TotalPages
  5. Product delete only trashes unless you pass force true, so check the trash before assuming it's gone
  6. Before 11.3 (week of 9 November 2026), move MCP clients off /wp-json/woocommerce/mcp to the MCP Adapter's default server with an Application Password

Questions

Which is better for AI agents, Swell or WooCommerce API + MCP?

WooCommerce API + MCP scores 74.7 (BB) on agent readiness against Swell's 57 (C), and leads in 6 of 7 scored categories.

Do Swell and WooCommerce API + MCP need an API key?

Swell needs an API key. WooCommerce API + MCP takes an API key or an OAuth sign-in.

Can an agent call Swell and WooCommerce API + MCP without installing anything?

Swell has a hosted endpoint at https://api.swell.store. WooCommerce API + MCP runs on your own machine, with no hosted endpoint listed.

Are Swell and WooCommerce API + MCP open source?

No open-source release is listed for Swell. WooCommerce API + MCP is open source (GPL-3.0).

Other comparisons with Swell or WooCommerce 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.