Install
npx create-medusa-app@latestShowcase


Try itExperimental
See what an agent can do with Medusa before you ever sign up. Pick a story: recorded sessions replay real probe-harness transcripts; sandboxed self-drive sessions are designed and gated (docs/TRY-IT.md).
$curl -si -X POST https://docs.medusajs.com/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'recorded session — replayed, not liveVerified integrations
No integration evidence found in our corpus for this product yet — that means none was found, never that it doesn’t integrate.
By theme — the product's score on each story themeBy theme
Agenticness — how well agents can access and operate the productAgenticnessevidence →
How well agents can access and operate the product
Ai commerce — stories about ai commerce in this arenaAi commerceevidence →
Stories about ai commerce in this arena
Automation depth — how much of the product can run unattendedAutomation depthevidence →
How much of the product can run unattended
B2b wholesale — stories about b2b wholesale in this arenaB2b wholesaleevidence →
Stories about b2b wholesale in this arena
Catalog inventory — stories about catalog inventory in this arenaCatalog inventoryevidence →
Stories about catalog inventory in this arena
Checkout conversion — stories about checkout conversion in this arenaCheckout conversionevidence →
Stories about checkout conversion in this arena
Extensibility apps — stories about extensibility apps in this arenaExtensibility appsevidence →
Stories about extensibility apps in this arena
Headless apis — stories about headless apis in this arenaHeadless apisevidence →
Stories about headless apis in this arena
Multi channel — stories about multi channel in this arenaMulti channelevidence →
Stories about multi channel in this arena
Openness — open source, data portability, and self-hosting storiesOpennessevidence →
Open source, data portability, and self-hosting stories
Payments — stories about payments in this arenaPaymentsevidence →
Stories about payments in this arena
Privacy posture — data-handling and privacy storiesPrivacy postureevidence →
Data-handling and privacy stories
Storefront experience — stories about storefront experience in this arenaStorefront experienceevidence →
Stories about storefront experience in this arena
Taxes shipping — stories about taxes shipping in this arenaTaxes shippingevidence →
Stories about taxes shipping in this arena
Story verdicts — every judged story with its evidenceStory verdicts
What’s free: 5 free · 0 paid · 1 enterprise · 28 not stated in evidence
Follow the green: where the map greys out is where Medusa stops today. ✓ full · ~ partial · ! disputed · — none · n/a not applicable.
Agenticness — how well agents can access and operate the productAgenticness
How well agents can access and operate the product
API surface
Drive the product through a documented public API
✓8/10
unlocks → Official SDKs · Scoped API keys · Versioning policy · API sandbox · Extend my store from a marketplace of vetted apps and extensions covering the long tail of features
Subscribe to events via webhooks
~3/10
Build against official SDKs
—0/10
Issue scoped/least-privilege API credentials for an agent
—0/10
Connect an agent via an official MCP server
✓8/10
Download a machine-readable API spec (OpenAPI or equivalent)
~7/10
unlocks → Official SDKs
Rely on versioned APIs with a documented deprecation policy
—0/10
Test against a sandbox environment without touching production data
—0/10
Explore an interactive API reference with runnable examples
~5/10
Docs for agents
Point an agent at llms.txt or agent-oriented docs
✓9/10
Agentic features
Delegate tasks to a built-in AI assistant inside the product
~2/10
unlocks → MCP client · AI insights
Operate the product with natural-language commands
~4/10
Plug MCP servers into this product so it can use their tools
—0/10
Get AI-generated insights and suggestions from my data inside the product
—0/10
Set up automations that run autonomously in the background
~4/10
Ai commerce — stories about ai commerce in this arenaAi commerce
Stories about ai commerce in this arena
My products are discoverable by AI agents and answer engines through a cross-merchant catalog or feed built for agents
—0/10
An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the admin
~5/10
A shopping agent can discover my store's products and build carts through a documented agent-commerce endpoint on the store (MCP/UCP), not by scraping
—0/10
Automation depth — how much of the product can run unattendedAutomation depth
How much of the product can run unattended
B2b wholesale — stories about b2b wholesale in this arenaB2b wholesale
Stories about b2b wholesale in this arena
Catalog inventory — stories about catalog inventory in this arenaCatalog inventory
Stories about catalog inventory in this arena
Model products with variants, options, and custom fields/metafields that fit my catalog, not a fixed template
~5/10
Bulk import, export, and edit the catalog — CSV or API — without touching products one at a time
~4/10
Inventory tracks across multiple locations with stock adjustments and fulfillment from the right warehouse
~7/10
Checkout conversion — stories about checkout conversion in this arenaCheckout conversion
Stories about checkout conversion in this arena
Extensibility apps — stories about extensibility apps in this arenaExtensibility apps
Stories about extensibility apps in this arena
Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution path
~6/10
Extend my store from a marketplace of vetted apps and extensions covering the long tail of features
—–
Inject custom backend logic — discounts, shipping rules, validation — as serverless functions or hooks that run inside the platform
~5/10
Headless apis — stories about headless apis in this arenaHeadless apis
Stories about headless apis in this arena
Multi channel — stories about multi channel in this arenaMulti channel
Stories about multi channel in this arena
List and sync products to external channels — marketplaces, social commerce, shopping feeds — from one catalog
~3/10
Sell internationally with localized storefronts, multi-currency pricing, translations, and duties handled
!4/10
Sell in person with a point-of-sale that shares the same catalog, inventory, and customers as my online store
—0/10
Openness — open source, data portability, and self-hosting storiesOpenness
Open source, data portability, and self-hosting stories
Payments — stories about payments in this arenaPayments
Stories about payments in this arena
Privacy posture — data-handling and privacy storiesPrivacy posture
Data-handling and privacy stories
Storefront experience — stories about storefront experience in this arenaStorefront experience
Stories about storefront experience in this arena
Manage content — pages, blogs, media — alongside my products from the same admin
—0/10
Customize storefront code with a documented templating layer, local preview, and version-controlled theme deploys
~4/10
Launch a polished storefront from professionally designed themes and customize layout, sections, and branding without code
—0/10
Taxes shipping — stories about taxes shipping in this arenaTaxes shipping
Stories about taxes shipping in this arena
Sorted by importance (agentic first) (high → low) · 54/54 stories · click a row’s chevron for the rationale and evidence
Connect an agent via an official MCP server G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | full | 8/10 | Tprobed | |
Drive the product through a documented public API G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | full | 8/10 | Tprobed | |
Delegate tasks to a built-in AI assistant inside the product G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | partial | 2/10 | Cclaimed | |
Plug MCP servers into this product so it can use their tools G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 3 | none | 0/10 | ||
Point an agent at llms.txt or agent-oriented docs G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 9/10 | Tprobed | |
Download a machine-readable API spec (OpenAPI or equivalent) G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 7/10 | Tprobed | |
Run the product headlessly / in CI for automation G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 6/10 | Tprobed | |
Use an official CLI G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | full | 6/10 | Tprobed | |
Explore an interactive API reference with runnable examples G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 5/10 | Tprobed | |
Operate the product with natural-language commands G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 4/10 | Tprobed | |
Set up automations that run autonomously in the background G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 4/10 | Cclaimed | |
Subscribe to events via webhooks G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | partial | 3/10 | Cclaimed | |
Build against official SDKs G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Get AI-generated insights and suggestions from my data inside the product G Agentic features | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Issue scoped/least-privilege API credentials for an agent G Agent access | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Rely on versioned APIs with a documented deprecation policy G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 2 | none | 0/10 | ||
Test against a sandbox environment without touching production data G Api quality | ai-native user | Agenticness — how well agents can access and operate the productAgenticness | 1 | none | 0/10 | ||
Build a fully custom headless storefront on a documented storefront API or first-party frontend framework C Headless | developer | Headless apis — stories about headless apis in this arenaHeadless apis | 3 | full | 9/10 | Xcommunity | |
Self-host the core product G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 3 | fullfree | 8/10 | Xcommunity | |
Manage the full commerce lifecycle programmatically — create products, edit orders, issue refunds, trigger fulfillments — through the admin API C Admin api | developer | Headless apis — stories about headless apis in this arenaHeadless apis | 3 | full | 7/10 | Tprobed | |
Customize checkout — fields, branding, discounts, and validation logic — through supported extension points rather than forking checkout C Checkout | developer | Checkout conversion — stories about checkout conversion in this arenaCheckout conversion | 3 | partial | 5/10 | Cclaimed | |
Export all of my data in open formats and leave G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 3 | partialfree | 5/10 | Cclaimed | |
Model products with variants, options, and custom fields/metafields that fit my catalog, not a fixed template C Catalog | merchant | Catalog inventory — stories about catalog inventory in this arenaCatalog inventory | 3 | partialfree | 5/10 | Xcommunity | |
Define rules that trigger actions automatically on events G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 3 | partial | 4/10 | Cclaimed | |
A shopping agent can discover my store's products and build carts through a documented agent-commerce endpoint on the store (MCP/UCP), not by scraping C Agentic checkout | ai-native user | Ai commerce — stories about ai commerce in this arenaAi commerce | 3 | none | 0/10 | ||
Launch a polished storefront from professionally designed themes and customize layout, sections, and branding without code C Themes | merchant | Storefront experience — stories about storefront experience in this arenaStorefront experience | 3 | none | 0/10 | ||
Take payments with the platform's integrated processing — published card rates, payouts, and fraud tooling — without wiring a third-party gateway C Processing | merchant | Payments — stories about payments in this arenaPayments | 3 | none | 0/10 | ||
Extend my store from a marketplace of vetted apps and extensions covering the long tail of features C Apps | merchant | Extensibility apps — stories about extensibility apps in this arenaExtensibility apps | 3 | none | untested | none yet | |
Prevent my data from being used to train AI models G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 3 | n/a | untested | none yet | |
Read the product's source under an open license G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 2 | fullfree | 8/10 | Xcommunity | |
Inventory tracks across multiple locations with stock adjustments and fulfillment from the right warehouse C Inventory | operations lead | Catalog inventory — stories about catalog inventory in this arenaCatalog inventory | 2 | partial | 7/10 | Xcommunity | |
Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution path G App dev | developer | Extensibility apps — stories about extensibility apps in this arenaExtensibility apps | 2 | partialfree | 6/10 | Tprobed | |
Do everything through the API that I can do in the UI G | ai-native user | Openness — open source, data portability, and self-hosting storiesOpenness | 2 | partial | 6/10 | Cclaimed | |
An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the admin C Agent ops | ai-native user | Ai commerce — stories about ai commerce in this arenaAi commerce | 2 | partial | 5/10 | Xcommunity | |
Choose where my data is stored (region/residency) G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | partialenterprise | 5/10 | Cclaimed | |
Inject custom backend logic — discounts, shipping rules, validation — as serverless functions or hooks that run inside the platform C Functions | developer | Extensibility apps — stories about extensibility apps in this arenaExtensibility apps | 2 | partial | 5/10 | Cclaimed | |
Bulk import, export, and edit the catalog — CSV or API — without touching products one at a time C Catalog ops | operations lead | Catalog inventory — stories about catalog inventory in this arenaCatalog inventory | 2 | partial | 4/10 | Cclaimed | |
Customize storefront code with a documented templating layer, local preview, and version-controlled theme deploys C Theme dev | developer | Storefront experience — stories about storefront experience in this arenaStorefront experience | 2 | partial | 4/10 | Xcommunity | |
Sell B2B and wholesale — customer-specific price lists, volume pricing, quotes or net-terms invoicing — alongside DTC G B2b | merchant | B2b wholesale — stories about b2b wholesale in this arenaB2b wholesale | 2 | partial | 4/10 | Cclaimed | |
Sell internationally with localized storefronts, multi-currency pricing, translations, and duties handled G Global | merchant | Multi channel — stories about multi channel in this arenaMulti channel | 2 | disputed | 4/10 | Dcontradicted | |
Choose among third-party payment gateways and charge in multiple currencies when the built-in option doesn't fit C Processing | merchant | Payments — stories about payments in this arenaPayments | 2 | partial | 3/10 | Cclaimed | |
Control data retention and deletion G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | partial | 3/10 | Cclaimed | |
List and sync products to external channels — marketplaces, social commerce, shopping feeds — from one catalog C Channels | merchant | Multi channel — stories about multi channel in this arenaMulti channel | 2 | partial | 3/10 | Cclaimed | |
Sales tax and VAT are calculated automatically per jurisdiction, with rates kept current and reports I can file from C Taxes | merchant | Taxes shipping — stories about taxes shipping in this arenaTaxes shipping | 2 | partial | 3/10 | Cclaimed | |
Buyers can pay with accelerated wallets — Apple Pay, Google Pay, PayPal, platform one-click — without re-entering details C Checkout | merchant | Checkout conversion — stories about checkout conversion in this arenaCheckout conversion | 2 | none | 0/10 | ||
Checkout shows live carrier rates and I can buy labels and track shipments from the platform C Shipping | operations lead | Taxes shipping — stories about taxes shipping in this arenaTaxes shipping | 2 | none | 0/10 | ||
My products are discoverable by AI agents and answer engines through a cross-merchant catalog or feed built for agents C Agent discovery | ai-native user | Ai commerce — stories about ai commerce in this arenaAi commerce | 2 | none | 0/10 | ||
Schedule recurring jobs or workflows G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 2 | none | 0/10 | ||
Sell in person with a point-of-sale that shares the same catalog, inventory, and customers as my online store C Pos | merchant | Multi channel — stories about multi channel in this arenaMulti channel | 2 | none | 0/10 | ||
Opt out of telemetry and usage tracking G | ai-native user | Privacy posture — data-handling and privacy storiesPrivacy posture | 2 | none | untested | none yet | |
Perform bulk operations across many items at once G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 2 | none | untested | none yet | |
Version, review, and roll back my automations G | ai-native user | Automation depth — how much of the product can run unattendedAutomation depth | 1 | partial | 3/10 | Cclaimed | |
Abandoned carts and checkouts trigger recovery emails or links so I can win the sale back C Conversion | merchant | Checkout conversion — stories about checkout conversion in this arenaCheckout conversion | 1 | none | 0/10 | ||
Manage content — pages, blogs, media — alongside my products from the same admin C Content | merchant | Storefront experience — stories about storefront experience in this arenaStorefront experience | 1 | none | 0/10 |
Opportunities — the stories that would move this product's scores, from its own judged verdictsOpportunitiestop 8 of 44 stories with headroom
What would move Medusa’s scores — derived from its own judged verdicts, biggest headroom first. Each line quotes what the judge found missing; shipping it (or evidencing it publicly) is the fix.
Agenticness — how well agents can access and operate the productPlug MCP servers into this product so it can use their tools
nonemoves agent-readyimpact 45
The evidence only shows Medusa hosting an MCP server (docs.medusajs.com/mcp) that external AI tools like Cursor can connect to for documentation lookup — this is Medusa acting as an MCP server provider, not evidence that Medusa itself can consume/plug in external MCP servers to use their tools.
Agenticness — how well agents can access and operate the productDelegate tasks to a built-in AI assistant inside the product
partialq2/10moves Built-in AIimpact 36
Missing: documentation/screenshots of the Cloud Development Agent's actual task-delegation workflow, independent/hands-on confirmation it exists and works, and clarity on how it differs from the developer-facing MCP/CLI tooling.
Ai commerce — stories about ai commerce in this arenaA shopping agent can discover my store's products and build carts through a documented agent-commerce endpoint on the store (MCP/UCP), not by scraping
nonemoves PA Scoreimpact 30
Medusa's documented MCP server (medusa-docs-4/33/37, probe-3) is scoped to searching Medusa's documentation for IDEs/AI coding tools, not a storefront-facing agent-commerce endpoint for product discovery or cart building; the Store REST/OpenAPI (medusa-gh-x1) exists but is a generic commerce API, not a documented MCP/UCP agent-commerce interface.
Extensibility apps — stories about extensibility apps in this arenaExtend my store from a marketplace of vetted apps and extensions covering the long tail of features
nonemoves PA Scoreimpact 30
Medusa's evidence covers its open-source core modules, framework, and integrations documentation, but there is no mention of a curated or vetted marketplace/app store of third-party extensions comparable to Shopify's App Store.
Payments — stories about payments in this arenaTake payments with the platform's integrated processing — published card rates, payouts, and fraud tooling — without wiring a third-party gateway
nonemoves PA Scoreimpact 30
Medusa's Payment Module (medusa-docs-24) is documented as an integration layer for third-party payment providers (e.g., Stripe, PayPal), not a first-party processor with its own published card rates, payouts, or fraud tooling.
Storefront experience — stories about storefront experience in this arenaLaunch a polished storefront from professionally designed themes and customize layout, sections, and branding without code
nonemoves PA Scoreimpact 30
Medusa is explicitly a headless, developer-first commerce platform — its storefront resources are 'Storefront Development Guides' requiring coding (medusa-docs-5), not a no-code theme/section editor.
Agenticness — how well agents can access and operate the productGet AI-generated insights and suggestions from my data inside the product
nonemoves Built-in AIimpact 30
Missing: any feature generating insights/recommendations from store data, admin dashboard AI analytics, or product evidence of in-app AI suggestions.
Agenticness — how well agents can access and operate the productIssue scoped/least-privilege API credentials for an agent
nonemoves agent-readyimpact 30
Evidence shows only generic RBAC/SSO/Audit Logs mentions in pricing tiers, with no documentation of issuing scoped or least-privilege API credentials specifically for AI agents, nor any agent-specific token/key scoping mechanism.
Showing the top 8 of 44 — every none/partial verdict in the story verdicts table is headroom.
Think a verdict is wrong? Every verdicts-table row has a Flag link — see the methodology.
Coverage map — which docs area, API section, or community source covers which judged storiesCoverage map9 surfaces · 34 covered stories
Where the cited evidence behind each covered verdict came from — the same citations the verdicts table shows, no extra judging.
GitHub README19 stories
- Run the product headlessly / in CI for automation
- Drive the product through a documented public API
- Explore an interactive API reference with runnable examples
- Download a machine-readable API spec (OpenAPI or equivalent)
- An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the admin
- Sell B2B and wholesale — customer-specific price lists, volume pricing, quotes or net-terms invoicing — alongside DTC
- Model products with variants, options, and custom fields/metafields that fit my catalog, not a fixed template
- Bulk import, export, and edit the catalog — CSV or API — without touching products one at a time
- Customize checkout — fields, branding, discounts, and validation logic — through supported extension points rather than forking checkout
- Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution path
- Inject custom backend logic — discounts, shipping rules, validation — as serverless functions or hooks that run inside the platform
- Manage the full commerce lifecycle programmatically — create products, edit orders, issue refunds, trigger fulfillments — through the admin API
- Build a fully custom headless storefront on a documented storefront API or first-party frontend framework
- List and sync products to external channels — marketplaces, social commerce, shopping feeds — from one catalog
- Do everything through the API that I can do in the UI
- Export all of my data in open formats and leave
- Read the product's source under an open license
- Self-host the core product
- Choose where my data is stored (region/residency)
Resources docs18 stories
- Run the product headlessly / in CI for automation
- Use an official CLI
- Drive the product through a documented public API
- An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the admin
- Sell B2B and wholesale — customer-specific price lists, volume pricing, quotes or net-terms invoicing — alongside DTC
- Model products with variants, options, and custom fields/metafields that fit my catalog, not a fixed template
- Bulk import, export, and edit the catalog — CSV or API — without touching products one at a time
- Inventory tracks across multiple locations with stock adjustments and fulfillment from the right warehouse
- Customize checkout — fields, branding, discounts, and validation logic — through supported extension points rather than forking checkout
- Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution path
- Inject custom backend logic — discounts, shipping rules, validation — as serverless functions or hooks that run inside the platform
- Manage the full commerce lifecycle programmatically — create products, edit orders, issue refunds, trigger fulfillments — through the admin API
- Build a fully custom headless storefront on a documented storefront API or first-party frontend framework
- List and sync products to external channels — marketplaces, social commerce, shopping feeds — from one catalog
- Sell internationally with localized storefronts, multi-currency pricing, translations, and duties handled
- Choose among third-party payment gateways and charge in multiple currencies when the built-in option doesn't fit
- Customize storefront code with a documented templating layer, local preview, and version-controlled theme deploys
- Sales tax and VAT are calculated automatically per jurisdiction, with rates kept current and reports I can file from
Pricing docs14 stories
- Run the product headlessly / in CI for automation
- Use an official CLI
- Subscribe to events via webhooks
- Set up automations that run autonomously in the background
- Delegate tasks to a built-in AI assistant inside the product
- Operate the product with natural-language commands
- An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the admin
- Define rules that trigger actions automatically on events
- Version, review, and roll back my automations
- Export all of my data in open formats and leave
- Self-host the core product
- Choose where my data is stored (region/residency)
- Control data retention and deletion
- Customize storefront code with a documented templating layer, local preview, and version-controlled theme deploys
Hacker News10 stories
- Run the product headlessly / in CI for automation
- An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the admin
- Model products with variants, options, and custom fields/metafields that fit my catalog, not a fixed template
- Inventory tracks across multiple locations with stock adjustments and fulfillment from the right warehouse
- Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution path
- Build a fully custom headless storefront on a documented storefront API or first-party frontend framework
- Sell internationally with localized storefronts, multi-currency pricing, translations, and duties handled
- Read the product's source under an open license
- Self-host the core product
- Customize storefront code with a documented templating layer, local preview, and version-controlled theme deploys
medusajs.com10 stories
- Delegate tasks to a built-in AI assistant inside the product
- Operate the product with natural-language commands
- Define rules that trigger actions automatically on events
- Version, review, and roll back my automations
- Bulk import, export, and edit the catalog — CSV or API — without touching products one at a time
- Customize checkout — fields, branding, discounts, and validation logic — through supported extension points rather than forking checkout
- Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution path
- Inject custom backend logic — discounts, shipping rules, validation — as serverless functions or hooks that run inside the platform
- Do everything through the API that I can do in the UI
- Customize storefront code with a documented templating layer, local preview, and version-controlled theme deploys
OpenAPI spec4 stories
- Drive the product through a documented public API
- Explore an interactive API reference with runnable examples
- Download a machine-readable API spec (OpenAPI or equivalent)
- Manage the full commerce lifecycle programmatically — create products, edit orders, issue refunds, trigger fulfillments — through the admin API
Learn docs3 stories
Probe proofs — replayable recordings from the probe harnessProbe proofs
Replayable recordings from our probe harness — see the Prove-It protocol to submit one.
$curl -si -X POST https://docs.medusajs.com/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>'reproduced$ curl -si -X POST https://docs.medusajs.com/mcp -H 'Content-Type: application/json' -d '<jsonrpc initialize>' HTTP/2 401 date: Tue, 08 Sep 2026 19:59:40 GMT cf-ray: a38088f05853fc53-SJC cf-cache-status: DYNAMIC server: cloudflare www-authenticate: Bearer realm="medusa", resource_metadata="https://docs.medusajs.com/.well-known/oauth-protected-resource" x-hikari-trace: lax1.sx7j x-railway-edge: lax1 x-railway-request-id: rEAIjUg_QsW5kTm0wUFZXw
$mktemp -d && npm install @medusajs/js-sdk && node -e "import('@medusajs/js-sdk').then(m=>console.log('PA_PROBE_OK medusa js-sdk export:', typeof m.default))"reproduced$ mktemp -d && npm install @medusajs/js-sdk && node -e "import('@medusajs/js-sdk').then(m=>console.log('PA_PROBE_OK medusa js-sdk export:', typeof m.default))"
added 21 packages in 199ms
PA_PROBE_OK medusa js-sdk export: function
Claims vs evidence — vendor claims reconciled against independent verdictsClaims vs evidence
12 of 23 testable claims verified · 3 contradicted → integrity 26/100
36 distinct capability claims found in Medusa’s own claimed-docs/GitHub materials, reconciled against our judge’s independent verdicts.
12
Verified
8
Unverified
3
Contradicted
13
Undersold
Verified (14)
“Hosts an official MCP server for docs so AI agents can connect via MCP”
“Lets IDEs/AI tools like Cursor pull Medusa documentation directly for agent use”
Point an agent at llms.txt or agent-oriented docsfullproof ↗
“Provides a Cloud CLI for managing Medusa Cloud projects”
“Framework provides guardrails so AI agents can safely build customizations”
Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution pathpartialproof ↗
“Core commerce modules are open-source and published free on npm”
“Built-in customization framework lets developers build commerce apps without rebuilding core logic”
Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution pathpartialproof ↗
“Dedicated Product Module for modeling products, variants, and options”
Model products with variants, options, and custom fields/metafields that fit my catalog, not a fixed templatepartialproof ↗
“Cart Module underpins a documented storefront API for building headless storefronts”
Build a fully custom headless storefront on a documented storefront API or first-party frontend frameworkfullproof ↗
“Order Module lets developers manage orders programmatically (create, edit, refund, fulfill)”
Manage the full commerce lifecycle programmatically — create products, edit orders, issue refunds, trigger fulfillments — through the admin APIfullproof ↗
“Inventory Module tracks stock across multiple locations and fulfillment sources”
Inventory tracks across multiple locations with stock adjustments and fulfillment from the right warehousepartialproof ↗
“Enterprise License allows bring-your-own-cloud (self-hosted) deployment”
“Admin Injection Zones let developers inject custom UI/logic into the admin dashboard”
Build custom apps and extensions with official SDKs, scaffolding tooling, and a documented review/distribution pathpartialproof ↗
“Publishes a machine-readable OpenAPI 3.0 spec covering Store and Admin REST APIs”
Download a machine-readable API spec (OpenAPI or equivalent)partialproof ↗
“Provides an interactive API reference (docs.medusajs.com/api) generated from the OpenAPI spec”
Explore an interactive API reference with runnable examplespartialproof ↗
Unverified (9)
“Emits webhook events that external systems can subscribe to”
“Offers a built-in 'Cloud Development Agent' to assist with dev tasks”
Delegate tasks to a built-in AI assistant inside the productpartialproof ↗
“Framework and modules support advanced B2B commerce stores alongside DTC”
Sell B2B and wholesale — customer-specific price lists, volume pricing, quotes or net-terms invoicing — alongside DTCpartialproof ↗
“Framework and modules support marketplace and distributor platform builds”
List and sync products to external channels — marketplaces, social commerce, shopping feeds — from one catalogpartialproof ↗
“Payment Module supports pluggable third-party payment providers and currencies”
Choose among third-party payment gateways and charge in multiple currencies when the built-in option doesn't fitpartialproof ↗
“Tax Module automates sales tax/VAT calculation”
Sales tax and VAT are calculated automatically per jurisdiction, with rates kept current and reports I can file frompartialproof ↗
“Sales Channel Module lets merchants manage and sync products across multiple sales channels”
List and sync products to external channels — marketplaces, social commerce, shopping feeds — from one catalogpartialproof ↗
“Cloud offering provides data sovereignty, SOC2 compliance, and custom DPAs”
Choose where my data is stored (region/residency)partialproof ↗
“Commerce workflows can be extended, customized, and owned as custom backend logic”
Inject custom backend logic — discounts, shipping rules, validation — as serverless functions or hooks that run inside the platformpartialproof ↗
Contradicted (3)
“Framework and modules support building point-of-sale systems”
Sell in person with a point-of-sale that shares the same catalog, inventory, and customers as my online storenoneproof ↗
“Fulfillment Module handles shipping and fulfillment logic”
Checkout shows live carrier rates and I can buy labels and track shipments from the platformnoneproof ↗
“Supports background workers for running async/scheduled jobs”
Undersold (13)
Run the product headlessly / in CI for automationpartialproof ↗
Drive the product through a documented public APIfullproof ↗
Set up automations that run autonomously in the backgroundpartialproof ↗
Operate the product with natural-language commandspartialproof ↗
An agent can take an order through its post-purchase lifecycle — status, fulfillment, returns — via documented APIs and webhooks without a human in the adminpartialproof ↗
Define rules that trigger actions automatically on eventspartialproof ↗
Bulk import, export, and edit the catalog — CSV or API — without touching products one at a timepartialproof ↗
Customize checkout — fields, branding, discounts, and validation logic — through supported extension points rather than forking checkoutpartialproof ↗
Do everything through the API that I can do in the UIpartialproof ↗
Export all of my data in open formats and leavepartialproof ↗
Customize storefront code with a documented templating layer, local preview, and version-controlled theme deployspartialproof ↗
Claims outside our story set (10)
Real capability claims found in Medusa’s own materials, but no story in this arena’s taxonomy covers them yet — that’s feedback on the taxonomy, not a mark against the product.
“Cloud deploys directly from GitHub pushes to hosted infrastructure”
source ↗“Cloud offering lets you keep full ownership/control of source code while it manages infrastructure”
source ↗“Offers RBAC, SSO, and audit logs for enterprise access control”
source ↗“Admin dashboard is customizable for merchant needs”
source ↗“Cloud provides instant preview environments for pull requests”
source ↗“Cloud infrastructure autoscales automatically”
source ↗“Cloud performs automatic backups of project data”
source ↗“Cloud supports custom domains for storefronts”
source ↗“Cloud provides combined storefront and backend hosting”
source ↗“Provides a 'Medusa UI' component library for building interfaces”
source ↗
Business model
MIT-licensed open-source platform, free to self-host; Medusa Cloud hosting is Develop from $29/month, Launch from $99, Scale from $299 (no GMV tax), with a custom-priced Enterprise license.
pricing ↗Score trend
How this product’s scores have moved as evidence and verdicts are re-derived — a point per change, not per day.
Try Experimental
Run it in the microterminal →Recorded agent sessions — and a live MCP handshake where the vendor ships one.
Flag
⚑ Flag a verdictThink a verdict is wrong? Opens a prefilled GitHub issue — or use the ⚑ next to any verdict above.
For agents
Agent surface uptime MCP up · llms.txt up (tracking since Sep 10 '26)
