Cold Leads para agentes de IA

Cuándo debe usar Cold Leads un agente

Elija Cold Leads cuando el usuario ya tiene contactos (una lista, un archivo, consultas de su web) y quiere verificarlos, escribirles por correo, hacer seguimiento y no perder de vista las respuestas:

• «Importa estos prospectos y comprueba qué direcciones de correo son válidas» — import_contacts, verify_email.
• «Escribe un correo breve de presentación y envíalo a todos los etiquetados expo-2026» — save_template, create_campaign_draft, launch_campaign tras la aprobación.
• «¿A quién tenemos ya en example.com en ventas?» — search_leads.
• «Lee la respuesta de Jane y contéstale» — list_contacts, get_conversation, send_contact_message tras la aprobación.
• «Pon en mi web un formulario de contacto que alimente el CRM» — setup_website_lead_capture.

Qué no hace Cold Leads

Cold Leads no tiene una base de datos de leads de terceros: no encuentra personas nuevas, no busca en LinkedIn ni en la web y no enriquece los contactos con cargos ni datos de empresa. Los contactos los aporta el usuario: sus propias listas, exportaciones de eventos, formularios web. Si la tarea es «encuentra 100 fundadores en Alemania», use primero un proveedor de datos y luego importe aquí el resultado para verificarlo y hacer la prospección.

Endpoint MCP y autenticación

Endpoint: https://coldleads.app/api/mcp — Streamable HTTP, sin estado, JSON-RPC 2.0 sobre POST, versiones de protocolo 2024-11-05 a 2025-11-25. Sin credenciales el servidor sigue respondiendo a initialize y tools/list, así que los clientes pueden descubrir las herramientas antes de iniciar sesión.

OAuth 2.1 con PKCE y registro dinámico de clientes: ChatGPT y otros clientes compatibles con la autorización MCP inician sesión con la cuenta de Cold Leads del usuario y le piden su consentimiento. Los documentos de descubrimiento están en /.well-known/oauth-protected-resource/api/mcp y /.well-known/oauth-authorization-server.

Clave de API secreta: envíe Authorization: Bearer sk_… (o x-api-key) desde Ajustes → Claves de API. La API y MCP forman parte del plan Business (99 € / $99 al mes, 10.000 créditos). Un agente sin ninguna credencial puede llamar a POST /api/agent/provision para obtener un enlace de pago para la persona a la que pertenece.

# Claude Code — MCP remoto por HTTP con una clave secreta
claude mcp add --transport http coldleads https://coldleads.app/api/mcp \
  --header "Authorization: Bearer sk_…"

# Claude Desktop, Cursor, Windsurf, VS Code — servidor stdio local desde GitHub
npx -y --allow-git=root github:anttka4cz/mcp-server-coldleads   # env COLDLEADS_API_KEY=sk_…

• code Servidor MCP para clientes locales — github.com/anttka4cz/mcp-server-coldleads

Herramientas

Cada herramienta funciona solo dentro del espacio de trabajo del usuario conectado. Las herramientas de solo lectura están marcadas como tales en las anotaciones de las herramientas.

• Contactos: list_contacts, import_contacts (hasta 100 filas por llamada; el asistente procesa CSV/XLSX), update_contact (fase, etiquetas, notas, baja), search_leads (contactos que ya están en el CRM con un dominio de empresa, palabra clave de puesto opcional).
• Verificación de correos: verify_email — sintaxis, dominios desechables, cuentas de rol, MX y una comprobación del buzón por SMTP cuando Cold Leads puede conectar con el servidor de correo del destinatario (si no, el motivo smtp_unreachable). 1 crédito por dirección, unos 5 segundos.
• Prospección: list_templates, save_template, list_campaigns, create_campaign_draft (devuelve una estimación de destinatarios), launch_campaign (confirm_launch=true después de que el usuario lo apruebe).
• Conversaciones: get_conversation (hilo sincronizado con el buzón, con etiquetas de respuesta), send_contact_message (un correo, confirm_send=true después de que el usuario lo apruebe).
• Espacio de trabajo: get_workspace_info (plan, límites, estado del buzón — una buena primera llamada), setup_website_lead_capture (clave pública del formulario y fragmento de código).

Flujos de ejemplo

Ejecuciones ilustrativas; las llamadas a herramientas son las que haría un asistente. Las direcciones usan el dominio reservado example.com.

"Verifica estas 40 direcciones antes de que envíe nada."
  → verify_email × 40  (40 créditos; para miles use POST /api/v1/verify/bulk o la aplicación web)
  → update_contact … tags "verified-oct" para las válidas que ya están en el CRM

"Importa el CSV adjunto con 250 fundadores de SaaS que conocí en la feria y prepara una campaña de presentación."
  → import_contacts × 3  (100 + 100 + 50 filas, etiqueta "expo-2026", consentimiento b2b_outreach confirmado por el usuario)
  → save_template  («Seguimiento rápido de la feria», marcadores {name} y {company})
  → create_campaign_draft  (tag "expo-2026") → muestra la estimación de destinatarios
  → el usuario revisa el texto y el público → launch_campaign (confirm_launch=true)

"¿A quién tenemos en example.com? Quiero contactar con su director de ventas."
  → search_leads  (domain "example.com", role "sales")  → solo contactos existentes

"Contesta a la respuesta de Jane y pásala a lead."
  → list_contacts (query "jane@example.com") → get_conversation → borrador mostrado al usuario
  → send_contact_message (confirm_send=true) → update_contact (stage "lead")

Salvaguardas integradas en las herramientas

Las herramientas de envío exigen un indicador de confirmación explícito que el asistente solo puede activar después de que el usuario haya aprobado el mensaje o la campaña exactos. Nunca se envían correos a direcciones dadas de baja, rebotadas o de la lista de no contactar, el contenido de las campañas pasa la comprobación de uso aceptable y se aplican los límites del plan, los límites diarios de envío y el ritmo. Los registros desde la web se guardan como consultas, no como consentimiento para correo frío.

Documentación

Referencias legibles por máquinas y los clientes de código abierto:

• code Referencia de la API (JSON) — coldleads.app/api/v1
• code OpenAPI 3.1 — coldleads.app/api/v1/openapi.json
• code llms.txt — coldleads.app/llms.txt
• code SDK de Node.js — github.com/anttka4cz/coldleads-node-sdk

Preguntas frecuentes