Skip to content
MCP server

Medusa

Query your Medusa Cloud stores, custom API routes, deployments and logs from an AI tool

Install
Pricing
Paid
Platforms
API, Web
Runs
Remotely
Version
0.1.0
Listing updated
1 day ago

About Medusa

Medusa is a paid MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

This is Medusa Cloud's own remote MCP server, for teams that host Medusa commerce backends on Medusa Cloud. Once connected, an assistant can answer questions such as which orders await fulfilment, what the latest five orders total, which carts were abandoned in the last day, or why a deployment failed from its build logs.

Three kinds of data are reachable. Commerce data comes from Admin API routes as your admin user, and storefront data from Store API routes as a guest. Custom data comes from your own GET routes under /store and /admin, which Medusa indexes whenever an environment builds, so environments built before 8 October 2026 need a rebuild. Cloud data covers organizations, projects, deployments, build and runtime logs and environment variables. If a store requires multi-factor authentication, tools such as read_admin_api ask you to confirm your identity.

Connection uses OAuth, with a consent page where you pick which environments the tool can reach, and it is available on all Cloud plans. Documented setups include the Claude connector, Claude Code, Cursor, VS Code, Codex, OpenCode, Gemini CLI and n8n Cloud; self-hosted n8n cannot connect.

Install

Run in a terminal

claude mcp add --transport http cloud https://cloud.medusajs.com/mcp

Add to Settings → Connectors → Add custom connector

https://cloud.medusajs.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cloud": {
      "url": "https://cloud.medusajs.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "cloud": {
      "type": "http",
      "url": "https://cloud.medusajs.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cloud": {
      "serverUrl": "https://cloud.medusajs.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cloud": {
      "type": "http",
      "url": "https://cloud.medusajs.com/mcp"
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

read_admin_api
Reads commerce data from the store's Admin API routes.

What it does

Commerce data reads
Retrieve orders, products, customers and inventory through the Admin and Store APIs.
Custom route access
Read your own GET API routes after they are indexed at build time.
Cloud data
Inspect projects, deployments, logs and environment variables.
Environment selection
Choose which environments each AI tool may access.
MFA confirmation
Prompts for identity confirmation on stores that require it.
OAuth sign-in
No access key to create; approve the connection in the browser.

Good for

  • Listing recent orders with totals and statuses
  • Finding abandoned carts from the last 24 hours
  • Diagnosing a failed deployment from its build logs
  • Scanning backend logs for recent errors
  • Querying data from a custom module route

Pricing

Paid, from $29 a month

Included in Medusa Cloud plans, from $29/mo (Develop), $99/mo (Launch), $299/mo (Scale)

Prices change. Check docs.medusajs.com before you buy.

Medusa FAQ

Which plans include it?

The docs say the Medusa MCP is available on all Cloud plans.

How do I authenticate?

With OAuth; you log in to your Cloud account and approve the connection.

Why can't it see my custom routes?

Environments built before 8 October 2026 must be rebuilt so Medusa can index their API routes.

Does it work with self-hosted Medusa?

It is for applications deployed on Medusa Cloud.

Can I use it in n8n?

Yes in n8n Cloud; self-hosted n8n cannot connect.

Is Medusa free?

No. Medusa is a paid product. Paid plans start at $29 a month.

How do I add Medusa to Claude Code?

Run this command in your terminal: claude mcp add --transport http cloud https://cloud.medusajs.com/mcp

What are the best alternatives to Medusa?

The closest alternatives to Medusa are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Medusa

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools