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 remotohttps://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 Pluginsplugin.json, mcp.json (agent-plugins.org)
Extensão do Gemini CLIgemini-extension.json
Manifesto do MCP Registryserver.json (io.github.AddisonHoff/sendsets)
Especificação OpenAPI 3.1openapi.json
Documentaçãodocs.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 sendsets com Homebrew ou Scoop a partir de AddisonHoff/homebrew-tap, ou de um arquivo de lançamento verificado contra seu checksums.txt publicado. A CLI fala apenas com https://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.