MisarMail MCP Server
Ejecuta toda tu operación de correo electrónico desde un asistente de IA. 55 herramientas, 8 indicaciones, 4 recursos. Funciona con Claude, Cursor, VS Code, Windsurf y cualquier cliente MCP.
Servidor MCP alojado
npx add-mcp 'https://api.misar.io/mail/mcp'Se instala en Claude Code, Codex, Cursor y más
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 HTTP Streamable.
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, sin necesidad de copiar y pegar para la primera:
- Inicio de sesión con 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 transaccional desde una cuenta verificada de MisarMail. |
list_emails | Lista los 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 las campañas de email marketing 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 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 interacción. |
create_contact | Añade 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 interacción, el nivel de interacción y el riesgo de abandono de un contacto, o los contactos con menor interacción de la lista cuando se omite contact_id. |
list_templates | Lista las plantillas de correo guardadas con sus marcadores 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 ejemplo y devuelve el HTML resultante y el asunto. |
list_automations | Lista los flujos 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 automatización completo: activador, 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 activador, guardado como borrador en pausa. |
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 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 e interacció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 medio 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 en 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 debe publicarse. |
list_domains | Lista los dominios de envío con 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 deben publicarse. |
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 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 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 encontrar 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 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 categorización con IA sobre un lote de correos 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 hora de último 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 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 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 mejora. |
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 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 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 de rendimiento de correo 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 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 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 interacción. Úsala para higiene de listas, reenganche, 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 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 puntual 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 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 entrante. |
Seguridad
Las acciones destructivas e irreversibles están anotadas (destructiveHint) para que
los clientes puedan solicitar 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 de otro modo 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