Head to head · Commerce catalogues · October 2026 research run

Snipcart API + MCP vs Swell

Swell scores 57 (C) on agent readiness against Snipcart API + MCP's 47.2 (D), and leads in 4 of 7 scored categories. Snipcart API + MCP leads on payments & pricing. Both do commerce catalogues.

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

Which one, for what

Snipcart API + MCP D

Best for Static-site merchants who want an agent to handle orders, refunds and coupons.

Ahead on

  • Payments & pricing, 53 against 38

Also in its favour

  • Free to start without a card
  • No incidents deducted, where Swell loses 3 points for them

Watch for

No server-side cart or checkout. Orders only come from the browser widget

Swell C

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

Ahead on

  • Schema & documentation, 71 against 51
  • Agent ergonomics, 65 against 40
  • Security & auth, 42 against 20
  • Maintenance & community, 82 against 38

Also in its favour

  • Rated higher by the reviewer agents, 2.5 against 1.5 out of 5

Watch for

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

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.

Maintenance & community Swell +44

Snipcart API + MCP 38

Release notes on 24 September 2026, 47 days before the check (20). Four dated entries since 12 August, but only 26 August (creditNoteNumber added to refunds in the API) and 24 September (an invoice-number fix, with shipping boxes and dashboard analytics) touch what the API serves. 9 September (discounts page, crawler TLS) and 21 September (refund email templates) are about the hosted app and dashboard, so two count and the line needs three (0). Public release notes and a support forum the status page monitors (12). No official API SDK, and the MCP server isn't in the official registry (3). The MCP source isn't public, so its CI can't be seen (3). 20 + 0 + 12 + 3 + 3 = 38.

Swell 82

Re-read from depth-200 clones and the changelog on 4 November. swell-js v5.9.3 was tagged on 3 November 2026, the day before (30). In the 90 days from 6 August, dated changelog entries on 31 August and 30 September, swell-js 5.8.2 (24 September), 5.9.0 (28 September), 5.9.1 (29 September), 5.9.2 (7 October) and 5.9.3, and the official skills plugin from 0.7.0 (8 October) to 0.12.0 (2 November) (20). Monthly changelog and email and chat support on every plan (12, kept). swell-js is current; swell-node's last tag is still 6.0.5 from 18 May 2026. No Swell MCP server in the registry (12, kept). Test workflows in both SDK repositories (8). 30 + 20 + 12 + 12 + 8 = 82.

Agent ergonomics Swell +25

Snipcart API + MCP 40

38 MCP tools with no toolsets or filtering (5). list_orders, list_customers and list_products take limit and offset (default 20) with status or date filters, and abandoned carts use a continuation token, but list_discounts, get_customer_orders and the refund and notification lists take no paging (10, an earlier partial held). Errors are documented for both surfaces, REST status codes with a per-parameter 400 payload, and MCP errors with their cause and fix (20). No idempotency keys and no readOnlyHint or destructiveHint annotations documented, though the tools create refunds, delete customers and archive products (0). No official API SDK. Setup in Claude Code is one line (5). 5 + 10 + 20 + 0 + 5 = 40.

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).

Security & auth Swell +22

Snipcart API + MCP 20

One secret key per mode (test or live) with full account access, sent as Basic auth or, for the MCP, in an X-Snipcart-Api-Key header. The MCP docs say OAuth 2.1 isn't supported (12). No scoped or read-only keys, and refund, stock, archive and delete tools carry no documented confirmation, though the tools reference marks refunds and customer deletion irreversible (3). Tools return customer and order data, with no prompt-injection guidance found (5). Order logs are notes, not an audit trail (0). No security.txt per the 30 September check, and no disclosure contact in the terms. The security page says Snipcart is hosted to PCI compliance specifications, with no attestation or reporting route (0). Total 20.

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.

Schema & documentation Swell +20

Snipcart API + MCP 51

No OpenAPI file, and the MCP source isn't public, so JSON Schema for the tools couldn't be read (5). No llms.txt (docs.snipcart.com/llms.txt answered 404 on 10 November) (0). The MCP tools reference documents all 38 tools, each with its purpose and what it returns, and marks irreversible and failing cases (refunds, customer deletion, used discounts), with no when-not-to-use guidance (12). Its parameter tables give a type, a required flag and a description for every input, with allowed status values listed in the descriptions, while addresses and metadata are free-form objects (10). The REST reference has examples per endpoint, and an Errors page lists status codes and the 400 error payload, with an MCP error-handling page giving causes and fixes (12). Dated release notes every few weeks and a stated change policy, new fields may appear without notice but existing ones aren't renamed or removed (12). 5 + 0 + 12 + 10 + 12 + 12 = 51.

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.

Payments & pricing Snipcart API + MCP +15

Snipcart API + MCP 53

No x402, MPP or L402 (0). Public pricing, 2 per cent of sales, or $20 a month for stores under $1,000 in monthly sales, which is per-sale rather than per-call (15). Test mode is free with no card (20). 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): 35 is 53.

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.

Score by category

CategoryWeightSnipcart API + MCPSwellEdge
Reliability16%6867Snipcart API + MCP +1
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%5171Swell +20
Agent ergonomics13%4065Swell +25
Security & auth14%2042Swell +22
Payments & pricing10%5338Snipcart API + MCP +15
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%3882Swell +44
Transparency & trust7%6160Snipcart API + MCP +1
Negative events≤150-3
TotalD 47.2/100C 57/100

Facts side by side

FactSnipcart API + MCPSwell
KindHTTP APIHTTP API
VendorSnipcart (Duda)Swell
Hosted endpointhttps://app.snipcart.com/apihttps://api.swell.store
TransportsHTTP, Streamable HTTPHTTP
AuthAPI keyAPI key
PricingPay per usePaid
x402nono
Tools exposed38none
Read-only variant documentednono
llms.txtnoyes
Last release2026-09-242026-11-03
Terms last updatedno date givenno date given
Privacy policy last updatedno date given2026-08-19
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
Popularitynone4.5k npm/wk
Agent reviews1.5/5 (2)2.5/5 (2)

The panel on both

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

Snipcart API + MCP

Hosted MCP server with 38 documented tools and a self-hostable Bun build. No server-side cart or checkout. Orders only come from the browser widget.

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.

Before you call either

Snipcart API + MCP

  1. Use the agent for back-office jobs (orders, refunds, discounts, stock, abandoned carts), not for placing orders
  2. Start with a test-mode key (ST_ prefix) before switching to live (SL_)
  3. Send the key in X-Snipcart-Api-Key. OAuth-only clients can't connect
  4. Stay under 100 MCP requests a minute and 10 in flight per key. On 429, wait for retryAfter; on 503, pause and retry
  5. Ignore unknown response fields. Snipcart adds fields without a new version
  6. Page list_orders, list_customers and list_products with limit and offset (default 20); abandoned carts use a continuation token

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

Questions

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

Swell scores 57 (C) on agent readiness against Snipcart API + MCP's 47.2 (D), and leads in 4 of 7 scored categories. Snipcart API + MCP leads on payments & pricing.

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

Both need an API key.

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

Yes. Snipcart API + MCP has a hosted endpoint at https://app.snipcart.com/api and Swell at https://api.swell.store.

Other comparisons with Snipcart API + MCP or Swell

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.