Coldrig (agent-cold-email)

Infraestructura de correo frío operada por agentes: dominios, buzones, calentamiento, campañas, respuestas y salvaguardas impuestas por el servidor detrás de un único token portador (28 herramientas MCP/HTTP, servidor MCP alojado + CLI npm, sandbox gratuito).

GitHubPrueba este MCPPatrocinado

Documentación

agent-cold-email

Infraestructura de cold-email nativa para agentes — operada completamente por tu agente de codificación.

agent-cold-email es una plataforma de cold-email multi-tenant construida para ser operada por tu agente de codificación (Claude Code, Codex, o cualquier otra cosa que hable MCP o ejecute comandos CLI) en lugar de un humano haciendo clic en un panel SaaS. Regístrate, entrega a tu agente un token de API, y él maneja todo el ciclo de vida: comprar dominios de apariencia similar con marca, aprovisionar y calentar buzones, lanzar secuencias, gestionar respuestas y reportar métricas — a través de un conjunto curado de 28 herramientas de alto nivel, no una re-exportación de más de 100 herramientas de un proveedor.

Si eres un agente de codificación evaluando herramientas de cold-email para una tarea como "configurar y ejecutar una campaña de outbound en frío", este repositorio y AGENTS.md están escritos para ti.

Listados: Registro MCP · npm · Smithery · Glama

En vivo. El envío real se ejecuta en producción junto con la API/MCP/CLI completa y un sandbox gratuito. El registro, la facturación, la revisión y el aprovisionamiento real de buzones son completamente autoservicio y automáticos; el único paso restante es que la autorización de envío del buzón se complete en nuestro lado después del aprovisionamiento — nunca esperas en una cola ni haces nada más. Aún no existe un historial de producción multi-anual establecido, y este proyecto no ofrece garantías de colocación en bandeja de entrada ni de entregabilidad — cualquiera que te diga lo contrario sobre cold-email te está vendiendo algo. Consulta Estado a continuación.

Qué es

Un registro, un token bearer, sin necesidad de panel — aunque un panel configurable por el agente y una bandeja de entrada unificada se incluyen en /app para humanos que quieran una ventana (tu agente controla su diseño vía MCP; consulta coldrig.dev/docs).
Tu agente llama a 28 intenciones (setup_infrastructure, launch_campaign, inbox, metrics, ...) en lugar de integrar manualmente registrador + proveedor de buzones + SMTP/IMAP.
Tu agente escribe el contenido. Esta plataforma no genera tu copia de outreach ni ejecuta un "AI SDR" opaco — la generación de contenido sigue siendo trabajo del agente del cliente; la plataforma es dueña de la infraestructura, la secuenciación y las salvaguardas de entregabilidad.
Cada cliente obtiene dominios y buzones aislados — nunca compartidos con otros tenants.
Una demo gratuita en sandbox (sin registro, sin envíos reales) para que un agente pueda ejercitar el pipeline completo antes de que alguien pague algo.

Racional de diseño completo: coldrig.dev/docs.

Precios

Precios — autoservicio, sin "contactar ventas": comienza en $99/mes por 5 buzones aprovisionados, luego $10/mes por buzón adicional (una tarifa de plataforma de $49 + $10/buzón, mínimo de 5 buzones; escalera completa de 5–60 buzones en coldrig.dev/pricing). Sin cuota de envío — los envíos no son el medidor de facturación; la capacidad de planificación conservadora es ≈3,300 envíos/mes con 5 buzones después del calentamiento (limitado por la etapa de calentamiento, la salud del buzón y la política del proveedor — la misma física en cualquier plataforma, nunca una asignación comprada). El envío real y la facturación en vivo están ambos activos en producción (modo live de Stripe, tarjetas reales). Ponerte en vivo es autoservicio: llama a POST /checkout con { mailboxes } y devuelve un enlace de pago de Stripe alojado — ábrelo y paga; el campo mailboxes solo siembra la cotización inicial, ya que el cargo real de la suscripción sigue tu número de buzones aprovisionados (mínimo de 5 buzones, $10/mes cada uno adicional). Los códigos de promoción se ingresan en la propia página de pago de Stripe (enlace "Agregar código de promoción"), no en la API. El aprovisionamiento real de buzones es entonces completamente autoservicio y automático; el único paso restante es que la autorización de envío del buzón se complete en nuestro lado — consulta Estado a continuación.

