{
  "markdown": "# @warmysender/mcp\n\nOfficial launcher for the [WarmySender](https://warmysender.com) [MCP](https://modelcontextprotocol.io) server.\n\nConnects AI assistants — Claude Desktop, Claude Code, Cursor, Windsurf, Zed — to your WarmySender workspace so they can manage cold email campaigns, warmup mailboxes, LinkedIn outreach, and prospects with natural language.\n\n## Quick start\n\n### Claude Code\n\n```bash\nclaude mcp add warmysender -- npx -y @warmysender/mcp --api-key=ws_YOUR_API_KEY\n```\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"warmysender\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@warmysender/mcp\", \"--api-key=ws_YOUR_API_KEY\"]\n    }\n  }\n}\n```\n\n### Cursor / Windsurf / Zed\n\nSame `npx -y @warmysender/mcp --api-key=ws_...` command in each client's MCP server config.\n\n## Get an API key\n\n1. Sign in at https://warmysender.com\n2. Settings → API Keys → Create new key\n3. Pick the scopes you want to expose (e.g. `campaigns:read`, `linkedin:read`, `warmup:write`)\n\n## OAuth (no API key needed)\n\nIf you omit `--api-key`, the launcher falls back to the OAuth 2.1 flow. Your AI client will open a browser window to `warmysender.com` for consent; the resulting access token is stored by `mcp-remote` and reused on subsequent runs.\n\n## What's available\n\n- 30+ tools across campaigns, warmup, LinkedIn, prospects, suppressions\n- All actions route through the same schedulers as the UI — LinkedIn safety limits, warmup ramp, and per-mailbox pacing are enforced identically\n- No `delete_*`, no direct-send, no account-connect tools (those stay in the UI by design)\n\nFull tool list, scope map, and safety invariants: https://warmysender.com/mcp\n\n## Environment variables\n\n- `WARMYSENDER_API_KEY` — alternative to `--api-key`\n- `WARMYSENDER_MCP_URL` — override the server URL (defaults to `https://warmysender.com/mcp`); useful for self-hosted or staging\n\n## License\n\nMIT",
  "bytes": 1912,
  "sha": "3e4ceec9d433dccc7fdc449be92bda4e2cbcde075bd51dc4886228519be3b43b",
  "repo_slug": "",
  "fonte": "npm",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_warmysender_mcp_189fe10c/readme"
}