Skip to content

How Swell’s scores are calculated

The full audit trail, recomputed from the verdict data at build time through the same code that produced the leaderboard: verdict × quality × story weight per cell, cells sum to dimension scores, dimensions blend into the PA Score. Every number on the product page is reproducible from this page alone; for why the formula looks like this, see the methodology.

verdict factors: full ×1.0 · partial ×0.6 · disputed ×0.3 · none ×0.0 · n/a excluded from both sides · cell points = weight × quality × factor · cell max = weight × 10

PA Score17/100

Agent-ready 30.0 × 0.30 = 9.00

API quality 5.1 × 0.20 = 1.02

Openness 19.7 × 0.20 = 3.94

Built-in AI 5.3 × 0.15 = 0.79

Automation 17.3 × 0.15 = 2.60

(9.00 + 1.02 + 3.94 + 0.79 + 2.60) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 17.35 ÷ 1.00 = 17.3

Scores are stored to 1 decimal; the product page’s pills round to whole numbers for display. Each dimension below shows the stories, verdicts, and cited evidence behind its number.

Agent-ready30.0/100×0.30 of the PA blend

Outside-in: can YOUR agent reach and drive this product — API, MCP, CLI, headless runs, agent docs.

Point an agent at llms.txt or agent-oriented docsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.

Run the product headlessly / in CI for automationweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [claimed-docs] https://developers.swell.is/apps/cliSwell CLI is a command-line interface that helps you create and work with apps, themes, and storefronts.
  • [claimed-docs] https://developers.swell.is/apps/cliswell app init: initialize an app in the current directory with a default config file and folder structure
  • [claimed-docs] https://developers.swell.is/apps/cliswell app push: push configuration files to a development store
  • [claimed-docs] https://developers.swell.is/apps/cliSwitch your current default store.
  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.
  • [probe] https://developers.swell.is/apps/cliofficial CLI documented at https://developers.swell.is/apps/cli

Plug MCP servers into this product so it can use their toolsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Connect an agent via an official MCP serverweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.
  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)
  • [probe] https://developers.swell.is/apps/cliofficial CLI documented at https://developers.swell.is/apps/cli

Use an official CLIweight 2

2 (weight) × 7 (quality) × 1.0 (full) = 14.0 of 20 max

  • [claimed-docs] https://developers.swell.is/apps/cliswell app init: initialize an app in the current directory with a default config file and folder structure
  • [claimed-docs] https://developers.swell.is/apps/cliSwitch your current default store.
  • [claimed-docs] https://developers.swell.is/apps/cliSwell CLI is a command-line interface that helps you create and work with apps, themes, and storefronts.
  • [claimed-docs] https://developers.swell.is/apps/cliswell app push: push configuration files to a development store
  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.
  • [probe] https://developers.swell.is/apps/cliofficial CLI documented at https://developers.swell.is/apps/cli

Drive the product through a documented public APIweight 3

3 (weight) × 7 (quality) × 1.0 (full) = 21.0 of 30 max

  • [claimed-docs] https://developers.swell.is/backend-api/introductionOfficial libraries for the Swell API are available for Node and PHP.
  • [claimed-docs] https://developers.swell.is/backend-api/authenticationKeys are environment-specific: secret keys prefixed sk_test_ route requests to your store's test environment, while sk_live_ keys target live data.
  • [claimed-docs] https://www.swell.is/aiOne call returns a store’s whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.
  • [claimed-docs] https://developers.swell.is/backend-api/authenticationauthenticate with basic auth using your store ID as the username and a secret key as the password
  • [claimed-docs] https://developers.swell.is/backend-api/purchase-linksPurchase links allow you to configure a pre-selected group of products within a cart and direct a customer to its checkout through a designated URL.
  • [claimed-docs] https://developers.swell.is/backend-api/stockStock adjustments are used to keep track of inventory changes over time.
  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)

