Connect with Cursor

In Cursor, go to Settings -> Cursor Settings -> Tools & Integration.

Click on "Add Custom MCP to opn the file ~/.cursor/mcp.json

Setup the connection to MCPX using the following:

{
  "mcpServers": {
    "mcpx": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:9000/sse",
        "--header",
        "x-lunar-consumer-tag: cursor",
        "--header",
        "x-lunar-api-key: <YOUR_API_KEY>"
      ]
    }
  }
}

In the instance above MCPX is running locally on port 9000

tip

Make sure to configure the args for your use case. Change x-lunar-consumer-tag to your desired consumer name and add you Lunar.dev API Key to x-lunar-api-key. This can be found in the Control Plane by clicking on the API Keys menu option under Configuration.

Back in the Tools & Integration section you should now see mcpx under MCP Tools.

tip

MCPX will expose the available tools which are set up in lunar/mcpx/packages/mcpx-server/config/mcp.json, however they are not yet accessible for use. Please close and restart Cursor Code Editor to ensure all tools and integrations are properly loaded and available