Run your entire cold email operation with Cursor

Cursor drives the same Coldrig MCP server, the same 34 tools, and the same test-mode boundary as Claude Code — the full setup-to-reply lifecycle is identical. What's genuinely different is how you connect it and how you make the workflow repeatable: Cursor takes a hand-edited mcp.json instead of a CLI command, and it has its own convention (Rules) for storing reusable agent instructions instead of Claude Code's Skills. This page covers only that delta; for the full step-by-step lifecycle (setup through reply triage) see the Claude Code guide — every tool call there works identically from Cursor.

How is Cursor's setup different from Claude Code?

• Config format. Cursor has no mcp add command — you add the server by hand to a JSON file, not a CLI invocation.
• Config location. Keep the token-bearing config in personal ~/.cursor/mcp.json, not a project-level file that could be committed by accident.
• Header auth has varied by release. Cursor's handling of custom headers on remote MCP servers has changed across versions — verify tools/list returns all 34 tools on your exact Cursor version before relying on it, and never hardcode a token in a project file if header auth misbehaves.
• Reusable instructions. Cursor uses Rules, not Skills — see below.

Exact Cursor config

The quickest way needs no key. Add this to personal ~/.cursor/mcp.json (or use the one-click Add to Cursor button on the connect page), restart Cursor and approve the sign-in: your browser opens Coldrig, where you sign in, check the account name and press Allow.

{
  "mcpServers": {
    "coldrig": {
      "url": "https://api.coldrig.dev/mcp"
    }
  }
}

If sign-in does not work, use an API key instead. Mint one first (no card required; it stays the same when you go live):

curl -s -X POST https://api.coldrig.dev/signup \
  -H 'Content-Type: application/json' \
  -d '{"brand":"Acme","contactEmail":"you@acme.com"}'
# → { "tenantId": "ten_...", "token": "..." }

Then add this to personal ~/.cursor/mcp.json instead of the sign-in version above:

{
  "mcpServers": {
    "coldrig": {
      "url": "https://api.coldrig.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:COLDRIG_TOKEN}"
      }
    }
  }
}

Set COLDRIG_TOKEN where the Cursor desktop process can read it, restart Cursor, and inspect all 34 tools before you rely on the connection. Full side-by-side with Codex and Cline: the connect reference.

The lifecycle, from Cursor

Identical tool calls to every other client — Cursor just makes them through its own agent chat instead of a terminal session. Full schemas: the MCP tool reference.

What's a Cursor Rule for this, and should I write one?

Cursor's convention for repeatable, project-scoped agent instructions is a Rules file — typically a .mdc file under .cursor/rules/ in your project (the legacy single-file form is .cursorrules at the project root). Nothing below ships with Coldrig; it's a rule you write yourself so Cursor applies the same operating discipline to this project every time, instead of you restating it in chat.

---
description: Operate Coldrig-backed cold email infrastructure for this project
alwaysApply: false
---

Coldrig is connected as the `coldrig` MCP server. Read the bearer token from
the `COLDRIG_TOKEN` environment variable — never hardcode it in this repo.

- Write the offer and sequence content yourself before calling `launch_campaign`;
  Coldrig does not generate outreach copy.
- Check `activity` for new events, or subscribe a URL via `configure_webhook`
  for push delivery instead of polling.
- Never claim a real send occurred while the account is in test mode.
- Never claim guaranteed inbox placement or deliverability.

The reply-handling boundary, in short

Push webhooks are live — configure_webhook delivers reply, bounce, soft_bounce, complaint, and unsubscribe events (HMAC-signed) to your own HTTPS endpoint. activity and inbox remain pollable too if you'd rather run Cursor on your own cadence. Full capability matrix: see the detailed breakdown.

Cost

Same platform, same meter, regardless of client: $49 a month covers your first 3 mailboxes, and each extra mailbox is $5 a month. Full worked examples and the live calculator: pricing.

Try it now

npx agent-cold-email demo

Runs the same test mode end to end — no real domain, mailbox, or send. Free sign up to get a token and connect Cursor for real.

Related guides

• Run your entire cold email operation with Claude Code — the full step-by-step lifecycle this page delegates to.
• Run your entire cold email operation with Codex.
• The cold-email MCP server for coding agents — full tool signatures.
• Connect reference — Codex, Claude Code, Cursor, and Cline side by side.
• Should your AI agent use Coldrig?
• FAQ.