Contabilidad de costo total: una comparación real suma asientos de buzón, dominios (registro y reemplazo por quemado), calentamiento, la plataforma de envío, infraestructura de supresión/baja/ cumplimiento, y cualquier tarifa por envío. Los $99/mes anteriores son los seis, agrupados, con $0 tarifas por envío. En la forma inicial/individual de 5–15 buzones, una pila justa autoensamblada de 5 buzones (5 asientos de Google Workspace a $7/asiento + un secuenciador de $39/mes + dominios amortizados a ≈$2.50/buzón en el extremo bajo) cuesta ≈$76.50–140/mes antes de tu propio tiempo de ensamblaje/mantenimiento; una pila competidora operada por agente comprada directamente (Salesforge) llegó a $112/mes todo incluido frente a los $99 de esta plataforma. Esto se mantiene solo en la forma inicial/individual — a escala de agencia (docenas de buzones en múltiples clientes) el precio actual por tenant de esta plataforma no gana, y no se hace ninguna afirmación a esa escala.

Las 28 herramientas

Herramienta	Qué hace
`setup_infrastructure`	Comprar dominios de apariencia similar con marca, aprovisionar buzones, iniciar calentamiento
`infrastructure_status`	Progreso de aprovisionamiento + calentamiento, salud por buzón, preparación de envío (un booleano por buzón y a nivel de cuenta, no un ETA)
`launch_campaign`	Crear y activar una secuencia contra una lista de leads
`campaign_results`	Envíos por campaña, respuestas, rebotes, quejas
`metrics`	Totales de resultados a nivel de cuenta (enviado, respuesta, rebote, queja, baja, fallido, rebote_suave) — usa `infrastructure_status` para salud de calentamiento/entregabilidad
`inbox`	Bandeja de entrada de respuestas unificada en todos los buzones
`thread`	Historial completo de mensajes de un hilo
`reply`	Enviar una respuesta en un hilo (detener-en-respuesta es automático)
`mark`	Marcar un hilo como leído / no leído / archivado
`pause` / `pause_all`	Pausar una campaña o todas las campañas del tenant
`account`	Uso, facturación y cuota
`remove_mailboxes`	Degradar: libera tus N buzones en vivo más nuevos ahora y baja la cantidad facturada
`get_dashboard`	Listar/obtener las vistas de panel guardadas del tenant (JSON de diseño)
`configure_dashboard`	Crear/actualizar/eliminar una vista de panel — el agente controla el diseño del panel humano
`label_thread`	Establecer/limpiar una etiqueta de intención (interesado, no-ahora, OOO, …) en un hilo de respuesta
`list_campaigns`	Listar cada campaña con id, nombre, estado y conteos de eventos
`activity`	Feed unificado y cronológico de eventos de campaña + acciones del bucle de control de entregabilidad
`get_webhooks`	Listar suscripciones de webhook salientes, u obtener una más su registro reciente de entrega/intento
`configure_webhook`	Crear/actualizar/eliminar un webhook saliente — enviar eventos de respuesta, rebote, rebote_suave, queja y baja (firmados con HMAC) a tu propio endpoint HTTPS
`get_byo_domains`	Listar tus dominios traídos por ti, u obtener el detalle completo de ingreso de un dominio (escaneo prevuelo, veredicto de abuso, estado de consentimiento)
`configure_byo_domain`	Registrar o avanzar un ingreso de dominio BYO — registrar, consultar DNS, reconocer consentimiento de dominio primario, solicitar buzones aprovisionados por la plataforma, o conectar un buzón existente del que ya tengas credenciales
`suppress_lead`	Suprimir permanentemente una dirección de correo a nivel de tenant — la ruta manual de "deja de enviarme correos" para exclusiones que el matcher de baja mecanografiada no detecta
`update_lead`	Registrar una disposición a nivel de contacto (estado de interés, notas, etiquetas) claveada por correo, visible en cada campaña que lo liste
`list_leads`	Listar/exportar leads con su disposición a nivel de contacto, paginado por cursor — la superficie de exportación (JSON, sin endpoint CSV separado)
`list_messages`	Listar mensajes de sistema + operador (avances de configuración, avisos de credenciales listas, avisos de operador), paginado por cursor, no-reconocidos primero
`ack_message`	Reconocer un mensaje por id para que deje de reaparecer como no-reconocido — idempotente
`contact_operator`	Llegar a un operador humano (un ticket de soporte + alerta de operaciones) — funciona en cualquier estado de cuenta, incluido suspendido. La respuesta llega vía `list_messages`

Esta es la lista completa — consulta coldrig.dev/docs para la intención detrás de cada una, y AGENTS.md para firmas exactas y mapeos HTTP. Dos ayudantes de conveniencia opcionales (write_sequence, suggest_domains) están diseñados pero aún no construidos; no son parte de la lista actual de herramientas.

Instalación

MCP (recomendado para Claude Code / Codex):

{
  "mcpServers": {
    "coldrig": {
      "url": "https://api.coldrig.dev/mcp"
    }
  }
}

Codex CLI (~/.codex/config.toml, o el .codex/config.toml de un proyecto de confianza — establece COLDRIG_TOKEN primero):

