{"_id":"cursor-cli-mcp","_rev":"3-4f6ef66baeead5f6e51cc80055e1e134","name":"cursor-cli-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"cursor-cli-mcp","version":"1.0.0","keywords":["mcp","cursor","claude","codex","ai","model-context-protocol","code-review","llm"],"author":{"name":"MazRadwan"},"license":"SEE LICENSE IN LICENSE","_id":"cursor-cli-mcp@1.0.0","maintainers":[{"name":"mazradwan","email":"33mazzystar@gmail.com"}],"homepage":"https://github.com/MazRadwan/cursor-cli-mcp#readme","bugs":{"url":"https://github.com/MazRadwan/cursor-cli-mcp/issues"},"bin":{"cursor-cli-mcp":"index.js"},"dist":{"shasum":"3511660dc845ff372e3f90409d054696c1eff203","tarball":"https://registry.npmjs.org/cursor-cli-mcp/-/cursor-cli-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-APqx0Fd5E/DkYahNMNjHwrxPEGNaNZAmC6f8qIw7+SQEw4SBaI8P9Qi+KcnjwWKvACcZ3iTorEBp+USfAzIQ/w==","signatures":[{"sig":"MEYCIQCgq76uZb7kdJQXxn7Cs8TsIKusnVBU6I0uAumzQvgIqwIhANRz0FqGlQjzA2MdWbxoCTExaRN/s7S/u5FgXA74Ghtf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12948},"type":"module","engines":{"node":">=18"},"gitHead":"61e73144524f0ec4145b51776a867ec8ba03ed09","_npmUser":{"name":"mazradwan","email":"33mazzystar@gmail.com"},"repository":{"url":"git+https://github.com/MazRadwan/cursor-cli-mcp.git","type":"git"},"_npmVersion":"11.7.0","description":"MCP server that connects any AI agent to every model in your Cursor subscription. No API keys needed.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cursor-cli-mcp_1.0.0_1773593849950_0.419407767820132","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"cursor-cli-mcp","version":"1.0.1","keywords":["mcp","cursor","claude","codex","ai","model-context-protocol","code-review","llm"],"author":{"name":"MazRadwan"},"license":"SEE LICENSE IN LICENSE","_id":"cursor-cli-mcp@1.0.1","maintainers":[{"name":"mazradwan","email":"33mazzystar@gmail.com"}],"homepage":"https://github.com/MazRadwan/cursor-cli-mcp#readme","bugs":{"url":"https://github.com/MazRadwan/cursor-cli-mcp/issues"},"bin":{"cursor-cli-mcp":"index.js"},"dist":{"shasum":"5f5f6473e4d333ae0c4f5725581ccf97e0876c99","tarball":"https://registry.npmjs.org/cursor-cli-mcp/-/cursor-cli-mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-W8+vSrup/doKPQqp78/Wdzz/HNcTFluOYdWujhDmwdeQi7tK2PohhOSQinNQ5EMZAnwrQNatBNvVkDca+lH5qw==","signatures":[{"sig":"MEUCIB6P1BU+XLn2nSiTfuOX8awTpXQ1pud1QCtqKsbUvyPxAiEAgfeiSj/6RhZ4EGl0QcwXyUDEw70Sh5JJGJ2ipazrtj8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12937},"type":"module","engines":{"node":">=18"},"gitHead":"61e73144524f0ec4145b51776a867ec8ba03ed09","_npmUser":{"name":"mazradwan","email":"33mazzystar@gmail.com"},"repository":{"url":"git+https://github.com/MazRadwan/cursor-cli-mcp.git","type":"git"},"_npmVersion":"11.7.0","description":"MCP server that connects any AI agent to every model in your Cursor subscription. No API keys needed.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cursor-cli-mcp_1.0.1_1773594035475_0.14422047169856023","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"cursor-cli-mcp","version":"1.0.2","description":"MCP server that connects any AI agent to every model in your Cursor subscription. No API keys needed.","type":"module","bin":{"cursor-cli-mcp":"index.js"},"keywords":["mcp","cursor","claude","codex","ai","model-context-protocol","code-review","llm"],"author":{"name":"MazRadwan"},"license":"SEE LICENSE IN LICENSE","repository":{"type":"git","url":"git+https://github.com/MazRadwan/cursor-cli-mcp.git"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"gitHead":"61e73144524f0ec4145b51776a867ec8ba03ed09","_id":"cursor-cli-mcp@1.0.2","bugs":{"url":"https://github.com/MazRadwan/cursor-cli-mcp/issues"},"homepage":"https://github.com/MazRadwan/cursor-cli-mcp#readme","_nodeVersion":"22.16.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-XBcNY9KVzCAKm3A70Uds7XujAMeLYEp2OBfO3TGwuSDOpteS/FNCdY3DeKOm8P725c3BU6JKG97ICMNz3uGNhQ==","shasum":"994114251e46ac7584d1d6cf1c33d22aa7d82f40","tarball":"https://registry.npmjs.org/cursor-cli-mcp/-/cursor-cli-mcp-1.0.2.tgz","fileCount":4,"unpackedSize":12943,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHSm126TjeB451fP90S7XvnXvOmQRD8zVl8R6FjTaNoYAiBMt8gQT6sp6YiqIOXTN8KlhfNq5RWBNXrXbBgru5erPw=="}]},"_npmUser":{"name":"mazradwan","email":"33mazzystar@gmail.com"},"directories":{},"maintainers":[{"name":"mazradwan","email":"33mazzystar@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cursor-cli-mcp_1.0.2_1773594416915_0.21543041643079186"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-15T16:57:29.949Z","modified":"2026-03-15T17:06:57.153Z","1.0.0":"2026-03-15T16:57:30.077Z","1.0.1":"2026-03-15T17:00:35.615Z","1.0.2":"2026-03-15T17:06:57.054Z"},"bugs":{"url":"https://github.com/MazRadwan/cursor-cli-mcp/issues"},"author":{"name":"MazRadwan"},"license":"SEE LICENSE IN LICENSE","homepage":"https://github.com/MazRadwan/cursor-cli-mcp#readme","keywords":["mcp","cursor","claude","codex","ai","model-context-protocol","code-review","llm"],"repository":{"type":"git","url":"git+https://github.com/MazRadwan/cursor-cli-mcp.git"},"description":"MCP server that connects any AI agent to every model in your Cursor subscription. No API keys needed.","maintainers":[{"name":"mazradwan","email":"33mazzystar@gmail.com"}],"readme":"# cursor-cli-mcp\n\n**Use every model in your Cursor subscription from any AI agent. No API keys needed.**\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that bridges any MCP-compatible tool to Cursor's full model roster — GPT-5.x, Claude 4.x, Gemini 3.x, Grok, and more — using your existing Cursor subscription credits.\n\n## Why?\n\nAI coding agents like Claude Code, Codex CLI, and others are powerful — but they're locked to a single model provider. Meanwhile, your Cursor subscription gives you access to **40+ models** across OpenAI, Anthropic, Google, and others.\n\n**cursor-cli-mcp** bridges this gap. It lets any MCP-compatible agent call any Cursor model as a tool, using your subscription. No API keys, no separate billing, no rate limits beyond your plan.\n\n### The value\n\n| Without cursor-cli-mcp | With cursor-cli-mcp |\n|------------------------|---------------------|\n| Each model needs its own API key | Zero API keys — use your Cursor subscription |\n| Separate billing per provider | One subscription covers all models |\n| Rate limits per API | Use your existing Cursor allowance |\n| Locked to one model per agent | Switch models per-task from any agent |\n\n## What you get\n\n| Tool | Description |\n|------|-------------|\n| `cursor_prompt` | Send any prompt to any Cursor model and get a response |\n| `cursor_review` | Code review using any model — checks bugs, security, performance, quality |\n| `cursor_review_file` | Review a file by path using any model |\n| `cursor_list_models` | List all models available in your subscription |\n\n## Prerequisites\n\n1. **Cursor** installed with an active subscription ([cursor.com](https://cursor.com))\n2. **Cursor CLI agent** installed at `~/.local/bin/agent` (Cursor installs this automatically — run `cursor` from terminal to verify)\n3. **Node.js** >= 18\n\n> **Custom agent path?** Set the `CURSOR_AGENT_PATH` environment variable to override the default location.\n\n## Install\n\n### Option 1: npx (no install)\n\nUse directly in your MCP config — no global install needed:\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"cursor-cli-mcp\"]\n    }\n  }\n}\n```\n\n### Option 2: Global install\n\n```bash\nnpm install -g cursor-cli-mcp\n```\n\nThen reference it in your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-cli\": {\n      \"command\": \"cursor-cli-mcp\"\n    }\n  }\n}\n```\n\n### Option 3: From source\n\n```bash\ngit clone https://github.com/MazRadwan/cursor-cli-mcp.git\ncd cursor-cli-mcp\nnpm install\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-cli\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/cursor-cli-mcp/index.js\"]\n    }\n  }\n}\n```\n\n## Setup by client\n\n### Claude Code\n\n```bash\nclaude mcp add cursor-cli -- npx -y cursor-cli-mcp\n```\n\nOr add to your project `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"cursor-cli-mcp\"]\n    }\n  }\n}\n```\n\n### Codex CLI\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"cursor-cli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"cursor-cli-mcp\"]\n    }\n  }\n}\n```\n\n### Any MCP-compatible client\n\ncursor-cli-mcp uses **stdio transport** — it works with any client that supports the MCP standard. Just point your client's MCP server config to `npx -y cursor-cli-mcp` or the installed binary.\n\n## Use cases\n\n### Cross-model code review\n\nUse Claude Code as your primary agent, but send reviews to GPT-5.4 or Gemini for a second opinion:\n\n```\n\"Review this auth module for security issues\"\n→ cursor_review_file({ file_path: \"/src/auth.ts\", model: \"gpt-5.4-high\" })\n```\n\n### Model comparison\n\nTest the same prompt across different models to compare outputs:\n\n```\n→ cursor_prompt({ prompt: \"Explain this regex: ...\", model: \"gpt-5.4-high\" })\n→ cursor_prompt({ prompt: \"Explain this regex: ...\", model: \"sonnet-4.6-thinking\" })\n```\n\n### Overflow / fallback\n\nWhen your primary agent's API hits rate limits or quota, route to Cursor as a fallback without changing your workflow.\n\n### Specialized tasks\n\nRoute tasks to the best model for the job:\n\n- **Deep reasoning** → `opus-4.6-thinking`\n- **Fast iteration** → `gpt-5.4-high-fast`\n- **Code generation** → `gpt-5.3-codex-high`\n- **Planning** → `sonnet-4.6-thinking`\n\n## Available models\n\nRun `cursor_list_models` to see your full list. Typical subscriptions include:\n\n- **OpenAI**: GPT-5.4, GPT-5.3 Codex, GPT-5.2, GPT-5.1\n- **Anthropic**: Claude 4.6 Opus, Claude 4.6 Sonnet, Claude 4.5\n- **Google**: Gemini 3.1 Pro, Gemini 3 Pro, Gemini 3 Flash\n- **Others**: Grok, Kimi K2.5, and more\n\nModel availability depends on your Cursor subscription tier.\n\n## Configuration\n\n| Environment variable | Default | Description |\n|---------------------|---------|-------------|\n| `CURSOR_AGENT_PATH` | `~/.local/bin/agent` | Path to the Cursor CLI agent binary |\n\n## How it works\n\n```mermaid\nflowchart LR\n    A[\"MCP Client<br/>(Claude Code, Codex CLI, etc.)\"] -- \"stdio / MCP protocol\" --> B[\"cursor-cli-mcp\"]\n    B -- \"exec / agent binary\" --> C[\"Cursor CLI<br/>(40+ models)\"]\n    C -- response --> B\n    B -- response --> A\n\n    style A fill:#2d333b,stroke:#539bf5,stroke-width:2px,color:#adbac7\n    style B fill:#2d333b,stroke:#57ab5a,stroke-width:2px,color:#adbac7\n    style C fill:#2d333b,stroke:#daaa3f,stroke-width:2px,color:#adbac7\n```\n\n1. Your MCP client sends a tool call over stdio\n2. cursor-cli-mcp translates it into a Cursor CLI agent invocation\n3. Cursor routes to the requested model using your subscription\n4. Response flows back through the same path\n\n## Contributing\n\nContributions welcome! Please open an issue or PR.\n\n## License\n\nSee [LICENSE](LICENSE) for details.\n","readmeFilename":"README.md"}