# Couryo

> Couryo é uma API de e-mail transacional e de produto da Wunka, feita para desenvolvedores e agentes de IA. Envio por API REST (https://api.couryo.com/v1) ou pelo servidor MCP remoto (https://mcp.couryo.com), com SMTP em breve. DNS automático, cada devolução explicada em linguagem simples, níveis de confiança públicos e pausas sempre explicadas. Preço em reais, Pix, boleto, nota fiscal e LGPD no Brasil; dólar no exterior.

- Autenticação: `Authorization: Bearer ck_live_...` (produção) ou `ck_test_...` (teste: nunca entrega, status `captured`).
- Use sempre o cabeçalho `Idempotency-Key` em POST: mesma chave e mesmo corpo em 24 h devolvem a mesma resposta; corpo diferente devolve 409.
- Envio: `POST /v1/emails` responde 202 com `{ id, status }` só quando o e-mail entrou na fila. Lote: `POST /v1/emails/batch`, até 100.
- Erros: `{ error: { type, code, message, param, doc_url, request_id } }`, com `code` estável.
- Webhooks no padrão Standard Webhooks (HMAC-SHA256, cabeçalhos webhook-id, webhook-timestamp e webhook-signature).
- Domínio: DKIM por CNAME em couryo1._domainkey e couryo2._domainkey, return path por CNAME em bounces.<domínio> para rp.couryo.com e DMARC; sem SPF no domínio principal.
- MCP remoto em https://mcp.couryo.com com a chave de API (`Authorization: Bearer ck_...`): send_email, get_email, domain_health e why_bounced. OAuth em breve.
- Toda página da documentação existe em Markdown: acrescente `.md` ao endereço.
- Preços: Grátis: 3.000 e-mails por mês (até 100 por dia) e 1 domínio, sem cartão. Pro: R$ 99 por mês com 50.000 e-mails e excedente de R$ 1,80 por mil. Escala: R$ 299 por mês com 200.000 e-mails e excedente de R$ 1,40 por mil. Empresa: sob medida. Fora do Brasil, em dólar: Pro US$ 19 (US$ 0,35 por mil extra) e Escala US$ 59 (US$ 0,28 por mil extra).

## Documentação

- [Guia do desenvolvedor](https://couryo.com/docs.md): Tudo para enviar e-mail transacional pelo Couryo, pela API REST ou pelo seu agente de IA (MCP).
- [Início rápido](https://couryo.com/docs/quickstart.md): Envie o primeiro e-mail pelo Couryo em 5 minutos, da criação da conta à linha do tempo da mensagem.
- [Autenticação e chaves](https://couryo.com/docs/authentication.md): Como autenticar na API do Couryo com chaves ck_live_ e ck_test_, escopos, IPs permitidos e boas práticas.
- [Modo de teste](https://couryo.com/docs/test-mode.md): Chaves ck_test_ capturam os e-mails sem entregar e simulam entrega, devolução, reclamação e adiamento pelo endereço do destinatário, com eventos e webhooks de verdade.
- [Enviar e-mail](https://couryo.com/docs/sending.md): POST /v1/emails em detalhe. Campos, destinatários em texto ou lista, idempotência, envio em lote, agendamento, tags, metadados, anexos e checagem antes do envio.
- [SMTP](https://couryo.com/docs/smtp.md): Em breve. O relay SMTP do Couryo, para enviar sem mudar o código. Servidor, portas, usuário, senha e exemplos para Laravel, Node e Supabase.
- [Domínios e DNS](https://couryo.com/docs/domains.md): Como verificar um domínio no Couryo. Os registros DKIM (couryo1 e couryo2), return path e DMARC que a API gera, por que não há SPF no domínio principal e como o DMARC sobe até p=reject.
- [Webhooks](https://couryo.com/docs/webhooks.md): Receba os eventos dos seus e-mails por webhook, assinados no padrão Standard Webhooks, com reenvio por até 3 dias. Exemplos de verificação em Node, PHP e Python.
- [Eventos e linha do tempo](https://couryo.com/docs/events.md): Cada etapa de um e-mail no Couryo, com horário, servidor de destino, código SMTP, resposta original e explicação em linguagem simples.
- [Supressão](https://couryo.com/docs/suppressions.md): A lista de supressão do Couryo protege sua reputação. Motivos, fluxos, como consultar, adicionar e remover endereços pela API.
- [Erros](https://couryo.com/docs/errors.md): Formato dos erros da API do Couryo, tipos, status HTTP e todos os códigos com causa e correção.
- [Limites e níveis de confiança](https://couryo.com/docs/limits.md): Níveis de confiança do Couryo, limites por dia e por mês, limites de cada plano (e-mails e domínios), limite de gasto, cabeçalhos de limite de requisição, pausas e como pedir revisão.
- [MCP e agentes de IA](https://couryo.com/docs/mcp.md): O servidor MCP remoto do Couryo em mcp.couryo.com, as ferramentas send_email, get_email, domain_health e why_bounced, e como conectar no Claude, no Cursor e no ChatGPT.

## Preços

- [Preços](https://couryo.com/precos.md): Planos, excedente, compromissos de preço e formas de pagamento, em Markdown.

## Legal (rascunhos)

- [Termos de uso](https://couryo.com/termos.md): Rascunho dos termos de uso do Couryo. O serviço, a conta, planos e pagamento, níveis de confiança, cancelamento e responsabilidades.
- [Política de privacidade](https://couryo.com/privacidade.md): Rascunho da política de privacidade do Couryo. Que dados tratamos, para quê, com quem compartilhamos, por quanto tempo e os seus direitos pela LGPD.
- [Política de uso aceitável e de suspensão](https://couryo.com/uso-aceitavel.md): Rascunho das regras de envio do Couryo. O que é proibido, como funcionam os níveis de confiança, a pausa gradual, o corte imediato e como pedir revisão.

## Opcional

- [Versão em inglês deste arquivo](https://couryo.com/en/llms.txt)
- [llms-full.txt](https://couryo.com/llms-full.txt)
- [Criar conta (painel)](https://app.couryo.com)