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.txt“PROBE 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.md“Medusa 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.md“The 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-server“official 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=28481913“I 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/medusa“Medusa's core commerce modules are open-source and freely available on npm.”
- [probe] https://docs.medusajs.com/resources/medusa-cli“official CLI documented at https://docs.medusajs.com/resources/medusa-cli”
- [claimed-docs] https://medusajs.com/pricing“Medusa MCP and Cloud CLI”
- [claimed-docs] https://medusajs.com/pricing“Instant previews on PRs”
- [claimed-docs] https://medusajs.com/pricing“Background workers”
- [community] https://hn.algolia.com/api/v1/items/29392312“Haven'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.md“Medusa 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.md“allows 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.md“The 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-server“official MCP server documented at https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server”
- [claimed-docs] https://medusajs.com/pricing“Cloud 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.md“Medusa 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.md“allows 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.md“The 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-server“official 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-cli“official CLI documented at https://docs.medusajs.com/resources/medusa-cli”
- [claimed-docs] https://medusajs.com/pricing“Medusa 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.yaml“openapi: 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/product“Product Module - Medusa Documentation”
- [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/cart“Cart Module - Medusa Documentation”
- [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/order“Order Module - Medusa Documentation”
- [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/payment“Payment Module - Medusa Documentation”
- [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/tax“Tax Module - Medusa Documentation”
- [claimed-docs] https://docs.medusajs.com/resources/commerce-modules/fulfillment“Fulfillment Module - Medusa Documentation”
- [probe] https://docs.medusajs.com/openapi.json“PROBE 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/pricing“RBAC, 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.yaml“openapi: 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.md“Medusa 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.json“PROBE 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
- [claimed-docs] https://medusajs.com/pricing“Webhook Events”
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.yaml“openapi: 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.json“PROBE 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.yaml“openapi: 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.json“PROBE 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/pricing“Instant previews on PRs”
- [claimed-docs] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server/index.html.md“Medusa 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.yaml“openapi: 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.json“PROBE 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.yaml“openapi: 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/medusa“Medusa 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.com“Admin - 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/medusa“Medusa's core commerce modules are open-source and freely available on npm.”
- [claimed-docs] https://medusajs.com/pricing“Own and control all your source-code, while we handle your infrastructure.”
- [claimed-docs] https://medusajs.com/pricing“You own the project, we handle the infra.”
- [claimed-docs] https://medusajs.com/pricing“You 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.yaml“openapi: 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/medusa“Medusa 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/medusa“Medusa's core commerce modules are open-source and freely available on npm.”
- [community] https://news.ycombinator.com/item?id=28481913“The 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/41979332“Listed 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/medusa“Medusa 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/medusa“Medusa's core commerce modules are open-source and freely available on npm.”
- [community] https://news.ycombinator.com/item?id=28481913“The 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/pricing“Own and control all your source-code, while we handle your infrastructure.”
- [claimed-docs] https://medusajs.com/pricing“You 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.md“Medusa 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.md“allows 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.md“The 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“Framework - 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
- [claimed-docs] https://medusajs.com/pricing“Background workers”
- [claimed-docs] https://medusajs.com/pricing“Webhook Events”
- [claimed-docs] https://medusajs.com/pricing“Cloud Development Agent”
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/pricing“Cloud Development Agent”
- [claimed-docs] https://medusajs.com/pricing“Medusa MCP and Cloud CLI”
- [claimed-docs] https://medusajs.com“Framework - Guardrails for agents to build customizations.”
- [claimed-docs] https://medusajs.com“Guardrails 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.md“Medusa 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.md“allows 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.md“The 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/pricing“Cloud Development Agent”
- [claimed-docs] https://medusajs.com“Framework - Guardrails for agents to build customizations.”
- [claimed-docs] https://medusajs.com/pricing“Medusa MCP and Cloud CLI”
- [probe] https://docs.medusajs.com/learn/introduction/build-with-llms-ai/mcp-server“official 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/pricing“Webhook Events”
- [claimed-docs] https://medusajs.com“Framework - Guardrails for agents to build customizations.”
- [claimed-docs] https://medusajs.com“Guardrails 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/pricing“Background workers”
- [github] https://github.com/medusajs/medusa“Medusa 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/pricing“Deploy from GitHub”
- [claimed-docs] https://medusajs.com/pricing“Own and control all your source-code, while we handle your infrastructure.”
- [claimed-docs] https://medusajs.com/pricing“Instant previews on PRs”
- [claimed-docs] https://medusajs.com/pricing“Automatic backups”
- [claimed-docs] https://medusajs.com“Push from GitHub to the fastest infrastructure.”
Automation = 9.0 ÷ 80 × 100 = 11.3