API · MCP · SDK

Construya sobre Cold Leads

Cold Leads es un CRM de prospección en frío que se maneja desde código. Verifique direcciones antes de enviar, envíe leads desde cualquier formulario o sistema, mueva contactos por el embudo y dé a su agente de IA las mismas herramientas por MCP. JSON simple, una cabecera para autenticarse y una especificación OpenAPI 3.1 para generar clientes.

Obtener clave de API Leer la especificación OpenAPI

OpenAPI 3.1
·Autenticación x-api-key
·120 solicitudes por minuto por clave
·Servidor MCP alojado
·SDK con licencia MIT en GitHub

POST /api/v1/verify

curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -d '{"email":"jane@example.com"}'

{
  "email": "jane@example.com",
  "status": "valid",
  "score": 75,
  "reasons": ["smtp_unreachable"],
  "mx": "mx.example.com",
  "catch_all": null,
  "disposable": false,
  "role": false
}

Respuesta ilustrativa. Los códigos de motivo indican si también se comprobó el propio buzón.

120/min

solicitudes por clave, una cabecera de autenticación

herramientas MCP para Claude, ChatGPT y Cursor

5 días

de prueba gratuita con API en Business

Interfaces

Elija la interfaz que le convenga

API REST

Verifique una dirección o una lista (trabajos en lote), busque contactos de su propio CRM y lea su saldo de créditos. Especificación OpenAPI 3.1 para generar código y para agentes que importan herramientas desde una especificación.

Especificación OpenAPI 3.1

Hooks de leads y etapas

Una clave de sitio (lk_…) convierte cualquier formulario en fuente de leads y puede iniciar una campaña automática tras el retraso que elija. El hook de etapa marca un contacto como cliente cuando su sistema de facturación o CRM cierra el trato.

Servidor MCP alojado

https://coldleads.app/api/mcp da a Claude, ChatGPT, Cursor y otros clientes MCP 14 herramientas: importar y editar contactos, verificar direcciones, redactar plantillas, preparar campañas y lanzarlas con su aprobación, leer respuestas. OAuth o clave secreta.

Cold Leads para agentes de IA

SDK de Node.js y MCP stdio

Cliente tipado para Node 20 o superior y un servidor MCP local para Claude Desktop, Cursor y VS Code. Código abierto, licencia MIT, instalación directa desde GitHub.

github.com/anttka4cz/coldleads-node-sdk

Inicio rápido

Del registro a la primera llamada en minutos

Regístrese

Cree una cuenta con Google o un enlace por correo. Inicie la prueba gratuita de 5 días en el plan Business para probar la API con 25 créditos (se requiere tarjeta y puede cancelar en cualquier momento antes de que termine).

Cree una clave

Ajustes → API. Una clave secreta (sk_…) para su servidor y una clave de sitio (lk_…) para los formularios de su web. Las claves secretas se guardan como hash, se muestran una vez y se pueden pausar, rotar o eliminar.

Haga una llamada

Envíe la clave en la cabecera x-api-key y llame a cualquier endpoint de abajo. Los errores son JSON con un código corto como rate_limited, no_credits o bad_input.

Tres llamadas que cubren la mayoría de las integraciones

# 1. Verify an address (1 credit)
curl -X POST https://coldleads.app/api/v1/verify \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com"}'

# 2. Capture a lead from any form (website key lk_…, safe to ship in HTML)
curl -X POST "https://coldleads.app/api/hooks/lead?key=$COLDLEADS_SITE_KEY" \
  -d email=jane@example.com -d name="Jane Doe"

# 3. Move a contact along the funnel when the deal closes
curl -X POST https://coldleads.app/api/hooks/stage \
  -H "x-api-key: $COLDLEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@example.com","stage":"customer"}'

# Node.js SDK and MCP server (installed from GitHub)
npm install --allow-git=root github:anttka4cz/coldleads-node-sdk
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads

Sustituya las variables de entorno por sus claves. Las direcciones son ilustrativas.

Una respuesta de verificación incluye un estado (valid, risky o invalid), una puntuación, códigos de motivo, el host MX y el campo catch_all. Los códigos de motivo indican si también se comprobó el propio buzón.

Por qué Cold Leads

Por qué los desarrolladores se quedan

JSON simple por HTTPS, una cabecera de autenticación y errores con códigos cortos: no hace falta un SDK para empezar.

Cada clave tiene su propio límite de solicitudes y su contador de uso, y se puede pausar o rotar sin tocar las demás.

El mismo motor ejecuta sus propias campañas: nunca se envía a direcciones verificadas como no válidas y las campañas salen de su propio buzón de Gmail, Microsoft 365 o SMTP.

