Sendsets MCP server
Commit Sep 27, 2026Lets AI agents run cold email campaigns, manage mailboxes, warm up accounts, and handle replies through a programmable API.
Also known as AddisonHoff/sendsets
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Sep 27, 2026
- License
- Apache-2.0
What is Sendsets MCP?
Sendsets lets AI agents run cold email campaigns, manage mailboxes, warm up accounts, and handle replies through a programmable API.
Summary generated from the project's README
About Sendsets MCP server
Sendsets provides a programmable interface for AI agents to manage cold email operations without using a traditional sales dashboard. It allows agents to connect mailboxes, perform account warmup, launch outbound campaigns, and manage lead lists. The service is designed for developers using clients like Claude Code, Cursor, Codex, or Gemini CLI, enabling these tools to act as autonomous sales assistants.
Users can connect to the remote MCP server via HTTPS using OAuth 2.1 or a static API key. The system includes safety features such as a 50 email per day limit per mailbox and automatic pauses upon receiving replies. It also supports a human-in-the-loop workflow where certain actions can be set to require manual approval in a dashboard before they are executed. The platform is free for up to 10 mailboxes.
What you can do with it
- 1Automate outbound email sequencesAn agent can take a list of leads and execute a full sequence including follow-ups and mailbox health checks.
- 2Manage mailbox health and warmupYou can instruct an AI to monitor connected mailboxes and enable warmup features to maintain sender reputation.
- 3Handle incoming lead repliesAn AI client can read through email threads to draft and send responses to potential customers.
- 4Maintain contact suppression listsDevelopers can use the agent to ensure that people who opt out are automatically added to a do-not-contact list.
Written from the project's README. Every use case is checked against a quote from it.
How to install Sendsets MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Sendsets MCP in Claude Code
$ claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcpInstall Sendsets MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sendsets": {
"url": "https://api.sendsetsapi.com/v1/mcp"
}
}
}Install Sendsets MCP in VS Code
.vscode/mcp.json
{
"servers": {
"sendsets": {
"type": "http",
"url": "https://api.sendsetsapi.com/v1/mcp"
}
}
}Install Sendsets MCP in VS Code CLI
$ code --add-mcp '{"name":"sendsets","type":"http","url":"https://api.sendsetsapi.com/v1/mcp"}'Install Sendsets MCP in Codex
$ codex mcp add sendsets --url https://api.sendsetsapi.com/v1/mcpInstall Sendsets MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.sendsets] url = "https://api.sendsetsapi.com/v1/mcp"
Install Sendsets MCP in Gemini CLI
$ gemini mcp add -s user --transport http sendsets https://api.sendsetsapi.com/v1/mcpInstall Sendsets MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sendsets": {
"url": "https://api.sendsetsapi.com/v1/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableaddisonhoff/sendsets is public and reachablegithub.com/addisonhoff/sendsets ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-27github.com/addisonhoff/sendsets ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSendsets: the cold email API for AI agents
Sendsets gives AI agents a programmable way to run cold email. An agent (Claude Code, Codex, Cursor, Gemini CLI, ChatGPT, or your own code) can connect sending mailboxes, warm them up, build and launch outbound campaigns, add leads, and read and answer replies through an MCP server, a CLI, or a REST API instead of a sales dashboard.
This repository is the public, agent-facing home of Sendsets:
| What | Where |
|---|---|
| Remote MCP server | https://api.sendsetsapi.com/v1/mcp (streamable HTTP, OAuth 2.1 or API key) |
Agent skills (SKILL.md) |
skills/send-cold-email, skills/sendsets, skills/sendsets-cli |
| Claude Code plugin marketplace | .claude-plugin/marketplace.json |
| Codex plugin marketplace | .agents/plugins/marketplace.json, .codex-plugin/plugin.json |
| Agent Plugins manifest | plugin.json, mcp.json (agent-plugins.org) |
| Gemini CLI extension | gemini-extension.json |
| MCP Registry manifest | server.json (io.github.AddisonHoff/sendsets) |
| OpenAPI 3.1 spec | openapi.json |
| Docs | docs.sendsetsapi.com |
Sign up at app.sendsetsapi.com. Free for up to 10 mailboxes.
What an agent can do with it
The MCP server and the REST API expose the same service-layer tools. What a credential can see is limited by the scopes it was granted.
- Campaigns: create a draft, add and edit sequence steps, pick sender mailboxes, view leads, logs and stats, start and stop
- Leads and contacts: add, search, tag, bulk edit, read timelines and sent mail, manage segments
- Mailboxes: list and inspect connected mailboxes, adjust limits, toggle warmup, set tracking domains, check warmup standing
- Inbox and replies: list and read threads, draft and send replies, label, snooze, cancel scheduled sends
- Runs: durable, idempotent, preflighted campaign runs (
create_run,get_run,list_runs,cancel_run) - Suppressions, analytics, webhooks: manage the do-not-contact list, read dashboard analytics, manage signed webhooks
Send-class tools (start_campaign, compose_email, send_reply, and an autonomous create_run) go through a credential-bound policy. A call returns executed, awaiting_approval (a person approves it in the dashboard within 30 minutes), or blocked. Approval can never override a missing opt-out, a suppression, or a mailbox health check.
Connect the MCP server
The server advertises OAuth 2.1 protected-resource metadata (RFC 9728) and supports dynamic client registration, so MCP clients that speak OAuth sign you in through the browser with no key to paste. A static ssk_ API key from the dashboard works too, as Authorization: Bearer ssk_....
Claude Code
claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcp
Or install the plugin, which adds the MCP server and the skills together:
/plugin marketplace add AddisonHoff/sendsets
/plugin install sendsets@sendsets
Claude (claude.ai and Claude Desktop): Settings > Connectors > Add custom connector, URL https://api.sendsetsapi.com/v1/mcp.
Codex
codex plugin marketplace add AddisonHoff/sendsets # MCP server + skills as a plugin
or just the MCP server:
codex mcp add sendsets --url https://api.sendsetsapi.com/v1/mcp
codex mcp login sendsets
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"sendsets": { "url": "https://api.sendsetsapi.com/v1/mcp" }
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"sendsets": { "type": "http", "url": "https://api.sendsetsapi.com/v1/mcp" }
}
}
Gemini CLI
gemini extensions install https://github.com/AddisonHoff/sendsets
Any client with a static key
{
"mcpServers": {
"sendsets": {
"type": "http",
"url": "https://api.sendsetsapi.com/v1/mcp",
"headers": { "Authorization": "Bearer ssk_..." }
}
}
}
Install the skills
send-cold-email is the direct path: take a lead list and send a cold email sequence with follow-ups, from mailbox check to launch and replies. The sendsets skill teaches an agent to read your product, propose five outbound workflows that use the product itself, then build and run the one you pick. The sendsets-cli skill is the full reference for driving Sendsets from a terminal.
npx skills add AddisonHoff/sendsets
Or copy skills/sendsets into ~/.claude/skills/ (Claude Code) or ~/.codex/skills/ (Codex). The same files are served at https://sendsetsapi.com/skills/sendsets/SKILL.md, and https://sendsetsapi.com/claude.md is a one-link starting point for any coding agent.
CLI
brew install addisonhoff/tap/sendsets # macOS, Linux
sendsets login --hostname sendsetsapi.com
sendsets doctor --json
Windows: scoop bucket add sendsets https://github.com/AddisonHoff/homebrew-tap, then scoop install sendsets. Archives and checksums.txt for every platform are on sendsets-releases. The CLI signs in as a person and speaks only the public REST API; every command takes --json.
REST API
Base URL https://api.sendsetsapi.com/v1. Errors carry a stable code and request_id, lists use data plus cursor pagination, and side-effectful writes accept an Idempotency-Key. Spec: openapi.json. Reference: docs.sendsetsapi.com/api.
What this plugin connects to
- The MCP server at
https://api.sendsetsapi.com/v1/mcp, over HTTPS, authenticated with your own OAuth sign-in or API key. Every tool call reads or changes data in your Sendsets workspace; send tools deliver real email from your connected mailboxes. - The skills may tell the agent to install the
sendsetsCLI with Homebrew or Scoop from AddisonHoff/homebrew-tap, or from a release archive checked against its publishedchecksums.txt. The CLI talks only tohttps://api.sendsetsapi.com. - Nothing else. The plugin has no hooks, no local server and no scripts that run on install, and its MCP configuration never reads credentials from your environment.
Safety defaults
Sendsets is conservative by default: 50 campaign emails per mailbox per day, 600 seconds between sends from one mailbox, gradual warmup, automatic suppression on bounces, complaints and unsubscribes, and a stop on reply. A test send and a live launch are separate decisions, and an agent should not launch a campaign unless the user asked it to send.
License
The skills and manifests in this repository are licensed under Apache-2.0.
Sendsets MCP questions
How do I add Sendsets MCP to Claude Code?
Run claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Sendsets MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How much does Sendsets cost?
The service is free for up to 10 mailboxes.
What safety measures are in place for email sending?
Sendsets uses conservative defaults including limits on daily emails per mailbox, delays between sends, gradual warmup, and automatic suppression for bounces or unsubscribes.
Can an AI agent launch a campaign autonomously?
Send-class tools can return a status of 'awaiting_approval', requiring a person to approve the action in the dashboard within 30 minutes.