MuntuAI MCP

Este repositorio contiene la documentación pública, el manifiesto y los clientes de referencia para el servidor MCP de MuntuAI en producción. La implementación ejecutable del servidor reside en el backend principal de Muntu.

El servidor oficial de Model Context Protocol (MCP) para MuntuAI — que brinda a los agentes de IA acceso programático a campañas de divulgación por correo electrónico, gestión de leads, infraestructura de dominios y eventos del espacio de trabajo en tiempo real.

Qué es esto

MuntuAI es una plataforma de divulgación por correo electrónico nativa en IA. Este servidor MCP permite que agentes externos (Claude, Cursor, scripts personalizados) se conecten a un espacio de trabajo de MuntuAI y realicen acciones: crear campañas, importar leads, verificar dominios, enviar correos electrónicos y suscribirse a eventos de webhook — todo a través de una interfaz MCP estándar sobre HTTP.

Protocolo: Model Context Protocol sobre HTTP (JSON-RPC 2.0)
Transporte: Streamable HTTP (text/event-stream o application/json)
Revisión del protocolo del servidor: 2025-03-26
URL del servidor: https://api.muntuai.com/api/mcp

Related MCP server: KeyID Agent Kit

Inicio rápido

1. Obtén una clave de agente

Inicia sesión en app.muntuai.com, ve a Configuración → Claves de agente y crea una clave. Elige el nivel de autonomía que se ajuste a lo que tu agente necesita:

Verás la clave en bruto una sola vez: mnt_<keyId>.<secret>. Cópiala de inediato.

2. Configura tu cliente

Nota de seguridad: guarda la clave de agente en bruto en una variabla de entorno o en un gestor de secretos. No la incluyas en el control de versiones ni la pegues en archivos compartidos.

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "muntu": {
      "url": "https://api.muntuai.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
      }
    }
  }
}

Cursor (.cursor/mcp.json o Configuración → MCP):

{
  "mcpServers": {
    "muntu": {
      "url": "https://api.muntuai.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
      }
    }
  }
}

Python:

pip install requests
export MUNTU_AGENT_KEY="mnt_YOUR_KEY_HERE"
python clients/python/muntu_mcp_client.py list-campaigns

Recomendado:

export MUNTU_SESSION_ID="$(uuidgen)"

Muntu utiliza el MUNTU_SESSION_ID opcional para agrupar las solicitudes en una única sesión MCP lógica, con el fin de aplicar controles de seguridad y presupuestos por sesión.

3. Haz tu primera llamada

Una vez conectado, pídele a tu agente:

"Enumera todas las campañas de mi espacio de trabajo de MuntuAI"

El agente invocará resources/read en muntu://campaigns/{workspaceId} y devolverá la lista de campañas.

O mediante la CLI de Python:

python clients/python/muntu_mcp_client.py list-campaigns
python clients/python/muntu_mcp_client.py list-domains
python clients/python/muntu_mcp_client.py list-emails

Qué pueden hacer los agentes

Recursos (vistas de solo lectura)

Herramientas (30 en total)

Agrupadas por dominio — consulta tools/README.md para ver el índice completo.

• Campaigns — crear, lanzar, pausar, reanudar, monitorizar, revisar borradores, enviar

• Leads — importar desde un array o una URL CSV, enriquecer, tomar muestras

• Senders — crear, eliminar, verificar estado, asignar a una campaña

• Dominios — añadir, verificar, comorbar estado

• Email generation — previsualizar, refinar, generar una guía de campaña

• Webhooks — suscribirse a eventos del espacio de trabajo

• Meta — obtener información de la clave de agente

Estructura del repositorio

muntuai-mcp/
├── README.md                    # This file
├── QUICKSTART.md                # 5-minute setup guide
├── docs/
│   ├── authentication.md        # Token format, headers, rate limits
│   ├── autonomy-levels.md       # Permission model
│   ├── resources.md             # All 6 resources with schemas
│   ├── events.md                # All event types and payloads
│   ├── webhooks.md              # Register, sign, verify
│   └── errors.md                # Error codes and handling
├── tools/
│   ├── README.md                # Full tool index
│   ├── campaigns.md
│   ├── leads.md
│   ├── senders.md
│   ├── domains.md
│   ├── email-generation.md
│   └── meta.md
├── workflows/
│   ├── README.md                # What workflows are
│   ├── launch-first-campaign.md
│   ├── review-and-send-drafts.md
│   ├── domain-setup.md
│   └── monitor-campaign.md
├── reference/
│   ├── event-types.md
│   ├── resource-schemas.md
│   └── tool-schemas.md
├── clients/
│   └── python/
│       ├── muntu_mcp_client.py  # Reference Python client
│       ├── README.md
│       └── examples/
├── agent-guides/
│   ├── for-claude.md
│   ├── for-cursor.md
│   └── decision-guide.md
└── .well-known/
    └── mcp-manifest.json        # Machine-readable capabilities manifest

Conceptos clave

Espacio de trabajo — Todos los datos en MuntuAI están delimitados a un espcio de trabajo. Tu clave de agente está vinculada a un único espcio de trabajo y solo puede acceder a los datos dentro de él.

Niveles de autonomía — Cada herramienta tiene un nivel mínimo requerido. Si el nivel de tu clave está por debajo del requisito, la llamada se rechaza y el intento se registra. Consulta docs/autonomy-levels.md.

Ciclo de vida de las campañas — uploaded → enriching → drafting → sending → completed. Los agentes pueden observr este ciclo de vida mediante get_campaign_performance y el recurso events. Consulta workflows/monitor-campaign.md.

Verificación de dominios — Antes de enviar, un dominio debe verificarse con el proveedor de correo electrónico. Esto implic publicar registros DNS y desencadenar la verificación. Consulta workflows/domain-setup.md.

Soporte

• Problemas de documentación: Abre un issue en este repositorio

• Soporte de la plataforma: support@muntuai.com

• Sitio web: muntuai.com