Chame o servidor MCP de e-mail
direto do curl ou de um script
Sem cliente, sem SDK. Um endpoint Streamable HTTP que fala JSON-RPC 2.0, autenticado com uma chave bearer com escopo que você revoga com um clique.
O único valor de que você precisa
Faça um POST de JSON-RPC 2.0 para https://mcpemails.com/api/mcp com um header Authorization Bearer contendo uma chave de API do seu painel. Os métodos suportados são initialize, tools/list, tools/call, prompts/list e prompts/get.
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticação | Authorization: Bearer, com uma chave de API de permissões limitadas do seu painel. |
Como um script ou cliente HTTP se conecta: uma chave de API com escopo
Um script ou cliente HTTP direto não executa o fluxo OAuth no navegador com um servidor MCP remoto, então ele autentica com um token bearer. Crie uma chave de API no seu painel, marque só os escopos de que o agente precisa e envie a chave do seu script ou cliente HTTP como um header Authorization: Bearer. Conexões por chave e por OAuth chegam ao mesmo endpoint e recebem o mesmo catálogo de ferramentas; a diferença está só em como o token é obtido.
Como conectar o curl and the raw API à sua caixa de entrada
Quatro passos. Os dois primeiros são iguais para todos os clientes, os demais são específicos deste.
Crie uma conta grátis e conecte uma caixa de correio
Crie sua conta em mcpemails.com, sem cartão, e conecte sua caixa de correio no painel, em Caixas de entrada. Uma caixa de entrada é grátis, para sempre.
Crie uma chave de API com escopo
No painel, em Chaves de API, clique em Criar chave. Dê um nome e marque só os escopos de que este agente precisa: read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email e manage:automations. A chave tem o formato mcpe_ seguido de 64 caracteres hexadecimais e aparece uma única vez, então copie antes de fechar a janela.
Chame o endpoint
Faça um POST com um corpo JSON-RPC 2.0 para https://mcpemails.com/api/mcp com a chave no header Authorization. Comece com tools/list para ver o catálogo e depois inbox_list para descobrir os ids das suas caixas de correio.
Trate a resposta
Os resultados voltam como JSON-RPC 2.0. Resultados bem-sucedidos também trazem um objeto tipado structuredContent, então um script não precisa interpretar texto corrido.
curl -X POST https://mcpemails.com/api/mcp \
-H "Authorization: Bearer mcpe_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no curl
Envie a chave no header, não na query string
Uma chave em ?key= ou ?api_key= ainda é aceita para integrações anteriores ao header, mas não deve ser usada em nada novo. Credenciais na URL ficam no histórico do navegador, em logs de proxy, em headers de referer e em sistemas de monitoramento, e você não controla nenhum deles. O header Authorization é o caminho suportado.
Chamadas de saída aceitam uma chave de idempotência, e repetir sem ela é um risco real
Envio, resposta, encaminhamento, envio de rascunho e envio agendado aceitam uma chave de idempotência opcional, respeitada por 24 horas. Um timeout de rede num envio é ambíguo por natureza: o e-mail pode muito bem ter saído. Com uma chave de idempotência, repetir é seguro. Sem ela, repetir é um segundo e-mail.
Operações longas são longas de verdade
Uma pesquisa com movimentação numa caixa de correio grande já levou cerca de 152 segundos em produção, e o proxy permite até 270 segundos antes de desistir por conta própria. Defina um timeout no cliente que leve isso em conta, e não os poucos segundos de sempre, ou você vai cancelar operações que estavam prestes a dar certo.
Não há push, em nenhuma direção
Sem webhooks, sem eventos iniciados pelo servidor, sem URL de callback para registrar. Reagir a e-mails novos significa fazer polling, por exemplo email_read com action: "list" e só os não lidos, no intervalo que o seu fluxo precisar. Os limites de taxa valem por chave, em janelas por minuto, por hora e por dia dimensionadas para o seu plano.
Limites que vale a pena conhecer
- As solicitações têm limite de taxa por chave, em janelas por minuto, por hora e por dia dimensionadas para o seu plano. Uma resposta 429 traz Retry-After.
- O servidor funciona só com solicitação e resposta. Não há webhooks nem eventos iniciados pelo servidor, então um e-mail novo nunca acorda seu agente sozinho. Para reagir a e-mails que chegam, faça polling em intervalos programados.
- Os e-mails são buscados ao vivo no seu provedor a cada chamada e nunca armazenados. Só o token OAuth ou a senha de app criptografados ficam guardados, então um token revogado ou uma senha da caixa de correio alterada encerra o acesso na hora.
curl and the raw API e e-mail: perguntas e respostas
Posso usar isso sem um cliente MCP?
Sim. É um endpoint HTTPS comum que fala JSON-RPC 2.0, então curl, um cron job, um serviço de backend ou qualquer biblioteca HTTP pode chamá-lo. Autentique com uma chave de API bearer do painel, em Chaves de API. O catálogo de ferramentas é idêntico ao que um cliente MCP vê.
Quais métodos JSON-RPC são suportados?
initialize, tools/list, tools/call, prompts/list e prompts/get. Resultados bem-sucedidos trazem um objeto tipado structuredContent junto com o conteúdo legível por humanos, e é ele que um script deve ler.
Como torno as repetições seguras?
Passe uma chave de idempotência nas operações de saída. Envio, resposta, encaminhamento, envio de rascunho e envio agendado aceitam uma e a respeitam por 24 horas, então repetir a mesma solicitação depois de um timeout não gera um segundo e-mail. Leituras já são seguras de repetir por natureza.
Quais são os limites de taxa?
Janelas por minuto, por hora e por dia por chave, dimensionadas para o seu plano: uma chave pode usar todo o teto por minuto do plano, e várias chaves o dividem. Respostas bem-sucedidas de tools/call trazem RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset.
Meus e-mails ficam armazenados nos seus servidores?
Não. Cada mensagem é buscada ao vivo no seu provedor para a solicitação que a pediu e entregue direto ao seu cliente. Só o token OAuth ou a senha de app criptografados ficam guardados, para que as próximas chamadas possam autenticar. Excluir a caixa de entrada no painel, ou revogar o acesso no seu provedor, encerra a conexão na hora.
Automatize sua caixa de entrada com scripts
Um endpoint, uma chave com escopo. Uma caixa de entrada grátis para sempre, sem cartão.