mailtani

Servidor MCP de Mailtani

Gestiona tu email marketing directamente desde Claude, Cursor o cualquier agente de IA compatible con MCP.

El servidor MCP de Mailtani expone tus contactos, listas, segmentos, campañas, correos, etiquetas, campos personalizados y seguimiento de eventos como herramientas nativas de IA, para que tu agente pueda enviar campañas, inscribir contactos y rastrear eventos sin salir del chat.

---

Lo que puedes hacer

Categoría	Herramientas
Contactos	Listar, crear (o actualizar), modificar, eliminar
Listas	Listar todas, crear, añadir contactos, eliminar contacto
Segmentos	Listar todos, crear con condiciones, obtener contactos coincidentes
Campañas	Listar, crear difusión, crear secuencia, crear flujo (todas como borradores)
Correos	Listar correos enviados, enviar correo transaccional único
Etiquetas	Listar todas, crear, eliminar
Campos personalizados	Listar todos, crear
Eventos	Registrar un evento personalizado (activa flujos)

Ejemplos de indicaciones que puedes usar

"Create a broadcast campaign called 'Q3 Newsletter' targeting my 'Leads' list."

"Create a contact for john@acme.com, tag him as VIP, and send him the onboarding email."

"Track a purchase_completed event for sarah@example.com with plan=pro."

"Show me all contacts added in the last 7 days."

"Set up a 3-step welcome sequence for new signups with delays of 0, 3, and 7 days."

"Create a flow that sends an email whenever a contact is added to my project."

---

Autenticación

El servidor MCP utiliza el mismo sistema de claves API que la API REST de Mailtani.

Cada solicitud requiere dos encabezados:

Encabezado	Valor
Authorization	Bearer mk_YOUR_API_KEY
X-Project-Id	Tu ID de proyecto (se encuentra en Configuración → API)

Genera una clave API en Configuración → Claves API dentro de tu cuenta de Mailtani.

---

Configuración

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mailtani": {
      "type": "http",
      "url": "https://mailtani.com/mcp",
      "headers": {
        "Authorization": "Bearer mk_YOUR_API_KEY",
        "X-Project-Id": "YOUR_PROJECT_ID"
      }
    }
  }
}

Reinicia Claude Desktop. Verás un icono de martillo que confirma que el servidor se ha conectado.

Claude Code

Ejecuta en tu terminal:

claude mcp add --transport http mailtani https://mailtani.com/mcp \
  --header "Authorization: Bearer mk_YOUR_API_KEY" \
  --header "X-Project-Id: YOUR_PROJECT_ID"

Cursor

Añade a la configuración MCP de Cursor (Cursor → Settings → MCP):

{
  "mailtani": {
    "type": "http",
    "url": "https://mailtani.com/mcp",
    "headers": {
      "Authorization": "Bearer mk_YOUR_API_KEY",
      "X-Project-Id": "YOUR_PROJECT_ID"
    }
  }
}

Codex

Añade a ~/.codex/config.json:

{
  "mcpServers": {
    "mailtani": {
      "type": "http",
      "url": "https://mailtani.com/mcp",
      "headers": {
        "Authorization": "Bearer mk_YOUR_API_KEY",
        "X-Project-Id": "YOUR_PROJECT_ID"
      }
    }
  }
}

Cualquier cliente compatible con MCP

Endpoint:  POST https://mailtani.com/mcp
Protocol:  MCP over HTTP (JSON-RPC 2.0)
Auth:      Authorization: Bearer mk_...
Scope:     X-Project-Id: <id>
Rate limit: 30 requests / minute

---

Referencia de herramientas

Contactos

Herramienta	Descripción
list-contacts	Listar contactos con búsqueda opcional, filtro por lista/etiqueta/estado, paginación
create-contact	Crear o actualizar un contacto por correo electrónico; opcionalmente asignar listas y etiquetas
update-contact	Actualizar campos, listas y etiquetas de un contacto por ID
delete-contact	Eliminar permanentemente un contacto por ID

Listas

Herramienta	Descripción
list-lists	Listar todas las listas de contactos con recuentos de contactos
create-list	Crear una nueva lista de contactos
add-contact-to-list	Añadir hasta 500 contactos a una lista a la vez
remove-contact-from-list	Eliminar un solo contacto de una lista

Segmentos

Herramienta	Descripción
list-segments	Listar todos los segmentos con recuentos de contactos
create-segment	Crear un segmento con condiciones de filtro (máximo 50)
get-segment-contacts	Obtener contactos paginados que coinciden con un segmento

Campañas

Las campañas siempre se crean como borradores. Abre la aplicación Mailtani para revisarlas y activarlas.

Herramienta	Descripción
list-campaigns	Listar campañas filtradas por tipo o estado
create-broadcast	Crear un borrador de envío masivo único; opcionalmente dirigir a listas y segmentos
create-sequence	Crear un borrador de secuencia de goteo en varios pasos con retrasos por paso
create-flow	Crear un borrador de flujo de automatización visual activado por el comportamiento del contacto

Correos

Herramienta	Descripción
list-emails	Listar correos enviados, opcionalmente filtrados por contacto
send-email	Enviar un correo transaccional único a cualquier dirección

Etiquetas

Herramienta	Descripción
list-tags	Listar todas las etiquetas con recuentos de contactos
create-tag	Crear una nueva etiqueta
delete-tag	Eliminar una etiqueta por ID

Campos personalizados

Herramienta	Descripción
list-custom-fields	Listar todos los campos personalizados
create-custom-field	Crear un campo personalizado (idempotente por nombre)

Eventos

Herramienta	Descripción
track-event	Registrar un evento personalizado para un contacto; persiste propiedades y activa flujos

---

Seguridad

• Todas las operaciones están limitadas a tu proyecto mediante X-Project-Id — ninguna herramienta puede leer o modificar datos de otro proyecto
• Las claves API se almacenan con hash SHA-256 en reposo; el texto plano nunca se guarda
• Límite de 30 solicitudes por minuto
• Los límites diarios de envío de correos se aplican según tu plan

---

Enlaces

• Mailtani
• Documentación de la API REST
• Documentación del servidor MCP
• Obtener una clave API