Agent Cold Email MCP Server

by ys-projectcalcio.github.YS-projectcalc/agent-cold-emailv0.2.5

Coldrig cold-email infrastructure run by your agent: buy domains, provision mailboxes, warm up, run sequences and handle replies.

0Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active15d ago

Install Agent Cold Email MCP server

claude mcp add agent-cold-email -e AGENT_COLD_EMAIL_API_KEY='<agent-cold-email-api-key>' -- npx -y agent-cold-email

{
  "mcpServers": {
    "agent-cold-email": {
      "command": "npx",
      "args": [
        "-y",
        "agent-cold-email"
      ],
      "env": {
        "AGENT_COLD_EMAIL_API_KEY": "<agent-cold-email-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "agent-cold-email": {
      "command": "npx",
      "args": [
        "-y",
        "agent-cold-email"
      ],
      "env": {
        "AGENT_COLD_EMAIL_API_KEY": "<agent-cold-email-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "agent-cold-email": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-cold-email"
      ],
      "env": {
        "AGENT_COLD_EMAIL_API_KEY": "<agent-cold-email-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "agent-cold-email": {
      "command": "npx",
      "args": [
        "-y",
        "agent-cold-email"
      ],
      "env": {
        "AGENT_COLD_EMAIL_API_KEY": "<agent-cold-email-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
AGENT_COLD_EMAIL_API_KEY	—	yes	Bearer token from POST /signup (free, no card) — or run `npx agent-cold-email demo` first. Optional at startup: without it, `initialize`/`tools/list` still work (unauthenticated introspection), but every `tools/call` fails until a key is set.
AGENT_COLD_EMAIL_BASE_URL	—	—	Override the API base URL (default: https://api.coldrig.dev)

Remote endpoints

streamable-httphttps://api.coldrig.dev/mcp

Freshness

Active — last maintenance signal 15d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-25 · 15d ago · GitHub
Latest release
2026-09-24 · 15d ago · GitHub · v0.2.3
Package published
no data · npm/PyPI
Registry entry updated
2026-09-25 · 15d ago · official registry · v0.2.5

FAQ

›How do I install the Agent Cold Email MCP server in Claude Code?

Run: claude mcp add agent-cold-email -e AGENT_COLD_EMAIL_API_KEY='<agent-cold-email-api-key>' -- npx -y agent-cold-email. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Agent Cold Email require an API key?

Yes. It expects AGENT_COLD_EMAIL_API_KEY, of which 1 is a secret.

›Can I use Agent Cold Email as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Agent Cold Email in the official MCP registry?

Yes, as io.github.YS-projectcalc/agent-cold-email.