Skip to content

How Medusa’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 Score32/100

Agent-ready 42.3 × 0.30 = 12.69

API quality 20.6 × 0.20 = 4.12

Openness 56.2 × 0.20 = 11.24

Built-in AI 14.7 × 0.15 = 2.20

Automation 11.3 × 0.15 = 1.70

(12.69 + 4.12 + 11.24 + 2.20 + 1.70) ÷ (0.30 + 0.20 + 0.20 + 0.15 + 0.15) = 31.95 ÷ 1.00 = 32.0

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-ready42.3/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) × 9 (quality) × 1.0 (full) = 18.0 of 20 max

  • [probe] https://docs.medusajs.com/llms.txtPROBE llms.txt: HTTP 200 at https://docs.medusajs.com/llms.txt # Medusa > Medusa is a digital commerce platform with a built-in Framework for customization. When you install Medusa,
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdThe Medusa documentation provides a remote Model Context Protocol (MCP) server that allows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor.
  • [probe] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-serverofficial MCP server documented at https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server

Run the product headlessly / in CI for automationweight 2

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

  • [community] https://news.ycombinator.com/item?id=28481913I love the idea of a headless ecommerce platform, especially one that comes with a nice backend GUI for managing inventory. Pleasantly surprised by the maturity of the features for a medium sized store.
  • [github] https://github.com/medusajs/medusaMedusa's core commerce modules are open-source and freely available on npm.
  • [probe] https://docs.medusajs.com/resources/medusa-cliofficial CLI documented at https://docs.medusajs.com/resources/medusa-cli
  • [claimed-docs] https://medusajs.com/pricingMedusa MCP and Cloud CLI
  • [claimed-docs] https://medusajs.com/pricingInstant previews on PRs
  • [claimed-docs] https://medusajs.com/pricingBackground workers
  • [community] https://hn.algolia.com/api/v1/items/29392312Haven't investigated deploying Medusa to a serverless environment yet. We use background workers to process jobs from a Bull queue that may not finish within a request's lifetime.

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

  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdallows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdThe Medusa documentation provides a remote Model Context Protocol (MCP) server that allows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor.
  • [probe] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-serverofficial MCP server documented at https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server
  • [claimed-docs] https://medusajs.com/pricingCloud Development Agent

Connect an agent via an official MCP serverweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdallows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdThe Medusa documentation provides a remote Model Context Protocol (MCP) server that allows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor.
  • [probe] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-serverofficial MCP server documented at https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server

Use an official CLIweight 2

2 (weight) × 6 (quality) × 1.0 (full) = 12.0 of 20 max

  • [probe] https://docs.medusajs.com/resources/medusa-cliofficial CLI documented at https://docs.medusajs.com/resources/medusa-cli
  • [claimed-docs] https://medusajs.com/pricingMedusa MCP and Cloud CLI

