Medusa

TypeScript commerce modules configured in medusa-config.ts, with complete Admin and Store REST APIs.

AdaptableOperable Business appWeb app Deterministic TypeScript API License: MIT (Enterprise Edition materials under ENTERPRISE-LICENSE.md)

Node.js commerce platform whose core modules (cart, order, product, pricing, inventory, and more) are MIT and swapped by configuration. Admin and Store REST APIs with a JS SDK cover the whole surface. The Builder publishes medusa-agent-skills (Claude Code plugins with a docs MCP) for building on it; Medusa Cloud and Enterprise Edition are paid.

Use it when

I am building a DTC or B2B backend in TypeScript and want commerce primitives I can compose rather than a monolith
my agent should run the store through a documented REST API and learn the framework from the Builder's own skills

Gotchas

No storefront in the core; the Next.js starter is a separate repo
GitHub shows NOASSERTION because Enterprise Edition materials carry a separate license inside the repo
The agent-skills MCP reads documentation only; it does not operate a store

Last activity Sep 2, 2026. Fit: adaptable 3, operable 3.

Editions

Open source · Free open source

Clonegit clone https://github.com/medusajs/medusa

Medusa Cloud · Free closed source

HostedOpen the hosted app

Enterprise Edition · Free closed source

No distribution recorded.

For agents: JSON · Markdown

Adaptable: what is yours to change

Make it yours

Light edit18 things to edit

create-medusa-app scaffolds a project; medusa-config.ts (projectConfig, admin, modules, plugins, featureFlags) reads .env for DATABASE_URL, CORS origins, secrets, and Redis. Modules are swapped by config; custom behavior is a module, workflow, or API route in src/. The storefront is a separate Next.js starter. The Builder's medusa-dev skills exist for exactly these edits.

Env vars: DATABASE_URL DATABASE_NAME REDIS_URL JWT_SECRET COOKIE_SECRET STORE_CORS ADMIN_CORS AUTH_CORS MEDUSA_BACKEND_URL PORT HOST LOG_LEVEL WORKER_MODE MEDUSA_DISABLE_TELEMETRY ADMIN_AUTH_TYPE
Config files: medusa-config.ts .env
Prompt files: medusa-agent-skills plugins (medusa-dev, ecommerce-storefront, medusa-cloud)
Accounts you need: Medusa Cloud (hosted edition only)

Source

github.com/medusajs/medusa
MIT (Enterprise Edition materials under ENTERPRISE-LICENSE.md) license
Last commit Sep 2, 2026
36,110 stars

Also: medusajs/medusa-agent-skills

Operable: what an agent can drive

Interface

OfficialAPIpublished by the builderlocal

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs: docs.medusajs.com/api/admin

Reach

Complete coverage. 9 of 9 jobs reachable through the stated interface.

Job	Through the interface	Evidence
Manage products, variants, categories	Reachable	Admin API /admin/products, /admin/product-categories
Manage orders, fulfilments, returns	Reachable	Admin API /admin/orders, /admin/fulfillments, /admin/returns
Manage customers and groups	Reachable	Admin API /admin/customers
Pricing, price lists, promotions	Reachable	Admin API /admin/price-lists, /admin/promotions
Inventory and stock locations	Reachable	Admin API /admin/inventory-items, /admin/stock-locations
Regions, sales channels, shipping options	Reachable	Admin API /admin/regions, /admin/sales-channels, /admin/shipping-options
Storefront cart and checkout	Reachable	Store API /store/carts, payment collections
Build customisations with an agent	Reachable	medusa-agent-skills medusa-dev plugin; MCP server queries public docs only
Manage Medusa Cloud resources	Reachable	medusa-cloud plugin wraps the mcloud CLI (paid edition)

Code stack

Languages: TypeScript
Frameworks: Node.jsExpressMikroORMReact (admin)
Package manager: yarn
Database: PostgreSQLRedis
Hosting target: DockerMedusa CloudRailway/Render
Built: Human-written (recorded, never ranked)

Skills

Medusa publishes a Claude Code plugin marketplace teaching an Adopter's agent storefront best practices and how to build on Medusa; the core repo separately carries contributor-only skills under .claude/skills/.

Kind: bundled
Paths: plugins/ecommerce-storefront/skills/storefront-best-practices/SKILL.md plugins/learn-medusa/skills/learning-medusa/SKILL.md
Install: /plugin marketplace add medusajs/medusa-agent-skills

Evidence and confidence

Field	Where it was seen	Confidence
formFactor	docs: Node.js server with admin dashboard; storefront separate	90%
executionModel	no model at runtime	95%
operability	docs.medusajs.com publishes Admin and Store API references; medusa-agent-skills under the medusajs org	90%
effort	docs environment-variables page names 18 vars; medusa-config reference documents five sections	80%
editions	LICENSE: MIT except Enterprise Edition; README: Medusa Cloud	70%
active	pushedAt 2026-09-02	–
reach		85%

Open questions

Medusa Cloud pricing
medusa-agent-skills last commit date

Sources

github.com/medusajs/medusa sourcing:ecommerce:community
github.com/medusajs/medusa-agent-skills sourcing:ecommerce:community
docs.medusajs.com/resources/references/medusa-config analysis