Warmerly MCP server

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

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

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.

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.

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/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.

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.

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" }
  }
}

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 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.

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

{
  "mcpServers": {
    "warmerly": {
      "type": "streamableHttp",
      "url": "https://app.warmerly.com/api/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

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

Area	Tools
Account and docs	get_account_overview, search_docs, read_doc, get_connect_mailbox_link
Mailboxes and deliverability	list_mailboxes, get_mailbox_health, set_warmup, update_mailbox_settings, check_domain, run_placement_test
Leads and email data	search_leads, count_leads, verify_email, find_email, get_find_email_result, suppress_emails
Campaigns	list_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
Inbox	list_conversations, get_conversation, draft_reply, send_reply, categorize_message
Transactional email	list_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