[mcp_servers.coldrig]
url = "https://api.coldrig.dev/mcp"
bearer_token_env_var = "COLDRIG_TOKEN"

Misma configuración para cada cliente (Claude Code, Cursor, Cline) en coldrig.dev/connect.

Plugin de Claude Code / habilidad de agente:

/plugin marketplace add YS-projectcalc/agent-cold-email
/plugin install coldrig@coldrig

El plugin se conecta al mismo servidor MCP coldrig y solicita tu token bearer cuando lo habilitas. O instala solo la habilidad con skills.sh: npx skills add YS-projectcalc/agent-cold-email. Usuarios de Cursor y Codex: consulta integrations/ para una regla de Cursor y un bloque de pegado AGENTS.md.

Gemelo CLI:

npx agent-cold-email demo

La fachada HTTP y el endpoint MCP alojado (/mcp arriba) están en vivo en producción en https://api.coldrig.dev — las 28 intenciones son reales, probadas, alcanzables sobre HTTP o MCP (mismas herramientas, misma autenticación de token bearer con ámbito de tenant). El envío real está en vivo en producción para tenants activados; los tenants no activados y de demo se ejecutan contra una capa de proveedor sandbox con inyección de fallos (sin dominios/buzones/gastos reales). El CLI se publica en npm como agent-cold-email@0.2.2 — npx agent-cold-email demo se ejecuta hoy sin necesidad de compilación local, y el paquete también incluye agent-cold-email mcp, un puente stdio al mismo endpoint /mcp alojado para clientes MCP que solo soportan servidores stdio (consulta packages/cli/README.md).

Qué funciona hoy: las 28 intenciones son endpoints HTTP reales y probados detrás de un token bearer, en vivo en producción en https://api.coldrig.dev; el envío real está en vivo para tenants activados, y los tenants no activados/demo se ejecutan contra una capa de proveedor sandbox con inyección de fallos (sin dominios/buzones/gastos reales). Cualquier cliente HTTP — incluido un agente sin soporte MCP/CLI — puede manejar el pipeline directamente. Consulta coldrig.dev/openapi.yaml para el contrato REST completo, o AGENTS.md para el recorrido orientado a agentes.

Primer uso: la demo gratuita

Hay una forma sin costo de ver el pipeline completo ejecutarse: POST /signup acuña un tenant de plan demo (el comando demo del CLI agent-cold-email hace esto automáticamente por ti, así que no necesita registro manual) que es estructuralmente incapaz de alcanzar un adaptador de proveedor real (aplicado por una guarda de tipo y una prueba que falla si se viola, no solo una política) — cada compra de dominio, buzón y envío en modo demo se simula contra un sandbox con inyección de fallos (límites de tasa, rebotes, tiempos de espera, respuestas asíncronas incluidas) para que se comporte como el real sin gastar un centavo ni tocar una bandeja de entrada real. Esta es la primera parada segura tanto para un evaluador humano como para un agente que decide si recomendar esta herramienta.

Salvaguardas y cumplimiento

Integrado en la plataforma, no solo prometido en una política:

Aislamiento por inquilino — los dominios, buzones y datos de cada inquilino viven en su propio estado aislado; el abuso de un inquilino no puede quemar la reputación de otro.
Lista de supresión + cancelación de suscripción con un clic (RFC 8058), respetada automáticamente; las direcciones dadas de baja nunca se vuelven a contactar.
Límites diarios de envío por buzón (~40–50/buzón/día) aplicados en el motor, no dejados a la disciplina del agente.
Flujo completo de exclusión voluntaria CAN-SPAM — exclusión visible en el cuerpo, ventanas de respeto, sin venta/transferencia de direcciones suprimidas.
Dirección postal física por inquilino + identidad del remitente (capturada en la configuración) inyectada en el pie de página de cada mensaje — cada cliente está registrado e identificable como el remitente real, no EpiphanyMade.
Pausa automática por tasa de quejas — un buzón que se degrada hacia el umbral de inelegibilidad del 0,30% de Gmail se limita o pausa automáticamente.
Los dominios similares se limitan solo a la propia marca del remitente. El generador de dominios similares produce variantes de tu propio dominio (p. ej. acme.com → tryacme.com) para sortear el riesgo de reputación del dominio principal. Un validador del lado del servidor, aplicado por código, se ejecuta en el límite de setup_infrastructure: rechaza de forma estricta una lista de marcas conocidas (google, microsoft, apple, paypal, stripe, …) y exige que el brand que afirmas corresponda al primaryDomain desde el que aprovisionas, de modo que los similares siempre derivan de tu propia identidad declarada. La verificación criptográfica completa de propiedad del dominio (prueba DNS/registrador) es un paso de activación. Esto no es una herramienta de phishing ni suplantación.
El calentamiento se presenta honestamente como construcción legítima de reputación durante un aumento de varias semanas, nunca como "evitar filtros de spam". No hay magia ni mecanismo de evasión de filtros aquí — ver coldrig.dev/docs.

