Sendmux Email MCP
oficialSendmux é uma API de caixa de entrada de e-mail e API de e-mail para agentes de IA.
O que você pode fazer com Sendmux Email MCP?
- Pesquisar na documentação do Sendmux — Peça ao seu assistente de IA para consultar guias e referências de API do Sendmux via
search_sendmux. - Gerenciar caixas de correio — Faça seu assistente de IA pesquisar, ler, organizar e enviar e-mails das caixas de correio concedidas usando a superfície Mailbox.
- Supervisionar recursos da equipe — Direcione seu assistente de IA para gerenciar domínios, caixas de correio, contas de envio, logs, métricas, cobrança e webhooks por meio da superfície Management.
- Enviar e-mails — Instrua seu assistente de IA a enviar e-mails individuais ou em lote usando as ferramentas da superfície Sending.
Documentação
MCP
Conecte ferramentas de IA à documentação e às ferramentas de produto da Sendmux.
A Sendmux tem duas conexões MCP. Use o Doc Search MCP quando quiser que uma ferramenta de IA pesquise na documentação da Sendmux. Use o MCP quando quiser que um agente trabalhe com as ferramentas da Sendmux que você autorizar.
| Conexão | Use para | Servidor |
|---|---|---|
| Doc Search MCP | Pesquisar guias e referências de API da Sendmux. | https://sendmux.ai/docs/mcp |
| MCP | Usar ferramentas de Management, Mailbox e Sending. | https://mcp.sendmux.ai/mcp ou o pacote local sendmux-mcp |
Info
O MCP expõe um conjunto curado de ferramentas para agentes, não todos os endpoints de API. Use os SDKs, a CLI ou a referência de API quando precisar de cobertura completa de endpoints.
Doc Search MCP
O Doc Search MCP expõe 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
O MCP expõe as superfícies de produto que você conceder.
| Superfície | Use para | Acesso |
|---|---|---|
| Mailbox | Pesquisar, ler, organizar e enviar a partir de mailboxes concedidas. | Concessão hospedada com acesso a Mailbox, uma chave smx_mbx_ ou um token smx_agent_ com escopo localmente |
| Management | Gerenciar recursos da equipe, como domínios, mailboxes, contas de envio, logs, métricas, cobrança e webhooks. | Concessão hospedada com acesso a Management, ou uma chave smx_root_ localmente |
| Sending | Enviar e-mails únicos ou em lote. | Concessão hospedada com acesso a Sending, uma chave smx_mbx_ ou um token smx_agent_ de recurso de Sending aprovado pelo proprietário localmente |
O MCP hospedado é o padrão quando seu cliente suporta MCP remoto com OAuth no navegador. Ele mantém a Sendmux no fluxo de autorização, evita distribuir chaves de API manuais para agentes e mostra apenas as ferramentas permitidas pela concessão.
Info
Identidade do pacote:
sendmux-mcpVersão do pacote:
2.1.2Recurso hospedado:
https://mcp.sendmux.ai/mcpTransporte hospedado: Streamable HTTP
Contagem de ferramentas curadas: 54
Versões de protocolo certificadas:
2025-11-25,2026-07-28Versões de protocolo aceitas em runtime:
2024-11-05,2025-03-26,2025-06-18,2025-11-25,2026-07-28. A aceitação em runtime fornece compatibilidade; não certifica cada versão.
| Configuração | Valor |
|---|---|
| URL do servidor | https://mcp.sendmux.ai/mcp |
| Servidor de autorização | https://app.sendmux.ai |
| Verificação de saúde | https://mcp.sendmux.ai/health |
Use a coleção do Postman quando quiser testar requisições MCP a partir do Postman:
Ao conectar, a Sendmux pede que você escolha uma equipe, superfícies de produto e acesso a mailbox quando relevante. Os tokens de acesso têm vida curta. Os tokens de atualização são rotacionados a cada uso e podem durar até 30 dias, a menos que a conexão seja desconectada ou expire.
Note
Se você conceder mais de um mailbox, inicie os fluxos de trabalho de mailbox com
mailbox_list_granted_mailboxese passe omailbox_idretornado para as ferramentas que atuam em um único mailbox.
Modos de conexão
Use quando seu cliente puder abrir um fluxo OAuth MCP baseado em navegador. Use quando seu agente de codificação puder iniciar um comando local na sua máquina. Use quando um cliente precisar de uma URL, mas você mesmo executar o pacote MCP.Pacote local
Instale o pacote local a partir do PyPI:
pip install sendmux-mcp
Execute uma superfície:
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-mailbox
SENDMUX_API_KEY=smx_root_... sendmux-mcp-management
SENDMUX_API_KEY=smx_mbx_... sendmux-mcp-sending
Execute todas as superfícies de produto:
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
O servidor valida os prefixos das chaves antes de iniciar. Management requer smx_root_. Sending aceita uma chave smx_mbx_ com capacidade de envio ou um token smx_agent_ de recurso de Sending aprovado pelo proprietário. Mailbox aceita uma chave smx_mbx_ ou um token smx_agent_ com escopo.
HTTP privado
O modo HTTP é útil quando seu cliente MCP se conecta a uma URL de servidor, mas você ainda quer executar o pacote você mesmo.
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
O endpoint padrão é /mcp. /health retorna as superfícies selecionadas. O modo HTTP requer SENDMUX_MCP_HTTP_BEARER_TOKEN a menos que você o inicie explicitamente com --allow-unauthenticated-http.
Referência de configuração
| Configuração | Ambiente | Padrão | | - | - | - | | Superfícies de ferramentas | `SENDMUX_MCP_SURFACES` | Obrigatório para `sendmux-mcp` | | Fallback de chave de API | `SENDMUX_API_KEY` | Nenhum | | Chave de API de Mailbox | `SENDMUX_MAILBOX_API_KEY` | Nenhum | | Chave de API de Management | `SENDMUX_MANAGEMENT_API_KEY` | Nenhum | | Chave de API de Sending | `SENDMUX_SENDING_API_KEY` | Nenhum | | URL base da API de Management e Mailbox | `SENDMUX_APP_BASE_URL` | `https://app.sendmux.ai/api/v1` | | URL base da API de Sending | `SENDMUX_SENDING_BASE_URL` | `https://smtp.sendmux.ai/api/v1` | | Orçamento de tempo de tentativa, em segundos | `SENDMUX_MCP_RETRY_MAX_ELAPSED_SECONDS` | Não definido | | Transporte | `SENDMUX_MCP_TRANSPORT` | `stdio` | | Host HTTP | `SENDMUX_MCP_HOST` | `127.0.0.1` | | Porta HTTP | `SENDMUX_MCP_PORT` | `8765` | | Caminho HTTP | `SENDMUX_MCP_PATH` | `/mcp` | | Token bearer HTTP | `SENDMUX_MCP_HTTP_BEARER_TOKEN` | Obrigatório para HTTP | | Origens de navegador permitidas | `SENDMUX_MCP_ALLOWED_ORIGINS` | Nenhuma origem 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 ```Descoberta de ferramentas
Os nomes das ferramentas são gerados a partir das superfícies de API públicas atuais. Abra o seletor de ferramentas do seu cliente MCP após a autorização para ver as ferramentas disponíveis para aquela conexão.Conexões hospedadas mostram apenas as ferramentas permitidas pelas superfícies de produto, permissões e concessão de mailbox selecionadas. Servidores locais mostram as ferramentas para as superfícies e chaves que você fornece na inicialização.