Issue scoped/least-privilege API credentials for an agentweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://developers.swell.is/backend-api/authenticationKeys are environment-specific: secret keys prefixed sk_test_ route requests to your store's test environment, while sk_live_ keys target live data.
  • [claimed-docs] https://developers.swell.is/backend-api/authenticationauthenticate with basic auth using your store ID as the username and a secret key as the password
  • [claimed-docs] https://www.swell.is/pricingAssign specific roles and permissions to team members for better control.

Build against official SDKsweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [claimed-docs] https://developers.swell.is/backend-api/introductionOfficial libraries for the Swell API are available for Node and PHP.
  • [claimed-docs] https://developers.swell.is/apps/cliSwell CLI is a command-line interface that helps you create and work with apps, themes, and storefronts.
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)
  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt

Subscribe to events via webhooksweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

  • [claimed-docs] https://developers.swell.is/apps/overviewWebhooks can be configured to call a URL when a particular event occurs, enabling outgoing calls to external services.
  • [claimed-docs] https://developers.swell.is/apps/webhooksWebhooks enable real-time communication between the Swell platform and external services, by subscribing to any number of model events.

Agent-ready = 63.0 ÷ 210 × 100 = 30.0

API quality5.1/100×0.20 of the PA blend

The programmable surface once an agent is there — machine-readable spec, interactive docs, sandbox, versioning discipline.

Explore an interactive API reference with runnable examplesweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)

Download a machine-readable API spec (OpenAPI or equivalent)weight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)
  • [claimed-docs] https://www.swell.is/aiOne call returns a store’s whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.
  • [claimed-docs] https://www.swell.is/aiOne call returns a store's whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.

Test against a sandbox environment without touching production dataweight 1

1 (weight) × 6 (quality) × 0.6 (partial) = 3.6 of 10 max

  • [claimed-docs] https://developers.swell.is/backend-api/authenticationKeys are environment-specific: secret keys prefixed sk_test_ route requests to your store's test environment, while sk_live_ keys target live data.
  • [claimed-docs] https://developers.swell.is/apps/cliswell app push: push configuration files to a development store
  • [claimed-docs] https://developers.swell.is/apps/cliSwitch your current default store.
  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.

Rely on versioned APIs with a documented deprecation policyweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)

API quality = 3.6 ÷ 70 × 100 = 5.1

Openness19.7/100×0.20 of the PA blend

Can you leave, inspect, or self-host — data export, open source, portability.

Do everything through the API that I can do in the UIweight 2

2 (weight) × 7 (quality) × 0.6 (partial) = 8.4 of 20 max

  • [claimed-docs] https://www.swell.is/for-developersBuild frontends for storefronts and admin workflows with any framework.
  • [claimed-docs] https://www.swell.is/aiOne call returns a store’s whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.
  • [claimed-docs] https://developers.swell.is/apps/overviewData models can alter a store's database schema, either by adding fields to existing models (like products and orders) or creating completely new ones.
  • [claimed-docs] https://developers.swell.is/apps/cliSwell CLI is a command-line interface that helps you create and work with apps, themes, and storefronts.
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)

Export all of my data in open formats and leaveweight 3

3 (weight) × 3 (quality) × 0.6 (partial) = 5.4 of 30 max

  • [claimed-docs] https://www.swell.is/featuresSeamlessly import or export products from CSV files, including product categories.

Read the product's source under an open licenseweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [probe] https://developers.swell.is/llms.txtPROBE llms.txt: HTTP 404 at https://developers.swell.is/llms.txt
  • [probe] https://developers.swell.is/openapi.jsonPROBE openapi: all candidate paths 404 (https://developers.swell.is/openapi.json, https://developers.swell.is/swagger.json, https://developers.swell.is/api/openapi.json, https://developers.swell.is/.well-known/openapi.json)

Self-host the core productweight 3

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Openness = 13.8 ÷ 70 × 100 = 19.7