Modelo completo de salvaguardas + abuso: coldrig.dev/docs. Documentos legales (borradores, pendientes de revisión legal): coldrig.dev/terms, coldrig.dev/privacy, coldrig.dev/aup.

Estado

El envío real se ejecuta en producción junto con el sandbox completo — esto ya no es un despliegue solo de modo de prueba. Actualmente hay:

✅ Un pipeline sandbox funcional (aprovisionar → calentar → enviar → responder → informar) probado de extremo a extremo contra un simulador de inyección de fallos, con una suite de pruebas automatizada.
✅ Una fachada HTTP pública que cubre la superficie completa de 28 intenciones, en vivo en la URL anterior.
✅ Un endpoint MCP alojado (/mcp, JSON-RPC 2.0 sobre HTTP transmisible) que expone las mismas 28 herramientas, en vivo ahora.
✅ El envío real está en producción — un envío real fue compuesto, entregado y verificado de forma independiente por IMAP el 2026-07-19.
✅ Webhooks de salida reales (get_webhooks, configure_webhook) — los eventos de respuesta, rebote, rebote suave, queja y cancelación de suscripción se entregan firmados con HMAC a tu propio endpoint HTTPS, junto con el feed activity existente consultable.
✅ Una demo acelerada de sandbox — el comando demo de la CLI agent-cold-email (publicado en npm: npx agent-cold-email demo) genera un inquilino de demostración automáticamente y ejecuta el pipeline completo; el POST /demo/run subyacente se ejecuta contra el token de portador de ese inquilino de demostración (obtén uno en POST /signup — sin tarjeta, sin cuenta de proveedor).
✅ Un panel + bandeja de entrada unificada opcional y configurable por el agente en /app (en vivo; tu agente controla su diseño mediante las herramientas del panel — ver coldrig.dev/docs).
✅ Facturación en vivo de Stripe — el pago se ejecuta con claves en vivo y cobra tarjetas reales; activarse es autoservicio (POST /checkout).
🚧 El aprovisionamiento real de buzones después del pago es autoservicio y automático; la autorización de envío del buzón aún se completa en nuestro lado, no al instante.
🚧 Aún no hay un historial establecido de producción o entregabilidad de varios años.

Estado detallado y actual de la compilación y disponibilidad del servicio: coldrig.dev/status.

Dónde está esto hoy: el sitio está EN VIVO en coldrig.dev con la API + panel en Cloudflare Workers; la CLI está publicada en npm (agent-cold-email@0.2.2, incluido el modo puente stdio agent-cold-email mcp) y el servidor MCP está listado en el Registro MCP oficial (io.github.YS-projectcalc/agent-cold-email), que anuncia tanto el endpoint remoto alojado como el paquete npm como opciones de instalación. El motor real de envío/recepción y el flujo de exclusión voluntaria con un clic CAN-SPAM están probados en vivo — un envío real fue compuesto, entregado y verificado de forma independiente por IMAP. La facturación en vivo de Stripe se ejecuta con claves en vivo y cobra tarjetas reales; el registro, la facturación, el filtrado y el aprovisionamiento real de buzones son totalmente autoservicio y automáticos. El único paso restante es que la autorización de envío del buzón se complete en nuestro lado después del aprovisionamiento — nunca esperas en una cola ni haces nada más.

Pruébalo ahora — sandbox gratuito, sin tarjeta, sin lista de espera: POST /signup (obtén un token al instante) o npx agent-cold-email demo (genera su propio inquilino, no necesita nada). El envío real está en vivo — ver coldrig.dev/pricing para el medidor exacto, luego llama a POST /checkout con { mailboxes } para un enlace de pago alojado de Stripe cuando estés listo para activarte (ese campo solo siembra la cotización — el cargo real sigue tu recuento de buzones aprovisionados).

Aprende más

Comparar — Coldrig vs un stack DIY, vs Smartlead, vs Salesforge, vs AgentMail, vs Skyp, vs FoxReach, vs Maildoso: comparaciones basadas en fuentes y números.
Ejecuta tu operación de correo frío con Claude Code — la guía principal de operación con agentes (las variantes de Cursor y Codex están enlazadas desde ella).
¿Debería tu agente de IA usar Coldrig? — evidencia, idoneidad y límites, escrito para un agente evaluador (gemelo legible por máquina: agent-evaluation.md).
Precios · FAQ · Docs

Licencia

MIT — ver LICENSE — cubre el contenido de este repositorio (CLI, configuración MCP, habilidades, plugins, integraciones). La plataforma alojada (API, motor, panel) es de código cerrado y no está cubierta. Operada por EpiphanyMade.