API de Email Temporário para Desenvolvedores — Guia Completo 2026

O GoneBox oferece uma API REST e um MCP Server para gerenciamento automatizado de email temporário. Desenvolvedores podem criar caixas de entrada descartáveis, buscar mensagens recebidas e deletar caixas programaticamente — tudo sem um navegador. Isso permite automatizar fluxos de verificação de email em pipelines CI/CD, testes de integração e workflows de agentes IA onde um humano não pode estar no loop.

O mercado de APIs de email temporário está crescendo rápido. A AgentMail levantou US$6 milhões em 2025 especificamente para infraestrutura de email para agentes IA. MailSink, Mail.tm e Guerrilla Mail oferecem APIs limitadas. O GoneBox combina uma API REST limpa com um MCP Server — o único serviço que permite agentes IA como Claude e Cursor gerenciarem email nativamente através do Model Context Protocol.

Por Que Devs Precisam de Uma API de Email Temporário

Testes Automatizados

Toda aplicação com registro de usuário precisa testar o fluxo de cadastro de ponta a ponta. Isso significa criar um endereço de email real, disparar o email de verificação, extrair o link de verificação e clicar nele. Sem uma API, isso requer intervenção manual ou gambiarras frágeis com caixas compartilhadas. Uma API de temp email transforma isso em uma chamada de 3 linhas.

Pipelines CI/CD

Pipelines de integração contínua rodam centenas de testes por dia. Se mesmo 5% desses testes envolvem verificação de email, você precisa de uma API de email confiável, de alto throughput, que cria caixas novas sob demanda e não te rate-limita até o chão. O plano Startup do GoneBox suporta 10.000 requests/dia a 300 requests/minuto.

Workflows de Agentes IA

Agentes IA (Claude, GPT, Cursor, Windsurf) cada vez mais executam tarefas multi-step que requerem verificação de email. Um agente se cadastrando em um serviço no seu lugar precisa criar uma caixa, ler o email de verificação, extrair o código e prosseguir. O MCP Server torna isso nativo — sem plumbing HTTP customizado.

Visão Geral da API

A API do GoneBox é baseada em REST, usa JSON e requer uma API key para endpoints autenticados.

URL Base

https://api.gonebox.email/v1

Autenticação

Authorization: Bearer SUA_API_KEY

Endpoints Principais

Método	Endpoint	Descrição
POST	/inboxes	Criar uma nova caixa de entrada temporária
GET	/inboxes/:id	Detalhes da caixa (endereço, TTL, contagem de mensagens)
GET	/inboxes/:id/messages	Listar mensagens na caixa
GET	/inboxes/:id/messages/:msgId	Ler mensagem específica (headers, corpo, anexos)
DELETE	/inboxes/:id	Deletar caixa imediatamente (antes do TTL)

Criar Caixa — curl

curl -X POST https://api.gonebox.email/v1/inboxes \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "sumiu.email", "ttl": 3600}'

Resposta:

{
  "id": "inbox_abc123",
  "address": "[email protected]",
  "ttl": 3600,
  "expiresAt": "2026-05-19T15:30:00Z",
  "messagesUrl": "/v1/inboxes/inbox_abc123/messages"
}

MCP Server para Agentes IA

O Model Context Protocol (MCP) é um padrão aberto que permite agentes IA interagirem com ferramentas externas nativamente. O MCP Server do GoneBox expõe operações de email temporário como ferramentas MCP, então qualquer cliente MCP-compatível pode gerenciar caixas sem escrever código HTTP.

Ferramentas MCP Disponíveis

• create_inbox — Criar caixa temporária com domínio e TTL opcionais
• list_messages — Listar mensagens de uma caixa
• read_message — Ler conteúdo de uma mensagem específica
• delete_inbox — Deletar caixa imediatamente

Exemplo com Claude Desktop

Adicione ao seu config MCP do Claude Desktop:

{
  "mcpServers": {
    "gonebox": {
      "command": "npx",
      "args": ["-y", "@gonebox/mcp-server"],
      "env": {
        "GONEBOX_API_KEY": "SUA_API_KEY"
      }
    }
  }
}

Depois peça ao Claude: "Crie um email temporário, cadastre-se no serviço X e leia o código de verificação." O Claude vai usar as ferramentas MCP automaticamente.

Exemplos de Código

JavaScript / Node.js

const API_KEY = process.env.GONEBOX_API_KEY;
const BASE = 'https://api.gonebox.email/v1';

// Criar caixa
const inbox = await fetch(`${BASE}/inboxes`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ domain: 'sumiu.email' }),
}).then(r => r.json());

console.log(`Caixa: ${inbox.address}`);

// Aguardar mensagens (poll a cada 2s)
let messages = [];
while (messages.length === 0) {
  await new Promise(r => setTimeout(r, 2000));
  messages = await fetch(`${BASE}/inboxes/${inbox.id}/messages`, {
    headers: { 'Authorization': `Bearer ${API_KEY}` },
  }).then(r => r.json());
}

console.log(`Recebido: ${messages[0].subject}`);

Python

import requests, time, os

API_KEY = os.environ["GONEBOX_API_KEY"]
BASE = "https://api.gonebox.email/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Criar caixa
inbox = requests.post(f"{BASE}/inboxes",
    headers={**headers, "Content-Type": "application/json"},
    json={"domain": "sumiu.email"}
).json()

print(f"Caixa: {inbox['address']}")

# Buscar mensagens
messages = []
while not messages:
    time.sleep(2)
    messages = requests.get(
        f"{BASE}/inboxes/{inbox['id']}/messages",
        headers=headers
    ).json()

print(f"Recebido: {messages[0]['subject']}")

Limites e Preços

Plano	Preço	Requests/Dia	Rate Limit	TTL Máximo
Free	Grátis	100	10/min	1 hora
Dev	R$79/mês	1.000	60/min	24 horas
Startup	R$249/mês	10.000	300/min	24 horas
Enterprise	R$999/mês	100.000	1.000/min	24 horas

Comparação com Alternativas

Serviço	API REST	MCP Server	Free Tier	Preço
GoneBox	Sim	Sim	100 req/dia	Desde R$79/mês
AgentMail	Sim	Não	Limitado	Preço enterprise
Mail.tm	Sim	Não	Ilimitado	Apenas grátis
MailSink	Sim	Não	Não	Desde US$19/mês
Guerrilla Mail	Não-oficial	Não	Sim	Apenas grátis

Comece em 30 Segundos

1. Acesse gonebox.email e crie uma conta grátis
2. Copie sua API key do dashboard
3. Rode o comando curl acima para criar sua primeira caixa
4. Para agentes IA, instale o MCP Server: npx @gonebox/mcp-server