Smartlead a MCP: campañas de cold email, leads, respuestas, analíticas y warmup de buzones en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Smartlead, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Smartlead

Cold email con Smartlead desde cualquier agente de IA: crea y gestiona campañas con secuencias y horarios, añade y gestiona leads y sus categorías, lee y contesta las respuestas en la bandeja maestra, compara analíticas de campañas y de la cuenta y revisa buzones remitentes y warmup. Funciona con una clave API de Smartlead; las bajas definitivas y los borrados vienen desactivados.

Configuración

La configuración lleva unos 2 minutos. El acceso a la API requiere un plan de pago de Smartlead.

1. En Smartlead abre Settings y la sección API Keys (en algunos planes está en Settings, Integrations).
2. Copia la clave API en SMARTLEAD_API_KEY. El conector la añade a cada petición como parámetro de consulta api_key, así que pega solo la clave.
3. Instala el conector y ejecuta smartlead_list_campaigns: lista tus campañas y confirma la clave.

La clave da acceso completo a la cuenta, así que trátala como una contraseña.

Campañas: primero smartlead_list_campaigns, porque el id de cada campaña es el campaign_id de todas las demás herramientas. smartlead_get_campaign, smartlead_get_campaign_sequences y smartlead_list_campaign_email_accounts muestran su configuración. Para crear una, la IA encadena smartlead_create_campaign (una campaña vacía en estado DRAFTED), smartlead_save_campaign_sequences, smartlead_update_campaign_schedule (zona horaria, días de la semana, franja de envío, minutos entre emails, leads nuevos por día, hora de inicio), smartlead_update_campaign_settings (nombre, seguimiento de aperturas y clics, cuándo dejar de escribir a un lead, solo texto, porcentaje de seguimiento, asignación de buzones con IA, texto de baja), smartlead_add_email_accounts_to_campaign y smartlead_add_leads_to_campaign, y luego smartlead_update_campaign_status con START. Los estados son START (no ACTIVE), PAUSED, STOPPED (definitivo; para una pausa usa PAUSED) y ARCHIVED. Iniciar una campaña envía emails reales, así que pide a la IA que te muestre antes secuencia, horario y número de leads.

Secuencias: smartlead_save_campaign_sequences sustituye la secuencia entera: los pasos que falten se eliminan. La IA la lee antes con smartlead_get_campaign_sequences, conserva los ids de los pasos existentes y envía todos los pasos. Se personaliza con {{first_name}}, {{company_name}} y los nombres de tus campos personalizados.

Leads:

• smartlead_list_campaign_leads lista los leads de una campaña. Cada fila tiene el id del vínculo campaña-lead (el id de la fila, que usa smartlead_create_lead_note) y el lead en sí (lead.id, que se usa como lead_id).
• smartlead_get_lead_by_email encuentra un lead en todas las campañas, smartlead_get_lead lo lee por id y smartlead_get_lead_campaign_overview muestra todas las campañas en las que está.
• smartlead_add_leads_to_campaign acepta como máximo 400 leads por llamada. Los leads de la lista de bloqueo global, dados de baja o ya presentes en otras campañas se omiten salvo que la configuración diga otra cosa; la respuesta cuenta los leads subidos, duplicados y bloqueados.
• Cambios: smartlead_update_lead (la API exige el email aunque no cambie; hasta 200 campos personalizados), smartlead_update_lead_category (ids de smartlead_list_lead_categories, con pausa opcional), smartlead_pause_lead, smartlead_resume_lead (ya o tras unos días) y smartlead_unsubscribe_lead_from_campaign para una sola campaña.

Respuestas: smartlead_list_inbox_replies lista las respuestas de la bandeja maestra de todas las campañas, de la más reciente a la más antigua, filtradas por campaña, buzón, categoría u hora de respuesta; smartlead_get_inbox_item abre un hilo. Para contestar, smartlead_get_lead_message_history da el stats_id, el message_id y el time de cada mensaje; la IA los pasa como email_stats_id, reply_message_id y reply_email_time a smartlead_reply_to_lead. La respuesta sale del buzón de ese hilo, al momento o en un scheduled_time. smartlead_create_lead_note añade una nota interna.

Analíticas: por campaña smartlead_get_campaign_analytics (totales históricos y progreso de los leads), smartlead_get_campaign_analytics_by_date, smartlead_get_campaign_sequence_analytics (por paso y variante A/B) y smartlead_get_campaign_statistics (una fila por email enviado). smartlead_get_overall_analytics cubre toda la cuenta, opcionalmente limitada a algunas campañas o clientes.

Buzones y warmup: smartlead_list_email_accounts muestra dirección, proveedor, límites diarios, estado SMTP/IMAP y warmup; una conexión rota tiene isSmtpSuccess=false. Además smartlead_get_email_account, smartlead_get_warmup_stats (últimos 7 días: emails de warmup enviados, llegados a la bandeja de entrada, llegados a spam, respuestas), smartlead_update_email_account (límite diario, nombre del remitente, firma, CCO, dominio de seguimiento propio, minutos entre emails) y smartlead_update_warmup (activado o no, volumen diario, rampa, tasa de respuesta).

Webhooks, agencias y listas: smartlead_list_campaign_webhooks y smartlead_upsert_campaign_webhook (crea uno, o lo actualiza si se pasa id) con los eventos EMAIL_SENT, EMAIL_OPEN, EMAIL_LINK_CLICK, EMAIL_REPLY, EMAIL_BOUNCE, LEAD_UNSUBSCRIBED y LEAD_CATEGORY_UPDATED. smartlead_list_clients da los ids de cliente de una cuenta de agencia (marca blanca); smartlead_list_lead_lists lista las listas de leads.

Desactivadas al instalar: smartlead_unsubscribe_lead_globally (da de baja al lead en todas las campañas y bloquea futuras importaciones de la dirección), smartlead_delete_lead_from_campaign (quita el lead y su progreso de esa campaña) y smartlead_delete_campaign_webhook. No se pueden deshacer, así que un admin del workspace las activa cuando el equipo las necesite.

Formatos de datos: los recuentos son números de emails o de leads; las tasas son porcentajes. Las fechas de las analíticas son YYYY-MM-DD, con una zona horaria IANA opcional (UTC por defecto) para los límites del día. Las marcas de tiempo son ISO 8601 en UTC salvo que se pase una zona horaria.

Paginación: los listados aceptan offset (0 por defecto) y limit (100 por defecto; la bandeja, 20). La IA sube offset en limit hasta que vuelven menos filas que limit; smartlead_list_campaign_leads devuelve además total_leads.

Límites y errores habituales: Smartlead frena las ráfagas de peticiones (unas 10 peticiones cada 2 segundos en los planes estándar) y responde 429; espera y reintenta. 401 Invalid API Key indica una clave errónea, 404 un id erróneo o de otra cuenta, y 400 nombra el campo no válido.

El conector no conecta buzones remitentes nuevos y no borra campañas.

Requisitos previos: SMARTLEAD_API_KEY

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Smartlead e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál de mis campañas activas tiene la mejor tasa de respuesta este mes? Muestra envíos, respuestas y rebotes de cada una."
• "Muéstrame las respuestas de las últimas 24 horas clasificadas como Interested."
• "Contesta al último email de [email protected] en la campaña Q4 Outreach y propón una llamada la semana que viene. Enséñame el texto antes de enviarlo."
• "¿Qué buzones remitentes tienen la conexión SMTP rota o muchos emails de warmup en spam?"
• "Pausa el lead [email protected] en todas las campañas en las que está."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT