{
  "version": "2",
  "generatedAt": "2026-11-03T22:49:39.280Z",
  "listing": {
    "slug": "medusajs--medusa",
    "name": "Medusa",
    "tagline": "TypeScript commerce modules configured in medusa-config.ts, with complete Admin and Store REST APIs.",
    "shortTagline": "TypeScript commerce modules",
    "description": "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.",
    "capabilities": [
      "adaptable",
      "operable"
    ],
    "vertical": "ecommerce",
    "alternativeTo": [
      "Shopify",
      "Adobe Commerce"
    ],
    "shape": "business-app",
    "formFactor": "web-app",
    "executionModel": "deterministic",
    "provenance": "human-written",
    "codeStack": {
      "languages": [
        "TypeScript"
      ],
      "frameworks": [
        "Node.js",
        "Express",
        "MikroORM",
        "React (admin)"
      ],
      "packageManager": "yarn",
      "database": [
        "PostgreSQL",
        "Redis"
      ],
      "hostingTarget": [
        "Docker",
        "Medusa Cloud",
        "Railway/Render"
      ]
    },
    "modelStack": null,
    "repos": [
      {
        "url": "https://github.com/medusajs/medusa",
        "owner": "medusajs",
        "name": "medusa",
        "license": "MIT (Enterprise Edition materials under ENTERPRISE-LICENSE.md)",
        "stars": 36110,
        "lastCommit": "2026-09-02"
      },
      {
        "url": "https://github.com/medusajs/medusa-agent-skills",
        "owner": "medusajs",
        "name": "medusa-agent-skills",
        "license": "MIT",
        "stars": 212,
        "lastCommit": null
      }
    ],
    "interface": {
      "kind": "api",
      "url": "https://docs.medusajs.com/api/admin",
      "official": true,
      "hosted": "local"
    },
    "operability": "official",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Manage products, variants, categories",
        "reachable": true,
        "evidence": "Admin API /admin/products, /admin/product-categories"
      },
      {
        "job": "Manage orders, fulfilments, returns",
        "reachable": true,
        "evidence": "Admin API /admin/orders, /admin/fulfillments, /admin/returns"
      },
      {
        "job": "Manage customers and groups",
        "reachable": true,
        "evidence": "Admin API /admin/customers"
      },
      {
        "job": "Pricing, price lists, promotions",
        "reachable": true,
        "evidence": "Admin API /admin/price-lists, /admin/promotions"
      },
      {
        "job": "Inventory and stock locations",
        "reachable": true,
        "evidence": "Admin API /admin/inventory-items, /admin/stock-locations"
      },
      {
        "job": "Regions, sales channels, shipping options",
        "reachable": true,
        "evidence": "Admin API /admin/regions, /admin/sales-channels, /admin/shipping-options"
      },
      {
        "job": "Storefront cart and checkout",
        "reachable": true,
        "evidence": "Store API /store/carts, payment collections"
      },
      {
        "job": "Build customisations with an agent",
        "reachable": true,
        "evidence": "medusa-agent-skills medusa-dev plugin; MCP server queries public docs only"
      },
      {
        "job": "Manage Medusa Cloud resources",
        "reachable": true,
        "evidence": "medusa-cloud plugin wraps the mcloud CLI (paid edition)"
      }
    ],
    "editions": [
      {
        "name": "Open source",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "source",
            "url": "https://github.com/medusajs/medusa",
            "command": "npx create-medusa-app@latest"
          }
        ]
      },
      {
        "name": "Medusa Cloud",
        "price": null,
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://medusajs.com/cloud/",
            "command": ""
          }
        ]
      },
      {
        "name": "Enterprise Edition",
        "price": null,
        "open": false,
        "distributions": []
      }
    ],
    "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",
      "note": "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/."
    },
    "customization": {
      "summary": "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.",
      "envVars": [
        "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"
      ],
      "configFiles": [
        "medusa-config.ts",
        ".env"
      ],
      "promptFiles": [
        "medusa-agent-skills plugins (medusa-dev, ecommerce-storefront, medusa-cloud)"
      ],
      "effort": "light-edit",
      "editCount": 18
    },
    "useWhen": [
      "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"
    ],
    "accounts": [
      "Medusa Cloud (hosted edition only)"
    ],
    "active": true,
    "lastActivity": "2026-09-02",
    "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"
    ],
    "fit": {
      "adaptable": 3,
      "operable": 3
    },
    "evidence": {
      "formFactor": "docs: Node.js server with admin dashboard; storefront separate",
      "executionModel": "no model at runtime",
      "operability": "docs.medusajs.com publishes Admin and Store API references; medusa-agent-skills under the medusajs org",
      "effort": "docs environment-variables page names 18 vars; medusa-config reference documents five sections",
      "editions": "LICENSE: MIT except Enterprise Edition; README: Medusa Cloud",
      "active": "pushedAt 2026-09-02"
    },
    "confidence": {
      "formFactor": 0.9,
      "executionModel": 0.95,
      "operability": 0.9,
      "effort": 0.8,
      "reach": 0.85,
      "editions": 0.7
    },
    "openQuestions": [
      "Medusa Cloud pricing",
      "medusa-agent-skills last commit date"
    ],
    "sources": [
      {
        "url": "https://github.com/medusajs/medusa",
        "foundBy": "sourcing:ecommerce:community"
      },
      {
        "url": "https://github.com/medusajs/medusa-agent-skills",
        "foundBy": "sourcing:ecommerce:community"
      },
      {
        "url": "https://docs.medusajs.com/resources/references/medusa-config",
        "foundBy": "analysis"
      }
    ],
    "research": {
      "stage": "verified",
      "verdict": "unverified",
      "reason": "Owner-documented config file and env vars, MIT core, complete official REST APIs; skills are for building, not operating.",
      "disputed": []
    },
    "url": "apps/medusajs--medusa.html",
    "coverage": "complete",
    "paid": false,
    "source": "research/verified/medusajs--medusa.json"
  }
}