2.3. Medusa MCP Remote Server

The Medusa documentation provides a remote Model Context Protocol (MCP) server that allows you to find information from the Medusa documentation right in your IDEs or AI tools, such as Cursor.

Medusa hosts a Streamable HTTP MCP server at https://docs.medusajs.com/mcp that you can add to AI agents supporting MCP server connections.

Connect to the Medusa MCP Server#

Claude Code#

To connect to the Medusa MCP server in Claude Code, run the following command in your terminal:

Code
claude mcp add --transport http medusa https://docs.medusajs.com/mcp

Cursor#

Click here to add the Medusa MCP server to Cursor.

To manually connect to the Medusa MCP server in Cursor, add the following to your .cursor/mcp.json file or Cursor settings, as explained in the Cursor documentation:

Code
1{2  "mcpServers": {3    "medusa": {4      "url": "https://docs.medusajs.com/mcp"5    }6  }7}

VS Code#

Click here to add the Medusa MCP server to VSCode.

To manually connect to the Medusa MCP server in VSCode, add the following to your .vscode/mcp.json file in your workspace:

Code
1{2  "servers": {3    "medusa": {4      "type": "http",5      "url": "https://docs.medusajs.com/mcp"6    }7  }8}

How to Use the MCP Server#

After connecting to the Medusa MCP server in your AI tool or IDE, you can start asking questions or requesting your AI assistant to build Medusa customizations. It will fetch the relevant information from the Medusa documentation and provide you with accurate answers, code snippets, and explanations.

For example, you can ask:

1. "Create a Product Review module for Medusa. Refer to the Medusa documentation for information."
2. "How to update Medusa to the latest version?"
3. "Explain the Medusa workflow system."
4. "Integrate Medusa with X provider. Refer to the Medusa documentation for information."