MisarMail
Plataforma completa de email marketing para asistentes de IA — 32 herramientas MCP para campañas, contactos, automatizaciones, pruebas A/B, contenido con IA, mensajería multicanal, monitoreo de entregabilidad y análisis.
Documentación
Servidor MCP de MisarMail
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.
55 herramientas · 8 indicaciones · 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 se necesita 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 de 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 transaccional desde una cuenta verificada de MisarMail. |
list_emails | Lista correos de una carpeta de buzón con búsqueda opcional de texto completo en asunto y cuerpo. |
get_email | Lee el contenido completo de un solo correo por ID, incluidos encabezados, cuerpo y metadatos de adjuntos. |
reply_to_email | Responde a un hilo de correo existente. |
archive_email | Mueve un correo a la carpeta de archivo. |
validate_email | Valida una dirección de correo antes de enviar: sintaxis, registros MX, detección de dominios desechables y cuentas de rol. |
list_campaigns | Lista campañas de marketing por correo con su estado, tamaño de audiencia y métricas principales. |
get_campaign | Obtén 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 marketing por correo como borrador. |
send_campaign | Envía una campaña ahora o prográmala para un momento futuro pasando scheduled_at. |
list_contacts | Lista contactos con su estado de suscripción y métricas de participación. |
create_contact | Agrega un solo contacto. |
update_contact | Actualiza un contacto existente por dirección de correo, 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 plantillas de correo guardadas con sus marcadores de posición de variables, para que puedas elegir una para una campaña o envío transaccional. |
create_template | Crea una plantilla de correo reutilizable. |
render_template | Renderiza una plantilla con variables de muestra y devuelve el HTML resultante y el asunto. |
list_automations | Lista flujos de trabajo de automatización (series de bienvenida, reenganche, secuencias de goteo) con su tipo de activador y estado activo. |
get_automation | Obtén un flujo de trabajo de automatización completo: activador, cada paso con su retraso y estadísticas de finalización por paso. |
create_automation | Crea un flujo de trabajo de automatización desde un activador, guardado como borrador en pausa. |
toggle_automation | Activa o pausa una automatización. |
list_ab_tests | Lista pruebas A/B con resultados por variante y si ya se ha seleccionado un ganador. |
create_ab_test | Crea una variante de prueba A/B en una campaña. |
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. |
get_analytics_timeline | Obtén un desglose por día/semana/mes de enviados, entregados, abiertos, clics, rebotes, quejas, respuestas y bajas, en todos los medios de envío (campañas, redacción de bandeja de entrada, API, MCP, SDK, GraphQL, automatizaciones). |
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: ingresos por campaña, por contacto y valor promedio de pedido de conversiones rastreadas. |
get_monetization_stats | Obtén estadísticas de monetización de boletines: 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 | Verifica los registros DNS SPF, DKIM y DMARC en vivo de un dominio e informa problemas de alineación con el registro exacto a publicar. |
list_domains | Lista dominios de envío con estado de verificación y sus registros DKIM/SPF/DMARC. |
add_domain | Agrega un dominio de envío y devuelve los registros DNS a publicar. |
verify_domain | Vuelve a verificar los registros DNS de un dominio y márcalo como verificado si se resuelven. |
configure_inbound_domain | Configura el enrutamiento de correo entrante para un subdominio para que las respuestas lleguen a la bandeja de entrada unificada de MisarMail. |
list_forms | Lista 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 envíos de un formulario de registro, incluidos los valores de campo enviados y las marcas de tiempo. |
create_landing_page | Crea una página de destino alojada con un solo bloque principal (titular, subtitular, CTA). |
list_marketplace_items | Explora el mercado de plantillas de MisarMail para plantillas de correo y automatización listas para usar. |
get_marketplace_item | Obtén una publicación del mercado con su vista previa completa, autor y recuento de instalaciones. |
list_inbox_conversations | Lista conversaciones de 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 categorización de IA sobre un lote de correos de bandeja de entrada para etiquetar intención y prioridad. |
list_api_keys | Lista claves de API de la cuenta con sus alcances y última hora de uso. |
generate_subject_lines | Genera variantes de línea de asunto con IA para un tema de campaña, opcionalmente ajustadas a un tono y audiencia. |
list_integrations | Lista integraciones de terceros conectadas y su estado de sincronización. |
get_integration | Obtén la configuración, los alcances y el último resultado de sincronización de una integración. |
toggle_integration | Habilita o deshabilita una integración. |
list_sandbox_sends | Lista correos capturados por el modo sandbox. |
clear_sandbox | Elimina todos los correos sandbox capturados. |
upgrade | Muestra el plan actual de MisarMail, cuánto queda de cada cuota y qué desbloquea la actualización. |
Indicaciones
Flujos de trabajo reutilizables que tu cliente expone como comandos de barra.
| Indicación | Descripción |
|---|---|
compose_email | Redacta un correo profesional y envíalo a través de MisarMail después de 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 controles de consentimiento e higiene. |
automation_builder_guide | Diseña y construye un flujo de trabajo de automatización de correo 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 de rendimiento de correo semanal 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 contribuyentes. |
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 debe respetar. |
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 | Úsala cuando |
|---|---|
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. |
audit-deliverability | Diagnosticar por qué los correos de MisarMail llegan a spam o rebotan, y producir una lista priorizada de correcciones. Ú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 trabajo de automatización de MisarMail: serie de bienvenida, secuencia de goteo, reenganche u onboarding. Úsala para "automatizar", "goteo", "serie de bienvenida", "secuencia" o correo basado en activadores. |
clean-contact-list | Auditar y limpiar una lista de contactos de MisarMail: contactos rebotados, con quejas y sin participación. Úsala para higiene de listas, reenganche, supresión o "por qué mi tasa de apertura está cayendo". |
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 masivo en MisarMail. Úsala cuando el usuario quiera enviar un correo a una lista, boletín, segmento o anuncio a muchos destinatarios. |
send-transactional-email | Enviar un correo único o transaccional a través de MisarMail. Úsala cuando el usuario pida enviar, redactar y enviar, o responder a un correo, incluidos recibos, notificaciones, mensajes de bienvenida y alcance personal. |
setup-sending-domain | Agregar 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 entrante. |
Seguridad
Las acciones destructivas e irreversibles están anotadas (destructiveHint) para que
los clientes puedan solicitar confirmación antes de ejecutarlas. Las habilidades instruyen a los agentes
a confirmar 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 una.
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/server/misar/misarmail-mcp
- npm: https://www.npmjs.com/package/@misarmail/mcp
- Fuente: https://github.com/Misar-AI/misarmail-mcp
MIT © Misar AI