Skip to content
Purser
Install guide · Cursor

Install Purser for Cursor

Cursor reads ~/.cursor/mcp.json. A project can also commit .cursor/mcp.json.

  1. Open ~/.cursor/mcp.json on macOS, %USERPROFILE%\.cursor\mcp.json on Windows, or ~/.cursor/mcp.json on Linux.

  2. Paste the JSON config below.

  3. Replace placeholder secrets, then restart the client if it does not reload on its own.

~/.cursor/mcp.json
{  "mcpServers": {    "ahmad-codex-purser": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "ghcr.io/ahmad-codex/purser:0.1.2"      ],      "env": {        "PURSER_RPC_URL": "",        "PURSER_ACCOUNT": "",        "PURSER_AGENT_PRIVATE_KEY": "YOUR_PURSER_AGENT_PRIVATE_KEY",        "PURSER_BUNDLER_URL": "",        "PURSER_RELAYER_PRIVATE_KEY": "YOUR_PURSER_RELAYER_PRIVATE_KEY",        "PURSER_API_TOKEN": "YOUR_PURSER_API_TOKEN"      }    }  }}

Where the config lives

SystemPath
macOS~/.cursor/mcp.json
Windows%USERPROFILE%\.cursor\mcp.json
Linux~/.cursor/mcp.json