Sendmux Email MCP
officielSendmux est une API de boîte de réception email et une API email pour les agents IA.
Que pouvez-vous faire avec Sendmux Email MCP ?
- Rechercher dans la documentation Sendmux — Demandez à votre assistant IA de consulter les guides et références API de Sendmux via
search_sendmux. - Gérer les boîtes mail — Demandez à votre assistant IA de rechercher, lire, organiser et envoyer des e-mails depuis les boîtes mail autorisées à l’aide de la surface Mailbox.
- Superviser les ressources de l’équipe — Demandez à votre assistant IA de gérer les domaines, boîtes mail, comptes d’envoi, journaux, métriques, facturation et webhooks via la surface Management.
- Envoyer des e-mails — Demandez à votre assistant IA d’envoyer des e-mails individuels ou en lot à l’aide des outils de la surface Sending.
Documentation
MCP
Connectez des outils d'IA à la documentation et aux outils produit Sendmux.
Sendmux propose deux connexions MCP. Utilisez Doc Search MCP lorsque vous souhaitez qu'un outil d'IA recherche dans la documentation Sendmux. Utilisez MCP lorsque vous souhaitez qu'un agent travaille avec les outils Sendmux que vous autorisez.
| Connexion | À utiliser pour | Serveur |
|---|---|---|
| Doc Search MCP | Rechercher dans les guides et références API Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Utiliser les outils Management, Mailbox et Sending. | https://mcp.sendmux.ai/mcp ou le package local sendmux-mcp |
Info
MCP expose un ensemble d'outils d'agent sélectionné, pas chaque point de terminaison API. Utilisez les SDK, la CLI ou la référence API lorsque vous avez besoin d'une couverture complète des points de terminaison.
Doc Search MCP
Doc Search MCP expose 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 expose les surfaces produit que vous accordez.
| Surface | À utiliser pour | Accès |
|---|---|---|
| Mailbox | Rechercher, lire, organiser et envoyer depuis les boîtes mail accordées. | Octroi hébergé avec accès Mailbox, clé smx_mbx_ ou jeton smx_agent_ limité localement |
| Management | Gérer les ressources d'équipe telles que les domaines, les boîtes mail, les comptes d'envoi, les journaux, les métriques, la facturation et les webhooks. | Octroi hébergé avec accès Management, ou clé smx_root_ localement |
| Sending | Envoyer des e-mails uniques ou en lot. | Octroi hébergé avec accès Sending, clé smx_mbx_ ou jeton smx_agent_ de ressource Sending approuvé par le propriétaire localement |
MCP hébergé est la valeur par défaut lorsque votre client prend en charge MCP distant avec OAuth navigateur. Il maintient Sendmux dans le flux d'autorisation, évite de distribuer des clés API manuelles aux agents et n'affiche que les outils autorisés par l'octroi.
Info
Identité du package :
sendmux-mcpVersion du package :
2.1.2Ressource hébergée :
https://mcp.sendmux.ai/mcpTransport hébergé : Streamable HTTP
Nombre d'outils sélectionnés : 54
Versions de protocole certifiées :
2025-11-25,2026-07-28Versions de protocole acceptées à l'exécution :
2024-11-05,2025-03-26,2025-06-18,2025-11-25,2026-07-28. L'acceptation à l'exécution offre une compatibilité ; elle ne certifie pas chaque version.
| Paramètre | Valeur |
|---|---|
| URL du serveur | https://mcp.sendmux.ai/mcp |
| Serveur d'autorisation | https://app.sendmux.ai |
| Vérification de santé | https://mcp.sendmux.ai/health |
Utilisez la collection Postman lorsque vous souhaitez tester les requêtes MCP depuis Postman :
Lorsque vous vous connectez, Sendmux vous demande de choisir une équipe, des surfaces produit et un accès aux boîtes mail le cas échéant. Les jetons d'accès sont de courte durée. Les jetons de rafraîchissement sont renouvelés à chaque utilisation et peuvent durer jusqu'à 30 jours, sauf si la connexion est déconnectée ou expire.
Note
Si vous accordez plus d'une boîte mail, commencez les flux de travail de boîte mail par
mailbox_list_granted_mailboxeset transmettez lemailbox_idretourné aux outils qui agissent sur une seule boîte mail.
Modes de connexion
À utiliser lorsque votre client peut ouvrir un flux OAuth MCP basé sur navigateur. À utiliser lorsque votre agent de codage peut lancer une commande locale sur votre machine. À utiliser lorsqu'un client a besoin d'une URL mais que vous exécutez vous-même le package MCP.Package local
Installez le package local depuis PyPI :
pip install sendmux-mcp
Exécutez une surface :
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Exécutez toutes les surfaces produit :
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
Le serveur valide les préfixes de clés avant de démarrer. Management nécessite smx_root_. Sending accepte une clé smx_mbx_ capable d'envoyer ou un jeton smx_agent_ de ressource Sending approuvé par le propriétaire. Mailbox accepte une clé smx_mbx_ ou un jeton smx_agent_ limité.
HTTP privé
Le mode HTTP est utile lorsque votre client MCP se connecte à une URL de serveur mais que vous souhaitez toujours exécuter le package vous-même.
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
Le point de terminaison est par défaut /mcp. /health renvoie les surfaces sélectionnées. Le mode HTTP nécessite SENDMUX_MCP_HTTP_BEARER_TOKEN sauf si vous le démarrez explicitement avec --allow-unauthenticated-http.
Référence de configuration
| Paramètre | Environnement | Défaut | | - | - | - | | Surfaces d'outils | `SENDMUX_MCP_SURFACES` | Requis pour `sendmux-mcp` | | Repli de clé API | `SENDMUX_API_KEY` | Aucun | | Clé API Mailbox | `SENDMUX_MAILBOX_API_KEY` | Aucun | | Clé API Management | `SENDMUX_MANAGEMENT_API_KEY` | Aucun | | Clé API Sending | `SENDMUX_SENDING_API_KEY` | Aucun | | URL de base API Management et Mailbox | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL de base API Sending | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Budget de temps de nouvelle tentative, en secondes | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | Non défini | | Transport | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Hôte HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Port HTTP | `SENDMUX_MCP_PORT` | `8765` | | Chemin HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Jeton porteur HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Requis pour HTTP | | Origines navigateur autorisées | `SENDMUX_MCP_ALLOWED_ORIGINS` | Aucune origine navigateur | ```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 ```Découverte d'outils
Les noms d'outils sont générés à partir des surfaces API publiques actuelles. Ouvrez le sélecteur d'outils de votre client MCP après l'autorisation pour voir les outils disponibles pour cette connexion.Les connexions hébergées n'affichent que les outils autorisés par les surfaces produit, les permissions et l'octroi de boîte mail sélectionnés. Les serveurs locaux affichent les outils pour les surfaces et les clés que vous fournissez au démarrage.