MisarMail MCP Server
Envía correos transaccionales, ejecuta campañas y automatizaciones, gestiona contactos y audita la entregabilidad: 54 herramientas anotadas.
Documentación
MisarMail MCP Server
Envía correos electrónicos, ejecuta campañas, gestiona contactos y automatizaciones, realiza pruebas A/B y audita la entregabilidad — desde cualquier asistente de IA.
54 herramientas · 8 prompts · 4 recursos · 8 habilidades de agente
Funciona con Claude (Desktop, Code y web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT y cualquier otro cliente compatible con MCP — a través de stdio o Streamable HTTP.
Instalación
Smithery (recomendado)
npx -y @smithery/cli install misar/misarmail-mcp --client claude
Claude Code
claude mcp add misarmail -- npx -y @misarmail/mcp@latest
Manual (cualquier cliente)
{
"mcpServers": {
"misarmail": {
"command": "npx",
"args": ["-y", "@misarmail/mcp@latest"],
"env": { "MISARMAIL_API_KEY": "msk_your_key_here" }
}
}
}
Las configuraciones listas para cada cliente están en connectors/.
Remoto (sin instalación)
{
"mcpServers": {
"misarmail": {
"type": "streamable-http",
"url": "https://api.misar.io/mail/mcp",
"headers": { "Authorization": "Bearer msk_your_key_here" }
}
}
}
Autenticación
Dos opciones — no necesitas copiar y pegar para la primera:
- Inicio de sesión en el navegador. Inicia el servidor sin clave y ejecuta la herramienta
login. Se abre la pantalla de consentimiento de MisarMail, revisas los permisos solicitados y la clave se entrega directamente y se guarda en~/.misarmail/config.json. - Clave API. Crea una en https://mail.misar.io/developers y establece
MISARMAIL_API_KEY.
Instancias autoalojadas: establece MISARMAIL_BASE_URL.
Herramientas
| Herramienta | Descripción |
|---|---|
send_email | Envía un correo electrónico transaccional desde una cuenta verificada de MisarMail. |
list_emails | Lista los correos electrónicos de una carpeta de buzón con búsqueda de texto completo opcional en asunto y cuerpo. |
get_email | Lee el contenido completo de un correo electrónico por ID, incluidos encabezados, cuerpo y metadatos de adjuntos. |
reply_to_email | Responde a un hilo de correo electrónico existente. |
archive_email | Mueve un correo electrónico a la carpeta de archivo. |
validate_email | Valida una dirección de correo electrónico antes de enviar: sintaxis, registros MX, detección de dominios desechables y cuentas de rol. |
list_campaigns | Lista las campañas de email marketing con su estado, tamaño de audiencia y métricas principales. |
get_campaign | Obtén los detalles completos de una campaña: contenido, segmento de audiencia, programación y estadísticas de entrega (enviados, abiertos, clics, rebotes, quejas).. |
create_campaign | Crea una nueva campaña de email marketing como borrador. |
send_campaign | Envía una campaña ahora o prográmala para un momento futuro pasando scheduled_at. |
list_contacts | Lista los contactos con su estado de suscripción y métricas de participación. |
create_contact | Añade un solo contacto. |
update_contact | Actualiza un contacto existente por dirección de correo electrónico, incluido el cambio de estado de suscripción. |
import_contacts | Importa en bloque hasta 5.000 contactos en una sola llamada. |
get_contact_score | Obtén la puntuación de participación, el nivel de participación y el riesgo de abandono de un contacto — o los contactos con menor participación de la lista cuando se omite contact_id. |
list_templates | Lista las plantillas de correo electrónico guardadas con sus variables de marcador de posición, para que puedas elegir una para una campaña o envío transaccional.. |
create_template | Crea una plantilla de correo electrónico reutilizable. |
render_template | Renderiza una plantilla con variables de ejemplo y devuelve el HTML resultante y el asunto. |
list_automations | Lista los flujos de automatización (series de bienvenida, re-engagement, secuencias de goteo) con su tipo de disparador y estado activo.. |
get_automation | Obtén un flujo de automatización completo: disparador, cada paso con su retraso y estadísticas de finalización por paso.. |
create_automation | Crea un flujo de automatización a partir de un disparador y una lista ordenada de pasos. |
toggle_automation | Activa o pausa una automatización. |
list_ab_tests | Lista las pruebas A/B con resultados por variante y si ya se ha seleccionado un ganador.. |
create_ab_test | Crea una prueba A/B en una campaña con dos o más variantes. |
select_ab_test_winner | Selecciona la variante ganadora y envíala a la audiencia restante. |
get_analytics | Obtén análisis de entrega y participación — enviados, entregados, abiertos, clics, rebotes y quejas — para la cuenta o una campaña, agrupados por día/semana/mes.. |
generate_report | Genera un informe de análisis estructurado en un rango de fechas. |
get_revenue_attribution | Atribuye ingresos de comercio electrónico al correo electrónico — ingresos por campaña, por contacto y valor medio de pedido a partir de conversiones rastreadas.. |
get_monetization_stats | Obtén estadísticas de monetización de newsletters: suscriptores de pago, MRR, abandono e ingresos por patrocinio del período.. |
get_deliverability_score | Obtén la puntuación de entregabilidad de la cuenta (0–100) y la calificación con letra (A–F) con los factores que la reducen. |
run_deliverability_audit | Ejecuta una auditoría completa de entregabilidad en autenticación (SPF/DKIM/DMARC), reputación de dominio, higiene de listas, señales de contenido y estado de listas de bloqueo. |
get_warmup_status | Obtén el progreso de calentamiento de IP/dominio y la capacidad de envío restante de hoy. |
check_dmarc | Comprueba los registros DNS SPF, DKIM y DMARC en vivo de un dominio e informa de problemas de alineación con el registro exacto que hay que publicar. |
list_domains | Lista los dominios de envío con su estado de verificación y sus registros DKIM/SPF/DMARC. |
add_domain | Añade un dominio de envío y devuelve los registros DNS que hay que publicar. |
verify_domain | Vuelve a comprobar los registros DNS de un dominio y márcalo como verificado si se resuelven. |
configure_inbound_domain | Configura el enrutamiento de correo electrónico entrante para un subdominio para que las respuestas lleguen a la bandeja de entrada unificada de MisarMail. |
list_forms | Lista los formularios de registro con su estado de inserción y recuentos de conversión.. |
get_form | Obtén un formulario de registro, incluidos sus campos, código de inserción y comportamiento de redirección.. |
get_form_submissions | Lista los envíos de un formulario de registro, incluidos los valores de los campos enviados y las marcas de tiempo.. |
create_landing_page | Crea una página de destino alojada con un formulario de captura de correo electrónico. |
list_marketplace_items | Explora el mercado de plantillas de MisarMail para encontrar plantillas de correo electrónico y automatización listas para usar.. |
get_marketplace_item | Obtén un listado del mercado con su vista previa completa, autor y recuento de instalaciones.. |
list_inbox_conversations | Lista las conversaciones de la bandeja de entrada unificada (hilos) con su estado e intención detectada. |
get_inbox_conversation_messages | Obtén todos los mensajes de una conversación de bandeja de entrada, del más antiguo al más reciente, con remitente y marcas de tiempo.. |
categorize_inbox_emails | Ejecuta la categorización por IA sobre un lote de correos electrónicos de la bandeja de entrada para etiquetar intención y prioridad. |
list_api_keys | Lista las claves API de la cuenta con sus ámbitos y la última vez que se usaron. |
generate_subject_lines | Genera variantes de línea de asunto con IA para un tema de campaña, opcionalmente ajustadas a un tono y una audiencia. |
list_integrations | Lista las integraciones de terceros conectadas y su estado de sincronización.. |
get_integration | Obtén la configuración, los ámbitos y el último resultado de sincronización de una integración.. |
toggle_integration | Activa o desactiva una integración. |
list_sandbox_sends | Lista los correos electrónicos capturados por el modo sandbox. |
clear_sandbox | Elimina todos los correos electrónicos capturados en sandbox. |
upgrade | Muestra el plan actual de MisarMail, cuánto queda de cada cuota y qué desbloquea la actualización. |
Prompts
Flujos de trabajo reutilizables que tu cliente expone como comandos de barra.
| Prompt | Descripción |
|---|---|
compose_email | Redacta un correo electrónico profesional y envíalo a través de MisarMail tras la confirmación. |
campaign_performance_report | Analiza el rendimiento de la campaña y produce mejoras priorizadas. |
contact_import_guide | Importa y organiza contactos de forma segura, con comprobaciones de consentimiento e higiene. |
automation_builder_guide | Diseña y construye un flujo de automatización de correo electrónico paso a paso. |
deliverability_improvement_plan | Diagnostica la entregabilidad y produce un plan de acción semanal priorizado. |
ab_test_plan | Diseña una prueba A/B estadísticamente significativa para una campaña. |
list_hygiene_audit | Encuentra y limpia los contactos que están dañando la reputación del remitente. |
weekly_email_report | Produce un resumen semanal del rendimiento del correo electrónico listo para las partes interesadas. |
Recursos
Contexto de solo lectura que un agente puede adjuntar sin gastar una llamada de herramienta.
| URI | Descripción |
|---|---|
misarmail://account/domains | Tus dominios de envío con estado de verificación y registros DNS. |
misarmail://account/deliverability | Puntuación de entregabilidad actual de la cuenta (0–100), calificación y factores que contribuyen.. |
misarmail://account/warmup | Etapa de calentamiento de IP/dominio y capacidad de envío restante para hoy — el límite que un envío masivo no debe superar.. |
misarmail://templates | Plantillas guardadas con sus variables declaradas, para reutilizarlas en campañas y envíos.. |
Habilidades de agente
Incluidas en skills/ — orientación que un agente carga cuando una tarea coincide.
| Habilidad | Cuándo usarla |
|---|---|
ab-test-campaign | Diseñar y ejecutar una prueba A/B en una campaña de MisarMail — línea de asunto, contenido, nombre del remitente u hora de envío. Úsala para "prueba A/B", "prueba dividida", "qué asunto funciona mejor" o probar variantes de correo electrónico. |
audit-deliverability | Diagnosticar por qué los correos electrónicos de MisarMail caen en spam o rebotan, y producir una lista priorizada de soluciones. Úsala para "correos que van a spam", "no se entregan", "tasa de apertura baja", "reputación de dominio", preguntas sobre DMARC/SPF/DKIM o listas de bloqueo. |
build-email-automation | Diseñar y construir un flujo de automatización de MisarMail — serie de bienvenida, secuencia de goteo, re-engagement u onboarding. Úsala para "automatizar", "goteo", "serie de bienvenida", "secuencia" o correo electrónico basado en disparadores. |
clean-contact-list | Auditar y limpiar una lista de contactos de MisarMail — contactos que rebotaron, se quejaron o no participan. Úsala para higiene de listas, re-engagement, supresión o "por qué está cayendo mi tasa de apertura". |
email-performance-report | Producir un informe de rendimiento de MisarMail — aperturas, clics, entregabilidad, atribución de ingresos. Úsala para "cómo van mis correos", informes semanales/mensuales o análisis de rendimiento de campañas. |
run-email-campaign | Crear, revisar y enviar una campaña de correo electrónico masivo en MisarMail. Úsala cuando el usuario quiera enviar un correo a una lista, newsletter, segmento o anuncio a muchos destinatarios. |
send-transactional-email | Enviar un correo electrónico puntual o transaccional a través de MisarMail. Úsala cuando el usuario pida enviar, redactar y enviar, o responder a un correo electrónico — incluidos recibos, notificaciones, mensajes de bienvenida y divulgación personal. |
setup-sending-domain | Añadir y verificar un dominio de envío personalizado en MisarMail, incluidos SPF, DKIM, DMARC y enrutamiento entrante. Úsala para "enviar desde mi propio dominio", configuración de DNS, verificación de dominio o correo electrónico entrante. |
Seguridad
Las acciones destructivas e irreversibles están anotadas (destructiveHint) para
que los clientes puedan pedir confirmación antes de ejecutarlas. Las habilidades
indican a los agentes que confirmen antes de cualquier cosa que envíe correo,
publique contenido o sea visible para otras personas.
El descubrimiento (initialize, tools/list, prompts/list, resources/list)
nunca requiere credenciales, por lo que los registros pueden indexar el servidor
sin ellas. Cada acción sí las requiere.
Enlaces
- Sitio web — https://www.misarmail.com
- Aplicación — https://mail.misar.io
- Documentación — https://docs.misar.io/mail/mcp
- Smithery — https://smithery.ai/servers/misar/misarmail-mcp
- Habilidades de Smithery — send-transactional-email, run-email-campaign, ab-test-campaign, build-email-automation, clean-contact-list, setup-sending-domain, audit-deliverability, email-performance-report
- npm — https://www.npmjs.com/package/@misarmail/mcp
- Código fuente — https://github.com/Misar-AI/misarmail-mcp
MIT © Misar AI