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.

npm smithery license

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:

  1. 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.
  2. Clave API. Crea una en https://mail.misar.io/developers y establece MISARMAIL_API_KEY.

Instancias autoalojadas: establece MISARMAIL_BASE_URL.


Herramientas

HerramientaDescripción
send_emailEnvía un correo electrónico transaccional desde una cuenta verificada de MisarMail.
list_emailsLista los correos electrónicos de una carpeta de buzón con búsqueda de texto completo opcional en asunto y cuerpo.
get_emailLee el contenido completo de un correo electrónico por ID, incluidos encabezados, cuerpo y metadatos de adjuntos.
reply_to_emailResponde a un hilo de correo electrónico existente.
archive_emailMueve un correo electrónico a la carpeta de archivo.
validate_emailValida una dirección de correo electrónico antes de enviar: sintaxis, registros MX, detección de dominios desechables y cuentas de rol.
list_campaignsLista las campañas de email marketing con su estado, tamaño de audiencia y métricas principales.
get_campaignObté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_campaignCrea una nueva campaña de email marketing como borrador.
send_campaignEnvía una campaña ahora o prográmala para un momento futuro pasando scheduled_at.
list_contactsLista los contactos con su estado de suscripción y métricas de participación.
create_contactAñade un solo contacto.
update_contactActualiza un contacto existente por dirección de correo electrónico, incluido el cambio de estado de suscripción.
import_contactsImporta en bloque hasta 5.000 contactos en una sola llamada.
get_contact_scoreObté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_templatesLista 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_templateCrea una plantilla de correo electrónico reutilizable.
render_templateRenderiza una plantilla con variables de ejemplo y devuelve el HTML resultante y el asunto.
list_automationsLista los flujos de automatización (series de bienvenida, re-engagement, secuencias de goteo) con su tipo de disparador y estado activo..
get_automationObtén un flujo de automatización completo: disparador, cada paso con su retraso y estadísticas de finalización por paso..
create_automationCrea un flujo de automatización a partir de un disparador y una lista ordenada de pasos.
toggle_automationActiva o pausa una automatización.
list_ab_testsLista las pruebas A/B con resultados por variante y si ya se ha seleccionado un ganador..
create_ab_testCrea una prueba A/B en una campaña con dos o más variantes.
select_ab_test_winnerSelecciona la variante ganadora y envíala a la audiencia restante.
get_analyticsObté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_reportGenera un informe de análisis estructurado en un rango de fechas.
get_revenue_attributionAtribuye 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_statsObtén estadísticas de monetización de newsletters: suscriptores de pago, MRR, abandono e ingresos por patrocinio del período..
get_deliverability_scoreObté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_auditEjecuta 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_statusObtén el progreso de calentamiento de IP/dominio y la capacidad de envío restante de hoy.
check_dmarcComprueba 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_domainsLista los dominios de envío con su estado de verificación y sus registros DKIM/SPF/DMARC.
add_domainAñade un dominio de envío y devuelve los registros DNS que hay que publicar.
verify_domainVuelve a comprobar los registros DNS de un dominio y márcalo como verificado si se resuelven.
configure_inbound_domainConfigura el enrutamiento de correo electrónico entrante para un subdominio para que las respuestas lleguen a la bandeja de entrada unificada de MisarMail.
list_formsLista los formularios de registro con su estado de inserción y recuentos de conversión..
get_formObtén un formulario de registro, incluidos sus campos, código de inserción y comportamiento de redirección..
get_form_submissionsLista los envíos de un formulario de registro, incluidos los valores de los campos enviados y las marcas de tiempo..
create_landing_pageCrea una página de destino alojada con un formulario de captura de correo electrónico.
list_marketplace_itemsExplora el mercado de plantillas de MisarMail para encontrar plantillas de correo electrónico y automatización listas para usar..
get_marketplace_itemObtén un listado del mercado con su vista previa completa, autor y recuento de instalaciones..
list_inbox_conversationsLista las conversaciones de la bandeja de entrada unificada (hilos) con su estado e intención detectada.
get_inbox_conversation_messagesObté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_emailsEjecuta 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_keysLista las claves API de la cuenta con sus ámbitos y la última vez que se usaron.
generate_subject_linesGenera variantes de línea de asunto con IA para un tema de campaña, opcionalmente ajustadas a un tono y una audiencia.
list_integrationsLista las integraciones de terceros conectadas y su estado de sincronización..
get_integrationObtén la configuración, los ámbitos y el último resultado de sincronización de una integración..
toggle_integrationActiva o desactiva una integración.
list_sandbox_sendsLista los correos electrónicos capturados por el modo sandbox.
clear_sandboxElimina todos los correos electrónicos capturados en sandbox.
upgradeMuestra 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.

PromptDescripción
compose_emailRedacta un correo electrónico profesional y envíalo a través de MisarMail tras la confirmación.
campaign_performance_reportAnaliza el rendimiento de la campaña y produce mejoras priorizadas.
contact_import_guideImporta y organiza contactos de forma segura, con comprobaciones de consentimiento e higiene.
automation_builder_guideDiseña y construye un flujo de automatización de correo electrónico paso a paso.
deliverability_improvement_planDiagnostica la entregabilidad y produce un plan de acción semanal priorizado.
ab_test_planDiseña una prueba A/B estadísticamente significativa para una campaña.
list_hygiene_auditEncuentra y limpia los contactos que están dañando la reputación del remitente.
weekly_email_reportProduce 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.

URIDescripción
misarmail://account/domainsTus dominios de envío con estado de verificación y registros DNS.
misarmail://account/deliverabilityPuntuación de entregabilidad actual de la cuenta (0–100), calificación y factores que contribuyen..
misarmail://account/warmupEtapa 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://templatesPlantillas 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.

HabilidadCuándo usarla
ab-test-campaignDiseñ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-deliverabilityDiagnosticar 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-automationDiseñ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-listAuditar 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-reportProducir 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-campaignCrear, 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-emailEnviar 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-domainAñ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

MIT © Misar AI