Built-in AI5.3/100×0.15 of the PA blend

Inside-out: how agentic the product itself is for its users — built-in assistants, autonomous features.

Get AI-generated insights and suggestions from my data inside the productweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://www.swell.is/aiDrop a JSON file into your app’s models/ directory and Swell generates the REST resource from it—fields, validation, relationships and lifecycle events, with no endpoint code to write.
  • [claimed-docs] https://www.swell.is/aiOne call returns a store’s whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.
  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.
  • [claimed-docs] https://www.swell.is/pricingAccess detailed reports that aid in tracking and analyzing your store's performance.

Set up automations that run autonomously in the backgroundweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [claimed-docs] https://developers.swell.is/apps/overviewWebhooks can be configured to call a URL when a particular event occurs, enabling outgoing calls to external services.
  • [claimed-docs] https://developers.swell.is/apps/webhooksWebhooks enable real-time communication between the Swell platform and external services, by subscribing to any number of model events.
  • [claimed-docs] https://developers.swell.is/apps/functionsFunctions are deployed to edge data centers in 200+ locations and have no cold start time.
  • [claimed-docs] https://developers.swell.is/apps/functionsFunctions have no cold boots and do not require extra time to start up before executing your code.

Delegate tasks to a built-in AI assistant inside the productweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

  • [claimed-docs] https://www.swell.is/aiDrop a JSON file into your app’s models/ directory and Swell generates the REST resource from it—fields, validation, relationships and lifecycle events, with no endpoint code to write.
  • [claimed-docs] https://www.swell.is/aiOne call returns a store’s whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.
  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.
  • [claimed-docs] https://www.swell.is/aiOne call returns a store's whole schema at runtime: every model—standard, merchant custom and app-installed alike—with field types and relationships.

Operate the product with natural-language commandsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

  • [claimed-docs] https://www.swell.is/aiInstall once and your agent picks up the file contract, the CLI and the validate-deploy-verify loop.
  • [claimed-docs] https://developers.swell.is/apps/cliSwell CLI is a command-line interface that helps you create and work with apps, themes, and storefronts.
  • [claimed-docs] https://developers.swell.is/apps/cliswell app init: initialize an app in the current directory with a default config file and folder structure
  • [claimed-docs] https://developers.swell.is/apps/cliswell app push: push configuration files to a development store

Built-in AI = 4.8 ÷ 90 × 100 = 5.3

Automation17.3/100×0.15 of the PA blend

Depth of automation primitives — rules, scheduling, bulk operations, webhooks.

Perform bulk operations across many items at onceweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

  • [claimed-docs] https://www.swell.is/featuresSeamlessly import or export products from CSV files, including product categories.
  • [claimed-docs] https://www.swell.is/featuresCreate unique product variations with unlimited options and attributes. Track inventory of each variant in real-time.
  • [claimed-docs] https://developers.swell.is/backend-api/stockStock adjustments are used to keep track of inventory changes over time.

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 5 (quality) × 0.6 (partial) = 9.0 of 30 max

  • [claimed-docs] https://developers.swell.is/apps/overviewWebhooks can be configured to call a URL when a particular event occurs, enabling outgoing calls to external services.
  • [claimed-docs] https://developers.swell.is/apps/webhooksWebhooks enable real-time communication between the Swell platform and external services, by subscribing to any number of model events.
  • [claimed-docs] https://developers.swell.is/apps/overviewData models can alter a store's database schema, either by adding fields to existing models (like products and orders) or creating completely new ones.
  • [claimed-docs] https://www.swell.is/for-developersDeploy serverless functions to customize logic and connect to external APIs.
  • [claimed-docs] https://developers.swell.is/apps/functionsFunctions are deployed to edge data centers in 200+ locations and have no cold start time.

Schedule recurring jobs or workflowsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Version, review, and roll back my automationsweight 1

1 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 10 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Automation = 13.8 ÷ 80 × 100 = 17.3