MCP Server — Connect AI Tools (Overview)
Connect Claude Desktop, Claude Code, Cursor, Windsurf, Zed, and other MCP-compatible AI clients to your WarmySender workspace using the Model Context Protocol (MCP). Once connected, your AI assistant can list campaigns, enroll prospects, check mailbox health, pause LinkedIn campaigns, update warmup settings, and more — all in natural language, with your account's safety limits enforced by our scheduler.
What Is MCP?
MCP (Model Context Protocol) is an open standard from Anthropic that lets AI assistants talk to external tools and data. Instead of copy-pasting information between tabs, you ask your AI — "list my active campaigns," "enroll these 20 prospects in campaign X," "pause the SDR LinkedIn campaign" — and it calls the right WarmySender action on your behalf.
What You Can Do:
- List email + LinkedIn campaigns with live counters (sent, opened, replied, bounced)
- Create, update, start, pause, resume email campaigns
- Enroll / unenroll prospects in bulk (up to 500 per call)
- Create, update, and bulk-import prospects (up to 500 per request)
- Check mailbox health, warmup stats, and per-mailbox deliverability
- List LinkedIn accounts + health + current weekly invite/message usage
- Pause / resume LinkedIn campaigns (never direct send — scheduler enforces all account safety)
- Enroll prospects in LinkedIn campaigns (queued, scheduler-paced within daily caps)
- Update warmup settings per mailbox or in bulk
- Add emails or domains to the suppression list
- Poll async job status (bulk updates, connection tests)
What You Cannot Do (by design):
- No direct LinkedIn sends from MCP — all LinkedIn actions route through the same scheduler the UI uses, which enforces the 4-week ramp, daily/weekly caps, and per-account safety limits. A banned account is unrecoverable, so this is non-negotiable.
- No account connect/disconnect — adding or removing a LinkedIn or email account stays in the web UI (prevents a compromised AI from draining your LinkedIn seats).
- No delete operations — soft-cancel via pause / archive only; permanent deletes happen in the UI after explicit confirmation.
- No modification of warmup subject-line ref tags (protects your inbox filtering).
Supported AI Clients:
- Claude Desktop (Mac / Windows)
- Claude Code (CLI)
- Cursor
- Windsurf (Codeium)
- Zed
- Any client that speaks MCP over Streamable HTTP (the 2025-11 spec)
Authentication:
MCP uses your existing WarmySender API key (ws_ prefix). Create one in Settings > API Keys with the scopes you want to expose (e.g., campaigns:read, campaigns:write, prospects:write, linkedin:read, warmup:write). The same key works for both REST API and MCP — no separate credentials.
Scope Mapping (your key needs these for each tool):
- list_campaigns, get_campaign → campaigns:read
- create_campaign, update_campaign, start/pause/resume_campaign → campaigns:write
- enroll_prospects, unenroll_prospects → enrollments:write
- list_prospects, get_prospect → prospects:read
- create_prospect, update_prospect, bulk_create_prospects → prospects:write
- list_mailboxes, get_mailbox_health → mailboxes:read
- get_warmup_stats → warmup:read
- update_warmup_settings, bulk_update_warmup → warmup:write
- list_linkedin_*, get_linkedin_* → linkedin:read
- pause/resume_linkedin_campaign, enroll_in_linkedin_campaign → linkedin:write (+ campaigns:write for pause/resume)
- list_suppressions → suppressions:read
- add_to_suppression_list → suppressions:write
- get_job_status → jobs:read
Rate Limits (per workspace, per minute):
- Read tools: 120 / min
- Write tools: 30 / min
- LinkedIn writes: 10 / min (stricter — safety)
- Bulk operations: 5 / min
These are enforced by Upstash Redis at the MCP layer. Your underlying LinkedIn daily/weekly caps and warmup pacing are enforced separately by the scheduler — MCP cannot bypass them.
Pricing:
MCP access is included with any active WarmySender subscription. No separate charge. Your API key usage counts toward the rate limits above.
Next Steps:
See the guide "MCP Server — Install in Claude Desktop / Claude Code / Cursor / Windsurf / Zed" for copy-paste install snippets for each client. See "MCP Server — Available Tools Reference" for the full list of 30 tools. See "MCP Server — Safety, Scopes, and Rate Limits" for security and limits deep-dive.
Full dedicated reference: warmysender.com/mcp