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 remotohttps://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 Pluginsplugin.json, mcp.json (agent-plugins.org)
Extensión de Gemini CLIgemini-extension.json
Manifiesto del Registro MCPserver.json (io.github.AddisonHoff/sendsets)
Especificación OpenAPI 3.1openapi.json
Documentacióndocs.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 sendsets con Homebrew o Scoop desde AddisonHoff/homebrew-tap, o desde un archivo de lanzamiento verificado contra su checksums.txt publicado. La CLI solo habla con https://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.