Warmerly

Official Warmerly MCP server: find B2B leads, build and launch cold email campaigns, check mailbox health and SPF/DKIM/DMARC, triage and answer replies, verify emails. OAuth, remote.

Servidor MCP hospedado

npx add-mcp 'https://app.warmerly.com/api/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Warmerly

Warmerly MCP server

Connect any AI assistant to your Warmerly workspace.
Website · Docs · Claude Code plugin

https://app.warmerly.com/api/mcp

Add to Cursor Install in VS Code

A remote Model Context Protocol server (streamable HTTP, OAuth 2.1). Sign in with your normal Warmerly account and choose one workspace; the connection can only see and act in that workspace. Every Warmerly plan can connect, including Free. No API key needed.

This repo holds copy-paste setup for each client. The server itself is hosted by Warmerly and listed in the official MCP Registry as com.warmerly/warmerly (server.json here).

What you can ask

  • "Find UK marketing agencies with 10–50 staff and build a two-step campaign for them."
  • "Which of my mailboxes are unhealthy, and why?"
  • "Check SPF, DKIM, DMARC and MX for acme.com and tell me what to fix."
  • "Show me replies that need an answer and draft a response to each."
  • "Pause every campaign that's bouncing above 3%."
  • "Verify jane@acme.com."

Setup

ChatGPT

Search for Warmerly in the ChatGPT plugin directory. Until it's listed, turn on developer mode (Plus, Pro, Business, Enterprise or Edu), then Plugins → Add → Create MCP App with the URL above and OAuth authentication.

Claude (claude.ai and the desktop app)

Settings → Connectors → Add custom connector, paste the URL above, then Connect and sign in. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

Claude Code

Install the plugin (server plus four workflow skills):

/plugin marketplace add WarmerlyApp/claude-plugin
/plugin install warmerly@warmerly

Or add just the server:

claude mcp add --transport http warmerly https://app.warmerly.com/api/mcp

Then run /mcp and sign in.

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "warmerly": { "url": "https://app.warmerly.com/api/mcp" }
  }
}

Open Settings → MCP and sign in when prompted.

VS Code (GitHub Copilot agent mode)

Run MCP: Add Server, or put this in .vscode/mcp.json (or MCP: Open User Configuration for every workspace):

{
  "servers": {
    "warmerly": { "type": "http", "url": "https://app.warmerly.com/api/mcp" }
  }
}

A browser window opens to sign in the first time a tool is used.

Windsurf

mcp_config.json (~/.codeium/windsurf/mcp_config.json on most installs; open it from the MCP settings panel to be sure):

{
  "mcpServers": {
    "warmerly": { "serverUrl": "https://app.warmerly.com/api/mcp" }
  }
}
OpenAI Codex CLI
codex mcp add warmerly --url https://app.warmerly.com/api/mcp
codex mcp login warmerly

Or in ~/.codex/config.toml:

[mcp_servers.warmerly]
url = "https://app.warmerly.com/api/mcp"
Gemini CLI
gemini mcp add --transport http warmerly https://app.warmerly.com/api/mcp

Or in ~/.gemini/settings.json (note httpUrl, not url):

{
  "mcpServers": {
    "warmerly": { "httpUrl": "https://app.warmerly.com/api/mcp" }
  }
}

Sign-in starts automatically; /mcp auth warmerly repeats it.

Cline

MCP Servers → Remote Servers, or in the JSON config:

{
  "mcpServers": {
    "warmerly": {
      "type": "streamableHttp",
      "url": "https://app.warmerly.com/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Any client that only supports local (stdio) servers

Bridge with mcp-remote, for example in claude_desktop_config.json:

{
  "mcpServers": {
    "warmerly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.warmerly.com/api/mcp"]
    }
  }
}

A browser opens to sign in on first connect. Delete ~/.mcp-auth/ to sign in again.

Tools

AreaTools
Account and docsget_account_overview, search_docs, read_doc, get_connect_mailbox_link
Mailboxes and deliverabilitylist_mailboxes, get_mailbox_health, set_warmup, update_mailbox_settings, check_domain, run_placement_test
Leads and email datasearch_leads, count_leads, verify_email, find_email, get_find_email_result, suppress_emails
Campaignslist_campaigns, get_campaign, create_campaign, set_campaign_sequence, update_campaign_settings, add_leads, add_leads_from_search, launch_campaign, pause_campaign, resume_campaign, get_campaign_stats
Inboxlist_conversations, get_conversation, draft_reply, send_reply, categorize_message
Transactional emaillist_sending_domains, list_transactional_emails, get_transactional_email, send_transactional_email

Full descriptions: docs.warmerly.com/ai.

Safety

  • The same rules as the dashboard. Plan limits, the suppression list, mailbox health checks and campaign readiness checks apply to every call.
  • Rate limited: 60 calls a minute per connection; sends share a tighter 20 a minute.
  • Audited: every write is logged in the workspace audit log with the connecting app's name.
  • No passwords through the AI: mailboxes are connected in the Warmerly dashboard, never through a tool.
  • Revocable: Settings → Connected apps in Warmerly cuts a connection off immediately.

Support

hello@warmerly.com · Privacy · Terms