Sendmux Email MCP
oficialSendmux es una API de bandeja de entrada de correo electrónico y API de correo electrónico para agentes de IA.
¿Qué puedes hacer con Sendmux Email MCP?
- Buscar documentación de Sendmux — Pídele a tu asistente de IA que consulte las guías y referencias de API de Sendmux mediante
search_sendmux. - Gestionar buzones — Haz que tu asistente de IA busque, lea, organice y envíe correos electrónicos desde los buzones autorizados usando la superficie de Buzones.
- Supervisar recursos del equipo — Dirige a tu asistente de IA para gestionar dominios, buzones, cuentas de envío, registros, métricas, facturación y webhooks a través de la superficie de Administración.
- Enviar correos electrónicos — Indica a tu asistente de IA que envíe correos individuales o en lotes usando las herramientas de la superficie de Envío.
Documentación
MCP
Conecta herramientas de IA con la documentación y las herramientas de producto de Sendmux.
Sendmux tiene dos conexiones MCP. Usa Doc Search MCP cuando quieras que una herramienta de IA busque en la documentación de Sendmux. Usa MCP cuando quieras que un agente trabaje con las herramientas de Sendmux que autorices.
| Conexión | Úsala para | Servidor |
|---|---|---|
| Doc Search MCP | Buscar guías y referencias de API de Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Usar herramientas de Management, Mailbox y Sending. | https://mcp.sendmux.ai/mcp o el paquete local sendmux-mcp |
Info
MCP expone un conjunto de herramientas seleccionadas para agentes, no todos los endpoints de la API. Usa los SDK, la CLI o la referencia de API cuando necesites cobertura completa de endpoints.
Doc Search MCP
Doc Search MCP expone search_sendmux.
```json theme={null}
{
"mcpServers": {
"sendmux-docs": {
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"sendmux-docs": {
"type": "http",
"url": "https://sendmux.ai/docs/mcp"
}
}
}
```
```toml theme={null}
[mcp_servers.sendmux_docs]
url = "https://sendmux.ai/docs/mcp"
```
MCP
MCP expone las superficies de producto que concedas.
| Superficie | Úsala para | Acceso |
|---|---|---|
| Mailbox | Buscar, leer, organizar y enviar desde los buzones concedidos. | Concesión alojada con acceso a Mailbox, una clave smx_mbx_ o un token smx_agent_ con ámbito restringido localmente |
| Management | Gestionar recursos del equipo como dominios, buzones, cuentas de envío, registros, métricas, facturación y webhooks. | Concesión alojada con acceso a Management, o una clave smx_root_ localmente |
| Sending | Enviar correos individuales o en lote. | Concesión alojada con acceso a Sending, una clave smx_mbx_ o un token smx_agent_ de recurso de Sending aprobado por el propietario localmente |
MCP alojado es la opción predeterminada cuando tu cliente admite MCP remoto con OAuth de navegador. Mantiene a Sendmux en el flujo de autorización, evita distribuir claves API manuales a los agentes y muestra solo las herramientas permitidas por la concesión.
Info
Identidad del paquete:
sendmux-mcpVersión del paquete:
2.1.2Recurso alojado:
https://mcp.sendmux.ai/mcpTransporte alojado: Streamable HTTP
Número de herramientas seleccionadas: 54
Versiones de protocolo certificadas:
2025-11-25,2026-07-28Versiones de protocolo aceptadas en tiempo de ejecución:
2024-11-05,2025-03-26,2025-06-18,2025-11-25,2026-07-28. La aceptación en tiempo de ejecución proporciona compatibilidad; no certifica cada versión.
| Configuración | Valor |
|---|---|
| URL del servidor | https://mcp.sendmux.ai/mcp |
| Servidor de autorización | https://app.sendmux.ai |
| Comprobación de estado | https://mcp.sendmux.ai/health |
Usa la colección de Postman cuando quieras probar solicitudes MCP desde Postman:
Cuando te conectas, Sendmux te pide que elijas un equipo, superficies de producto y acceso a buzones cuando corresponda. Los tokens de acceso son de corta duración. Los tokens de actualización se rotan con cada uso y pueden durar hasta 30 días, a menos que la conexión se desconecte o expire.
Nota
Si concedes más de un buzón, inicia los flujos de trabajo de buzón con
mailbox_list_granted_mailboxesy pasa elmailbox_iddevuelto a las herramientas que actúan sobre un solo buzón.
Modos de conexión
Úsalo cuando tu cliente pueda abrir un flujo OAuth MCP basado en navegador. Úsalo cuando tu agente de codificación pueda lanzar un comando local en tu máquina. Úsalo cuando un cliente necesite una URL pero tú ejecutes el paquete MCP.Paquete local
Instala el paquete local desde PyPI:
pip install sendmux-mcp
Ejecuta una superficie:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Ejecuta todas las superficies de producto:
SENDMUX_MCP_SURFACES=mailbox,management,sending \
SENDMUX_MAILBOX_API_KEY=smx_mbx_... \
SENDMUX_MANAGEMENT_API_KEY=smx_root_... \
SENDMUX_SENDING_API_KEY=smx_mbx_... \
sendmux-mcp
El servidor valida los prefijos de clave antes de iniciar. Management requiere smx_root_. Sending acepta una clave smx_mbx_ con capacidad de envío o un token smx_agent_ de recurso de Sending aprobado por el propietario. Mailbox acepta una clave smx_mbx_ o un token smx_agent_ con ámbito restringido.
HTTP privado
El modo HTTP es útil cuando tu cliente MCP se conecta a una URL de servidor pero aún quieres ejecutar el paquete tú mismo.
SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765
El endpoint predeterminado es /mcp. /health devuelve las superficies seleccionadas. El modo HTTP requiere SENDMUX_MCP_HTTP_BEARER_TOKEN a menos que lo inicies explícitamente con --allow-unauthenticated-http.
Referencia de configuración
| Configuración | Entorno | Predeterminado | | - | - | - | | Superficies de herramientas | `SENDMUX_MCP_SURFACES` | Requerido para `sendmux-mcp` | | Clave API de respaldo | `SENDMUX_API_KEY` | Ninguna | | Clave API de Mailbox | `SENDMUX_MAILBOX_API_KEY` | Ninguna | | Clave API de Management | `SENDMUX_MANAGEMENT_API_KEY` | Ninguna | | Clave API de Sending | `SENDMUX_SENDING_API_KEY` | Ninguna | | URL base de API de Management y Mailbox | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL base de API de Sending | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Presupuesto de tiempo de reintento, en segundos | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | Sin definir | | Transporte | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Host HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Puerto HTTP | `SENDMUX_MCP_PORT` | `8765` | | Ruta HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Token bearer HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Requerido para HTTP | | Orígenes de navegador permitidos | `SENDMUX_MCP_ALLOWED_ORIGINS` | Sin orígenes de navegador | ```bash theme={null} SENDMUX_MCP_SURFACES=mailbox,management,sending \ SENDMUX_MAILBOX_API_KEY="$SENDMUX_MAILBOX_KEY" \ SENDMUX_MANAGEMENT_API_KEY="$SENDMUX_ROOT_KEY" \ SENDMUX_SENDING_API_KEY="$SENDMUX_SENDING_KEY" \ sendmux-mcp ```Descubrimiento de herramientas
Los nombres de las herramientas se generan a partir de las superficies de API públicas actuales. Abre el selector de herramientas de tu cliente MCP después de la autorización para ver las herramientas disponibles para esa conexión.Las conexiones alojadas muestran solo las herramientas permitidas por las superficies de producto, permisos y concesión de buzón seleccionados. Los servidores locales muestran las herramientas para las superficies y claves que proporciones al iniciar.