Drive the product through a documented public APIweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.
  • [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/productProduct Module - Medusa Documentation
  • [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/cartCart Module - Medusa Documentation
  • [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/orderOrder Module - Medusa Documentation
  • [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/paymentPayment Module - Medusa Documentation
  • [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/taxTax Module - Medusa Documentation
  • [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/fulfillmentFulfillment Module - Medusa Documentation
  • [probe] https://docs.medusajs.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.medusajs.com/openapi.json, https://docs.medusajs.com/swagger.json, https://docs.medusajs.com/api/openapi.json, https://docs.medusajs.com/.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://medusajs.com/pricingRBAC, SSO, Audit Logs

Build against official SDKsweight 2

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

  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.
  • [probe] https://docs.medusajs.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.medusajs.com/openapi.json, https://docs.medusajs.com/swagger.json, https://docs.medusajs.com/api/openapi.json, https://docs.medusajs.com/.well-known/openapi.json)

Subscribe to events via webhooksweight 2

2 (weight) × 3 (quality) × 0.6 (partial) = 3.6 of 20 max

Agent-ready = 88.8 ÷ 210 × 100 = 42.3

API quality20.6/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) × 5 (quality) × 0.6 (partial) = 6.0 of 20 max

  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.
  • [probe] https://docs.medusajs.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.medusajs.com/openapi.json, https://docs.medusajs.com/swagger.json, https://docs.medusajs.com/api/openapi.json, https://docs.medusajs.com/.well-known/openapi.json)

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

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

  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.
  • [probe] https://docs.medusajs.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.medusajs.com/openapi.json, https://docs.medusajs.com/swagger.json, https://docs.medusajs.com/api/openapi.json, https://docs.medusajs.com/.well-known/openapi.json)

Test against a sandbox environment without touching production dataweight 1

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

  • [claimed-docs] https://medusajs.com/pricingInstant previews on PRs
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.

Rely on versioned APIs with a documented deprecation policyweight 2

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

  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.
  • [probe] https://docs.medusajs.com/openapi.jsonPROBE openapi: all candidate paths 404 (https://docs.medusajs.com/openapi.json, https://docs.medusajs.com/swagger.json, https://docs.medusajs.com/api/openapi.json, https://docs.medusajs.com/.well-known/openapi.json)

API quality = 14.4 ÷ 70 × 100 = 20.6

Openness56.2/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) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.
  • [github] https://github.com/medusajs/medusaMedusa is a commerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic.
  • [claimed-docs] https://medusajs.comAdmin - Customizable dashboard for your commerce.

Export all of my data in open formats and leaveweight 3

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

  • [github] https://github.com/medusajs/medusaMedusa's core commerce modules are open-source and freely available on npm.
  • [claimed-docs] https://medusajs.com/pricingOwn and control all your source-code, while we handle your infrastructure.
  • [claimed-docs] https://medusajs.com/pricingYou own the project, we handle the infra.
  • [claimed-docs] https://medusajs.com/pricingYou own the project, we handle the infra. No GMV-tax or special licenses.
  • [github] https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yamlopenapi: 3.0.0 / info: title: Medusa Storefront API, license: MIT — Medusa maintains complete machine-readable OpenAPI 3.0 specifications for the Store (and Admin) REST APIs in the medusajs/medusa repository; they power the docs.medusajs.com/api reference.

Read the product's source under an open licenseweight 2

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

  • [github] https://github.com/medusajs/medusaMedusa is a commerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic.
  • [github] https://github.com/medusajs/medusaMedusa's core commerce modules are open-source and freely available on npm.
  • [community] https://news.ycombinator.com/item?id=28481913The landing page looks like it's trying to sell me a product, but the Github says it's MIT licensed... is there some component that costs money down the road? No pricing page found.
  • [community] https://hn.algolia.com/api/v1/items/41979332Listed among open-source SaaS alternatives: 'Shopify -> MedusaJS'.

Self-host the core productweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

  • [github] https://github.com/medusajs/medusaMedusa is a commerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic.
  • [github] https://github.com/medusajs/medusaMedusa's core commerce modules are open-source and freely available on npm.
  • [community] https://news.ycombinator.com/item?id=28481913The landing page looks like it's trying to sell me a product, but the Github says it's MIT licensed... is there some component that costs money down the road? No pricing page found.
  • [claimed-docs] https://medusajs.com/pricingOwn and control all your source-code, while we handle your infrastructure.
  • [claimed-docs] https://medusajs.com/pricingYou own the project, we handle the infra.

Openness = 56.2 ÷ 100 × 100 = 56.2

Built-in AI14.7/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://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdallows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdThe Medusa documentation provides a remote Model Context Protocol (MCP) server that allows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor.
  • [claimed-docs] https://medusajs.comFramework - Guardrails for agents to build customizations.

Set up automations that run autonomously in the backgroundweight 2

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

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

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

  • [claimed-docs] https://medusajs.com/pricingCloud Development Agent
  • [claimed-docs] https://medusajs.com/pricingMedusa MCP and Cloud CLI
  • [claimed-docs] https://medusajs.comFramework - Guardrails for agents to build customizations.
  • [claimed-docs] https://medusajs.comGuardrails for agents to build customizations.

Operate the product with natural-language commandsweight 2

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

  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdMedusa hosts a Streamable HTTP MCP server at `https://docs.medusajs.com/mcp` that you can add to AI agents supporting MCP server connections.
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdallows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor
  • [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.mdThe Medusa documentation provides a remote Model Context Protocol (MCP) server that allows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor.
  • [claimed-docs] https://medusajs.com/pricingCloud Development Agent
  • [claimed-docs] https://medusajs.comFramework - Guardrails for agents to build customizations.
  • [claimed-docs] https://medusajs.com/pricingMedusa MCP and Cloud CLI
  • [probe] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-serverofficial MCP server documented at https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server

Built-in AI = 13.2 ÷ 90 × 100 = 14.7

Automation11.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) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

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

Define rules that trigger actions automatically on eventsweight 3

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

  • [claimed-docs] https://medusajs.com/pricingWebhook Events
  • [claimed-docs] https://medusajs.comFramework - Guardrails for agents to build customizations.
  • [claimed-docs] https://medusajs.comGuardrails for agents to build customizations.

Schedule recurring jobs or workflowsweight 2

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

  • [claimed-docs] https://medusajs.com/pricingBackground workers
  • [github] https://github.com/medusajs/medusaMedusa is a commerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic.

Version, review, and roll back my automationsweight 1

1 (weight) × 3 (quality) × 0.6 (partial) = 1.8 of 10 max

  • [claimed-docs] https://medusajs.com/pricingDeploy from GitHub
  • [claimed-docs] https://medusajs.com/pricingOwn and control all your source-code, while we handle your infrastructure.
  • [claimed-docs] https://medusajs.com/pricingInstant previews on PRs
  • [claimed-docs] https://medusajs.com/pricingAutomatic backups
  • [claimed-docs] https://medusajs.comPush from GitHub to the fastest infrastructure.

Automation = 9.0 ÷ 80 × 100 = 11.3