Sendsets
E-mail frio para agentes de IA: conecte e aqueça caixas de entrada, lance campanhas de saída, adicione leads e responda a respostas.
Servidor MCP hospedado
npx add-mcp 'https://api.sendsetsapi.com/v1/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Sendsets: a API de cold email para agentes de IA
Sendsets oferece aos agentes de IA uma forma programável de executar cold email. Um agente (Claude Code, Codex, Cursor, Gemini CLI, ChatGPT ou seu próprio código) pode conectar caixas de envio, aquecê-las, criar e lançar campanhas de prospecção, adicionar leads e ler e responder e-mails por meio de um servidor MCP, uma CLI ou uma API REST, em vez de um painel de vendas.
Este repositório é o lar público e voltado para agentes da Sendsets:
| O quê | Onde |
|---|---|
| Servidor MCP remoto | https://api.sendsetsapi.com/v1/mcp (HTTP streamable, OAuth 2.1 ou chave de API) |
Habilidades do agente (SKILL.md) | skills/send-cold-email, skills/sendsets, skills/sendsets-cli |
| Marketplace de plugins do Claude Code | .claude-plugin/marketplace.json |
| Marketplace de plugins do Codex | .agents/plugins/marketplace.json, .codex-plugin/plugin.json |
| Manifesto de Agent Plugins | plugin.json, mcp.json (agent-plugins.org) |
| Extensão do Gemini CLI | gemini-extension.json |
| Manifesto do MCP Registry | server.json (io.github.AddisonHoff/sendsets) |
| Especificação OpenAPI 3.1 | openapi.json |
| Documentação | docs.sendsetsapi.com |
Cadastre-se em app.sendsetsapi.com. Gratuito para até 10 caixas de e-mail.
O que um agente pode fazer com isso
O servidor MCP e a API REST expõem as mesmas ferramentas da camada de serviço. O que uma credencial pode ver é limitado pelos escopos que lhe foram concedidos.
- Campanhas: criar um rascunho, adicionar e editar etapas de sequência, escolher caixas de envio, visualizar leads, logs e estatísticas, iniciar e parar
- Leads e contatos: adicionar, pesquisar, etiquetar, editar em massa, ler cronologias e e-mails enviados, gerenciar segmentos
- Caixas de e-mail: listar e inspecionar caixas conectadas, ajustar limites, alternar aquecimento, definir domínios de rastreamento, verificar o status do aquecimento
- Caixa de entrada e respostas: listar e ler conversas, redigir e enviar respostas, etiquetar, adiar, cancelar envios agendados
- Execuções: execuções de campanha duráveis, idempotentes e com pré-validação (
create_run,get_run,list_runs,cancel_run) - Supressões, análises e webhooks: gerenciar a lista de não contato, ler análises do painel, gerenciar webhooks assinados
As ferramentas da classe de envio (start_campaign, compose_email, send_reply e uma create_run autônoma) passam por uma política vinculada à credencial. Uma chamada retorna executed, awaiting_approval (uma pessoa aprova no painel em até 30 minutos) ou blocked. A aprovação nunca pode sobrepor uma ausência de opt-out, uma supressão ou uma verificação de saúde da caixa de e-mail.
Conecte o servidor MCP
O servidor anuncia metadados de recurso protegido OAuth 2.1 (RFC 9728) e suporta registro dinâmico de clientes, então clientes MCP que falam OAuth fazem seu login pelo navegador sem precisar colar chave alguma. Uma chave de API estática ssk_ do painel também funciona, como Authorization: Bearer ssk_....
Claude Code
claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcp
Ou instale o plugin, que adiciona o servidor MCP e as habilidades juntos:
/plugin marketplace add AddisonHoff/sendsets
/plugin install sendsets@sendsets
Claude (claude.ai e Claude Desktop): Configurações > Conectores > Adicionar conector personalizado, URL https://api.sendsetsapi.com/v1/mcp.
Codex
codex plugin marketplace add AddisonHoff/sendsets # MCP server + skills as a plugin
ou apenas o servidor MCP:
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
Qualquer cliente com chave estática
{
"mcpServers": {
"sendsets": {
"type": "http",
"url": "https://api.sendsetsapi.com/v1/mcp",
"headers": { "Authorization": "Bearer ssk_..." }
}
}
}
Instale as habilidades
send-cold-email é o caminho direto: pegue uma lista de leads e envie uma sequência de cold email com follow-ups, desde a verificação da caixa até o lançamento e as respostas. A habilidade sendsets ensina um agente a ler seu produto, propor cinco fluxos de prospecção que usam o próprio produto e depois construir e executar o que você escolher. A habilidade sendsets-cli é a referência completa para operar a Sendsets a partir de um terminal.
npx skills add AddisonHoff/sendsets
Ou copie skills/sendsets para ~/.claude/skills/ (Claude Code) ou ~/.codex/skills/ (Codex). Os mesmos arquivos são servidos em https://sendsetsapi.com/skills/sendsets/SKILL.md, e https://sendsetsapi.com/claude.md é um ponto de partida de um único link para qualquer agente de codificação.
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, depois scoop install sendsets. Arquivos e checksums.txt para todas as plataformas estão em sendsets-releases. A CLI faz login como pessoa e fala apenas com a API REST pública; todo comando aceita --json.
API REST
URL base https://api.sendsetsapi.com/v1. Erros trazem um code estável e request_id, listas usam data mais cursor pagination, e gravações com efeitos colaterais aceitam um Idempotency-Key. Especificação: openapi.json. Referência: docs.sendsetsapi.com/api.
A que este plugin se conecta
- O servidor MCP em
https://api.sendsetsapi.com/v1/mcp, via HTTPS, autenticado com seu próprio login OAuth ou chave de API. Cada chamada de ferramenta lê ou altera dados no seu espaço de trabalho Sendsets; as ferramentas de envio entregam e-mails reais das suas caixas conectadas. - As habilidades podem instruir o agente a instalar a CLI
sendsetscom Homebrew ou Scoop a partir de AddisonHoff/homebrew-tap, ou de um arquivo de lançamento verificado contra seuchecksums.txtpublicado. A CLI fala apenas comhttps://api.sendsetsapi.com. - Nada mais. O plugin não tem hooks, nenhum servidor local e nenhum script que execute na instalação, e sua configuração MCP nunca lê credenciais do seu ambiente.
Padrões de segurança
A Sendsets é conservadora por padrão: 50 e-mails de campanha por caixa por dia, 600 segundos entre envios de uma mesma caixa, aquecimento gradual, supressão automática em rejeições, reclamações e cancelamentos de inscrição, e parada ao receber resposta. Um envio de teste e um lançamento ao vivo são decisões separadas, e um agente não deve lançar uma campanha a menos que o usuário tenha pedido para enviar.
Licença
As habilidades e manifestos neste repositório são licenciados sob Apache-2.0.