
Medusa
Query your Medusa Cloud stores, custom API routes, deployments and logs from an AI tool
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://cloud.medusajs.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"cloud": {
"url": "https://cloud.medusajs.com/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools