Sendsets
Correo electrónico en frío para agentes de IA: conecta y calienta buzones, lanza campañas de salida, añade clientes potenciales y responde a las respuestas.
Servidor MCP alojado
npx add-mcp 'https://api.sendsetsapi.com/v1/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Sendsets: la API de correo en frío para agentes de IA
Sendsets ofrece a los agentes de IA una forma programable de ejecutar correos en frío. Un agente (Claude Code, Codex, Cursor, Gemini CLI, ChatGPT, o tu propio código) puede conectar buzones de envío, calentarlos, crear y lanzar campañas de prospección, añadir clientes potenciales, y leer y responder correos a través de un servidor MCP, una CLI, o una API REST en lugar de un panel de ventas.
Este repositorio es el hogar público y orientado a agentes de Sendsets:
| Qué | Dónde |
|---|---|
| Servidor MCP remoto | https://api.sendsetsapi.com/v1/mcp (HTTP transmisible, OAuth 2.1 o clave API) |
Habilidades de agente (SKILL.md) | skills/send-cold-email, skills/sendsets, skills/sendsets-cli |
| Mercado de plugins de Claude Code | .claude-plugin/marketplace.json |
| Mercado de plugins de Codex | .agents/plugins/marketplace.json, .codex-plugin/plugin.json |
| Manifiesto de Agent Plugins | plugin.json, mcp.json (agent-plugins.org) |
| Extensión de Gemini CLI | gemini-extension.json |
| Manifiesto del Registro MCP | server.json (io.github.AddisonHoff/sendsets) |
| Especificación OpenAPI 3.1 | openapi.json |
| Documentación | docs.sendsetsapi.com |
Regístrate en app.sendsetsapi.com. Gratis hasta 10 buzones.
Qué puede hacer un agente con ello
El servidor MCP y la API REST exponen las mismas herramientas de capa de servicio. Lo que una credencial puede ver está limitado por los alcances que se le hayan otorgado.
- Campañas: crear un borrador, añadir y editar pasos de secuencia, elegir buzones de remitente, ver clientes potenciales, registros y estadísticas, iniciar y detener
- Clientes potenciales y contactos: añadir, buscar, etiquetar, editar en masa, leer cronologías y correos enviados, gestionar segmentos
- Buzones: listar e inspeccionar buzones conectados, ajustar límites, activar el calentamiento, configurar dominios de seguimiento, comprobar el estado del calentamiento
- Bandeja de entrada y respuestas: listar y leer hilos, redactar y enviar respuestas, etiquetar, posponer, cancelar envíos programados
- Ejecuciones: ejecuciones de campaña duraderas, idempotentes y con verificación previa (
create_run,get_run,list_runs,cancel_run) - Supresiones, análisis y webhooks: gestionar la lista de no contacto, leer análisis del panel, gestionar webhooks firmados
Las herramientas de clase de envío (start_campaign, compose_email, send_reply, y una create_run autónoma) pasan por una política vinculada a la credencial. Una llamada devuelve executed, awaiting_approval (una persona lo aprueba en el panel en un plazo de 30 minutos), o blocked. La aprobación nunca puede anular una exclusión voluntaria faltante, una supresión o una comprobación de salud del buzón.
Conectar el servidor MCP
El servidor anuncia metadatos de recurso protegido OAuth 2.1 (RFC 9728) y admite registro dinámico de clientes, por lo que los clientes MCP que hablan OAuth te autentican a través del navegador sin necesidad de pegar una clave. Una clave API estática ssk_ del panel también funciona, como Authorization: Bearer ssk_....
Claude Code
claude mcp add --transport http sendsets https://api.sendsetsapi.com/v1/mcp
O instala el plugin, que añade el servidor MCP y las habilidades juntos:
/plugin marketplace add AddisonHoff/sendsets
/plugin install sendsets@sendsets
Claude (claude.ai y Claude Desktop): Configuración > Conectores > Añadir conector personalizado, URL https://api.sendsetsapi.com/v1/mcp.
Codex
codex plugin marketplace add AddisonHoff/sendsets # MCP server + skills as a plugin
o solo el 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
Cualquier cliente con una clave estática
{
"mcpServers": {
"sendsets": {
"type": "http",
"url": "https://api.sendsetsapi.com/v1/mcp",
"headers": { "Authorization": "Bearer ssk_..." }
}
}
}
Instalar las habilidades
send-cold-email es la ruta directa: toma una lista de clientes potenciales y envía una secuencia de correos en frío con seguimientos, desde la comprobación del buzón hasta el lanzamiento y las respuestas. La habilidad sendsets enseña a un agente a leer tu producto, proponer cinco flujos de trabajo de prospección que utilicen el propio producto, y luego construir y ejecutar el que elijas. La habilidad sendsets-cli es la referencia completa para manejar Sendsets desde una terminal.
npx skills add AddisonHoff/sendsets
O copia skills/sendsets en ~/.claude/skills/ (Claude Code) o ~/.codex/skills/ (Codex). Los mismos archivos se sirven en https://sendsetsapi.com/skills/sendsets/SKILL.md, y https://sendsetsapi.com/claude.md es un punto de partida de un solo enlace para cualquier agente de codificación.
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, luego scoop install sendsets. Los archivos y checksums.txt para cada plataforma están en sendsets-releases. La CLI inicia sesión como persona y solo habla con la API REST pública; cada comando toma --json.
API REST
URL base https://api.sendsetsapi.com/v1. Los errores llevan un code y request_id estables, las listas usan data más cursor pagination, y las escrituras con efectos secundarios aceptan un Idempotency-Key. Especificación: openapi.json. Referencia: docs.sendsetsapi.com/api.
A qué se conecta este plugin
- El servidor MCP en
https://api.sendsetsapi.com/v1/mcp, a través de HTTPS, autenticado con tu propio inicio de sesión OAuth o clave API. Cada llamada de herramienta lee o cambia datos en tu espacio de trabajo de Sendsets; las herramientas de envío entregan correos reales desde tus buzones conectados. - Las habilidades pueden indicar al agente que instale la CLI
sendsetscon Homebrew o Scoop desde AddisonHoff/homebrew-tap, o desde un archivo de lanzamiento verificado contra suchecksums.txtpublicado. La CLI solo habla conhttps://api.sendsetsapi.com. - Nada más. El plugin no tiene hooks, ni servidor local, ni scripts que se ejecuten al instalar, y su configuración MCP nunca lee credenciales de tu entorno.
Valores predeterminados de seguridad
Sendsets es conservador por defecto: 50 correos de campaña por buzón al día, 600 segundos entre envíos desde un mismo buzón, calentamiento gradual, supresión automática en rebotes, quejas y bajas, y una parada ante respuestas. Un envío de prueba y un lanzamiento en vivo son decisiones separadas, y un agente no debe lanzar una campaña a menos que el usuario se lo haya pedido.
Licencia
Las habilidades y manifiestos de este repositorio están licenciados bajo Apache-2.0.