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).

GitHub

Prueba este MCPPatrocinado

Documentación

agent-cold-email

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

agent-cold-email es una plataforma de cold-email multiinquilino diseñada 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 clics en un panel SaaS. Regístrate, entrega a tu agente un token de API, y este gestiona 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 reexportació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.

En vivo. El envío real opera en producción (API de Gmail, HTTPS/443) junto con la API/MCP/CLI completa y un sandbox gratuito. 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. Aún no existe un historial de producción establecido de varios años, y este proyecto no ofrece garantías de ubicación en bandeja de entrada ni de entregabilidad — cualquiera que te diga lo contrario sobre el cold email está vendiendo algo. Consulta Estado más abajo.

Qué es

Un registro, un token bearer, sin necesidad de panel — aunque se incluye un panel configurable por el agente y una bandeja de entrada unificada en /app para humanos que quieran una ventana (tu agente controla su diseño vía MCP; consulta SPEC.md §19).
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 copy de divulgación ni ejecuta un "SDR de IA" opaco — la generación de contenido sigue siendo trabajo del agente del cliente; la plataforma posee la infraestructura, la secuenciación y las salvaguardas de entregabilidad.
Cada cliente recibe dominios y buzones aislados — nunca compartidos con otros inquilinos.
Una demo sandbox gratuita (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: SPEC.md.

Precios

Precios — autoservicio, sin "contactar con ventas": desde $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 activos en producción (modo live de Stripe, tarjetas reales). Ponerlo en marcha es autoservicio: llama a POST /checkout con { mailboxes } y devuelve un enlace de pago alojado de Stripe — á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 promocionales se ingresan en la propia página de pago de Stripe (enlace "Add promotion code"), no en la API. El aprovisionamiento real de buzones es entonces totalmente 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 más abajo.

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, la infraestructura de supresión/baja/incumplimiento y cualquier tarifa por envío. Los $99/mes anteriores son los seis, agrupados, con $0 en 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 inquilino 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 el 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 una ETA)
`launch_campaign`	Crear y activar una secuencia contra una lista de leads
`campaign_results`	Envíos, respuestas, rebotes y quejas por campaña
`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 (detenerse al responder 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 inquilino
`account`	Uso, facturación y cuota
`remove_mailboxes`	Degradación: libera tus N buzones en vivo más nuevos ahora y reduce la cantidad facturada
`get_dashboard`	Listar/obtener las vistas de panel guardadas del inquilino (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 saliente, 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 traído por ti — registrar, consultar DNS, reconocer el consentimiento del dominio principal, 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 inquilino — 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`	Contactar 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 SPEC.md §6 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 forman 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 (el host original de Workers agent-cold-email-api.yaakovscher.workers.dev aún resuelve como alias de respaldo heredado) — las 28 intenciones son reales, probadas y alcanzables por HTTP o MCP (mismas herramientas, misma autenticación de token bearer con ámbito de inquilino). El envío real está en vivo en producción (API de Gmail, HTTPS/443) para inquilinos activados; los inquilinos no activados y de demo operan 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.1 — npx agent-cold-email demo funciona 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 /mcp para clientes MCP que solo admiten 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 inquilinos activados (API de Gmail, HTTPS/443), y los inquilinos no activados/demo operan 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 site/openapi.yaml para el contrato REST completo, o AGENTS.md para el recorrido orientado al agente.

Primer uso: la demo gratuita

Hay una forma sin costo de ver el pipeline completo en acción: POST /signup acuña un inquilino 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 tipos 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 cumplimiento, 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 aplicado por código se ejecuta en el límite de setup_infrastructure (engine/brand-guard.ts): rechaza de forma estricta una lista de denegación 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 deriven de tu propia identidad declarada. La verificación criptográfica completa de propiedad del dominio (prueba DNS/registrador) es un paso de activación (ACTIVATION.md). 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 SPEC.md §9.

Modelo completo de salvaguardas y abuso: SPEC.md §7. Documentos legales (borradores, pendientes de revisión legal): site/terms.html, site/privacy.html, site/aup.html.

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 (este repositorio), 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.
✅ Envío real, en vivo en producción (Gmail API, HTTPS/443) — un envío real fue compuesto, entregado y verificado de forma independiente por IMAP el 2026-07-19.
✅ Webhooks push salientes 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) crea un inquilino demo automáticamente y ejecuta el pipeline completo; el POST /demo/run subyacente se ejecuta contra el token portador de ese inquilino demo (obtén uno de 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 — SPEC.md §19).
✅ 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 y entregabilidad de varios años — un envío probado no es un historial.

El estado detallado de construcción, el estado fase por fase y el historial de sesiones viven en ROADMAP.md y HANDOFF.md — no en este README.

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.1, 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, la lista de permitidos de activación por inquilino y el flujo de exclusión con un clic CAN-SPAM están todos confirmados y probados en vivo — un envío real a través del transporte Gmail API/443 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 (crea su propio inquilino, no necesita nada). El envío real está en vivo — consulta 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 genera la cotización — el cargo real sigue tu recuento de buzones aprovisionados).

Aprende más

Comparar — Coldrig vs una pila 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 en 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. Operado por EpiphanyMade.