Los agentes de IA trabajan con aprobación: preparan un borrador de campaña y solo la lanzan cuando una persona confirma la plantilla y la audiencia.

Un agente puede empezar incluso sin clave: POST /api/agent/provision devuelve un enlace de pago para el titular humano y un claim token.

Precios

$99al mes · Business · 10,000

Las claves de sitio funcionan en todos los planes. La API con clave secreta (verificación, buscador, búsqueda de contactos, hook de etapa) y MCP vienen con Business: $99 al mes con 10,000 créditos al mes. Los créditos extra cuestan $5 por 1 000.

Pruébelo primero: la prueba gratuita de 5 días en Business incluye la API dentro de los límites de la prueba (25 créditos). Los clientes nuevos que se suscriben en las 24 horas posteriores al registro obtienen un 30 % de descuento en el primer pago en lugar de la prueba; ambas ofertas no se pueden combinar.

Obtener clave de API Precios

Límites

120 solicitudes por minuto por clave.
5 trabajos en lote en paralelo, hasta 5 000 direcciones por trabajo.
1 crédito por dirección verificada o llamada al buscador; los resultados se guardan 30 días y repetir una comprobación también cuesta un crédito.
Las claves de sitio (lk_…) solo pueden crear contactos, con un tope diario por clave.

Hablando claro

Lo que no es

No es una base de datos de leads: Cold Leads no vende datos de personas ni empresas y no enriquece contactos. La búsqueda se hace sobre los contactos de su propia cuenta.

La comprobación del buzón y de accept-all por SMTP solo se ejecuta cuando nuestro servidor puede conectar con el servidor de correo del destinatario; si no, el código de motivo indica que el buzón no se comprobó.

Aún no hay webhooks salientes: lea los resultados consultando la API o use MCP.

El SDK y el servidor MCP stdio se instalan desde GitHub; no están en npm.

Recetas

Use Cold Leads desde Cursor, Claude Desktop y Windsurf a través de MCP

Conecte Cold Leads MCP o Node SDK para importar contactos, gestionar chats, campañas, outreach aprobado y formularios web.

Verificación masiva de correos en n8n con Google Sheets

Flujo de n8n importable: lee Google Sheets, envía hasta 5 000 direcciones a una tarea masiva de Cold Leads, la sondea, enruta por estado y escribe resultados.

Verifique los leads en Make.com antes de que lleguen a una campaña de Instantly

Escenario de Make.com que comprueba cada lead nuevo con la API de Cold Leads y solo añade las direcciones válidas a una campaña de Instantly con su API v2.

Verifique un CSV de 50 000 filas con Python, asyncio y httpx

Un script completo con asyncio + httpx para la API masiva de Cold Leads: tareas de 5 000, cinco a la vez, sondeo, manejo de 429 y 402 y salida CSV reanudable.

Cómo migrar la verificación de correos de Hunter o Apollo a Cold Leads

Mapee Email Verifier y Email Finder de Hunter a la API de Cold Leads campo a campo, vea qué datos de Apollo no tienen equivalente y cuánto cuesta Cold Leads.

Suscripciones que inicia un agente y aprueba una persona

Un agente de IA sin clave pide la suscripción Business de Cold Leads, su propietario humano aprueba y paga en Stripe y el agente recoge la clave de API una vez.

Todas las recetas

FAQ

Preguntas frecuentes de desarrolladores

¿Necesito tarjeta para probar la API?

Sí. La prueba gratuita de 5 días requiere tarjeta y se puede cancelar antes de que termine; durante la prueba no se cobra nada. No existe un plan gratuito.

¿Qué plan incluye la API?

Business ($99 al mes, 10,000 créditos). Las claves de sitio para formularios funcionan en todos los planes. Durante la prueba de Business la API funciona dentro de los límites de la prueba.

¿Puedo generar un cliente a partir de la especificación?

Sí, /api/v1/openapi.json es un documento OpenAPI 3.1. Los dos hooks son llamadas HTTP simples descritas en esta página.

¿Hay un SDK?

Un SDK tipado de Node.js (Node 20 o superior) y un servidor MCP para clientes locales, ambos con licencia MIT en GitHub. Otros lenguajes pueden usar la API HTTP directamente.

¿Puede un agente de IA registrarse por sí mismo?

Un agente llama a POST /api/agent/provision con el correo del titular. Recibe un enlace de pago de Stripe para el titular humano y un claim token; cuando el titular paga, el agente recibe su clave una sola vez.

¿Qué pasa cuando se acaban los créditos?

Las llamadas devuelven un error 402 no_credits con el saldo restante. Los créditos se renuevan cada mes y los paquetes extra cuestan $5 por 1 000.

¿Listo para construir?

Cree una cuenta, tome una clave y haga su primera llamada en unos minutos.

Obtener clave de API