# Medusa

> Medusa is a paid MCP server for e-commerce. Query your Medusa Cloud stores, custom API routes, deployments and logs from an AI tool. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Starting price:** $29 a month
- **Platforms:** API, Web
- **Website:** https://docs.medusajs.com/cloud/medusa-mcp
- **MCP Registry name:** com.medusajs/cloud
- **Categories:** e-commerce, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cloud.medusajs.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cloud": {
      "url": "https://cloud.medusajs.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/medusa
