Servidor MCP do SendHQ

O que é este servidor

O servidor MCP do SendHQ permite que um agente de IA opere um workspace do SendHQ por meio do Model Context Protocol: enviar e-mails (individuais, em lote, com template, respostas, anexos, novas tentativas idempotentes), ler e pesquisar e-mails enviados e recebidos (assuntos, corpos e nomes de anexos) e seus eventos de entrega, organizar e-mails em marcadores com regras de arquivamento automático, gerenciar rascunhos e anexos privados, criar e publicar templates hospedados, adicionar e verificar domínios e seu DNS, configurar o recebimento de e-mails e endereços de entrada, inspecionar entregabilidade, bounces, reclamações e supressões, e ler uso da conta, estado de cobrança, análises e metadados de chaves de API.

É um servidor stdio local, embutido no binário da CLI sendhq. Seu cliente MCP inicia sendhq mcp como processo filho e fala JSON-RPC por stdin/stdout. Cada chamada de ferramenta vira uma requisição documentada à API REST do SendHQ em https://sendhq.cc/api/v1, autenticada com a chave de API do seu workspace; portanto, o servidor MCP tem exatamente as permissões dessa chave e nenhuma a mais.

• 59 ferramentas em 8 grupos, geradas a partir de um único catálogo que também é publicado como tools.json.
• JSON Schemas estritos: argumentos desconhecidos, tipos errados e campos obrigatórios ausentes são rejeitados localmente, antes de qualquer coisa chegar ao SendHQ.
• Erros estruturados com um code estável, o status HTTP, uma explanation, um remedy concreto e a indicação de que tentar novamente pode ajudar ou não.
• Toda ferramenta que envia e-mail real ou destrói dados avisa isso nas primeiras palavras da descrição e traz anotações de segurança do MCP.
• O modo --read-only oculta todas as ferramentas de envio e de alteração.
• Nada é registrado em log. O stdout carrega apenas mensagens do protocolo; a chave de API e o conteúdo das mensagens nunca chegam a um log.

Use o SendHQ no Claude e no ChatGPT

Não é preciso instalar nada: o SendHQ também executa este servidor como conector hospedado em https://mcp.sendhq.cc/mcp, com as mesmas ferramentas. Você entra com sua conta do SendHQ em vez de colar uma chave.

Claude

1. Abra Settings → Connectors e encontre o SendHQ no diretório, ou escolha Add custom connector e cole https://mcp.sendhq.cc/mcp.
2. Clique em Connect, entre no SendHQ, revise o acesso e clique em Allow.
3. Peça ao Claude para verificar sua caixa de entrada, enviar um e-mail do seu domínio verificado ou explicar um bounce.

ChatGPT

1. Open Settings → Security and login and turn on Developer mode.
2. Go to chatgpt.com/plugins, click Create MCP app, name it SendHQ and enter https://mcp.sendhq.cc/mcp.
3. Sign in to SendHQ and click Allow, then pick SendHQ from the tools menu in a new chat.

Muse by Meta

In Muse, open Connectors and search for SendHQ. Click Connect, sign in to SendHQ and click Allow.

Aprovação e desconexão

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• As ferramentas que enviam e-mail real ou excluem dados são identificadas como tal. Se o assistente pergunta antes é uma configuração por ferramenta no próprio assistente: no Claude, escolha Needs approval para essas ferramentas em Settings → Connectors → SendHQ.
• O conector recebe a própria chave de API, com o nome do assistente (por exemplo, “Claude (AI connector)”). Exclua-a em API Keys para desconectar imediatamente.
• Ele não pode criar nem revogar chaves de API, nem alterar a cobrança. Os anexos são enviados e retornados em base64; não há acesso a arquivos locais.
• Workspaces sem plano pago (teste de integração) só podem entregar para o e-mail da conta ou para um endereço do simulador do AWS SES.

Dúvidas: postmaster@sendhq.cc. Privacidade: sendhq.cc/privacy.

Instalação

Instale o binário sendhq (Linux, macOS e Windows em x86-64 e arm64). O instalador verifica o checksum da versão e coloca o binário em ~/.local/bin por padrão.

curl -fsSL https://downloads.sendhq.cc/install.sh | sh

irm https://downloads.sendhq.cc/install.ps1 | iex

sendhq version
SENDHQ_API_KEY=re_your_key sendhq doctor

Crie uma chave de API no painel em https://sendhq.cc/app#/keys. O servidor MCP não pode criar chaves. O único comando que executa o servidor é:

SENDHQ_API_KEY=re_your_key sendhq mcp

Normalmente você nunca o executa manualmente: o cliente MCP o inicia. Quando executado em um terminal, ele fica aguardando JSON-RPC no stdin.

Configure seu cliente

Claude Code

claude mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp

# read-only variant
claude mcp add sendhq-readonly --env SENDHQ_API_KEY=re_your_key -- sendhq mcp --read-only

Adicione --scope user para disponibilizá-lo em todos os projetos, ou --scope project para gravá-lo no .mcp.json do projeto. Em um .mcp.json compartilhado, referencie a chave pelo ambiente em vez de fazer commit dela; o Claude Code expande ${VAR} no .mcp.json.

{
  "mcpServers": {
    "sendhq": {
      "command": "sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "${SENDHQ_API_KEY}"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.sendhq]
command = "sendhq"
args = ["mcp"]
env = { SENDHQ_API_KEY = "re_your_key" }

Ou pela linha de comando: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Edite claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) e reinicie o app. Aplicativos de desktop não herdam o PATH do seu shell; use o caminho absoluto do binário (which sendhq).

{
  "mcpServers": {
    "sendhq": {
      "command": "/Users/you/.local/bin/sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "re_your_key"
      }
    }
  }
}

Qualquer outro cliente MCP

Configure um servidor stdio com o comando sendhq, os argumentos ["mcp"] (opcionalmente "--read-only") e as variáveis de ambiente abaixo. O servidor aceita as versões 2024-11-05, 2025-03-26, 2025-06-18 e 2025-11-25 do protocolo MCP e implementa initialize, ping, tools/list e tools/call. Os resultados das ferramentas trazem um bloco de texto JSON e também structuredContent.

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_service_health","arguments":{}}}

Não há transporte HTTP hospedado para o servidor com escopo de conta. Um endpoint MCP remoto com permissão de escrita exigiria OAuth por usuário, que o SendHQ não oferece; o binário local mantém a chave na máquina que já a possui.

Ambiente e flags

A chave é enviada somente no cabeçalho Authorization: Bearer para a URL base configurada. Ela nunca é impressa, registrada em log, repetida em erros nem incluída nos resultados das ferramentas.

Modelo de segurança para agentes

• Envia e-mail real. send_email, send_batch e send_template_test entregam e-mails a pessoas reais e consomem créditos de entrega. As descrições delas começam com SENDS REAL EMAIL. Chame-as somente quando o usuário tiver pedido explicitamente o envio daquela mensagem específica, com destinatários, remetente e conteúdo confirmados.
• Destrutivas. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox e remove_suppression são marcadas com destructiveHint: true e suas descrições começam com DESTRUCTIVE. Confirme antes com o usuário. remove_suppression enfraquece um bloqueio de segurança e só é apropriada quando uma pessoa confirma que o endereço voltou a funcionar.
• Altera estado. Criar ou atualizar rascunhos, templates, domínios e caixas de entrada, publicar templates e iniciar a verificação alteram o workspace, mas não enviam e-mails.
• Somente leitura. Todo o resto é readOnlyHint: true e pode ser chamado livremente.
• O DNS nunca é alterado por este servidor. add_domain retorna registros para uma pessoa publicar; get_domain_connect_link retorna uma URL de consentimento que uma pessoa precisa abrir e aprovar no provedor de DNS.
• A cobrança nunca é alterada por este servidor. get_account lê apenas o plano, o uso e o estado da assinatura.
• Workspaces sem plano pago (teste de integração) só podem entregar para o e-mail do dono da conta (get_account → user.email) ou para um endereço do simulador do AWS SES, como success@simulator.amazonses.com, e não podem enviar anexos.
• Aceito não é entregue. Um envio bem-sucedido retorna um ID; as evidências de entrega, bounce e reclamação chegam depois em list_email_events. Nunca afirme que o e-mail chegou à caixa de entrada nem que alguém leu a mensagem.
• Não troque o endereço De para contornar uma pausa 423 e nunca adicione de novo destinatários que se descadastraram ou reclamaram.

Chaves de API estão fora do escopo

Por design, não há ferramentas que criem, modifiquem, rotacionem, revoguem ou excluam chaves de API. Um agente não deve emitir nem destruir credenciais. list_api_keys retorna apenas nomes, prefixos não secretos e horários do último uso. O gerenciamento de chaves fica no painel, com uma pessoa autenticada.

Fluxos de trabalho

1. Primeiro envio

1. get_service_health confirma que a API está acessível (funciona sem chave).
2. get_account mostra o plano (access.tier), a cota restante e user.email. No teste, esse e-mail é o único destinatário real permitido.
3. list_sending_identities lista os endereços De que você pode usar. Se estiver vazia, faça primeiro o fluxo de domínio.
4. Confirme remetente, destinatário, assunto e corpo com o usuário e, depois, use send_email com um idempotency_key.
5. list_email_events com o id retornado mostra delivery, bounce, complaint ou reject assim que o provedor informa (em geral, de segundos a minutos).

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "SendHQ is connected",
    "text": "It works.",
    "idempotency_key": "first-send-2026-09-26"
  }
}

2. Verificação de domínio de ponta a ponta

1. add_domain com name: "example.com". O resultado inclui os registros DNS (CNAMEs de DKIM, verificação do SES, SPF, DMARC recomendado).
2. get_dns_provider com o domain_id detecta o provedor de DNS autoritativo e retorna o host relativo exato a informar para cada registro nesse provedor.
3. Se providers.domainConnect.available for true, get_domain_connect_link retorna uma URL de consentimento. Entregue-a a uma pessoa; nada muda até que ela aprove no provedor. Caso contrário, entregue à pessoa os registros a publicar. Nunca publique um segundo registro SPF: incorpore include:amazonses.com ao valor v=spf1 existente.
4. verify_domain verifica de novo o DNS e o SES. O status passa por pending, checking e propagating até verified. Consulte verify_domain ou get_domain a cada 30 a 60 segundos; o DNS pode levar de minutos a horas.
5. Quando status for verified, os endereços do domínio aparecem em list_sending_identities.

3. Bounces, reclamações e supressões

1. list_blocked_recipients retorna todos os endereços bloqueados com o motivo (bounce, complaint, unsubscribe) e uma contagem resumida.
2. list_suppressions retorna as supressões por hard bounce e por reclamação; deliverability_stats traz as taxas de entrega, bounce e reclamação dos últimos 30 dias; list_sender_reputation mostra quais endereços De estão com o ritmo reduzido ou pausados.
3. Um envio que contém um destinatário suprimido falha com 422 recipient_suppressed. Remova esse destinatário e envie de novo.
4. Somente quando uma pessoa confirmar que uma caixa postal que deu bounce voltou a funcionar, chame remove_suppression. Supressões por reclamação são permanentes (409 complaint_suppression_locked).

4. Receber e-mails de entrada

1. O domínio (muitas vezes um subdomínio, como inbound.example.com) precisa estar verificado.
2. setup_inbound provisiona o recebimento e retorna um registro MX. Uma pessoa o publica.
3. verify_inbound até que status seja ready.
4. create_inbox com domain_id e local_part (por exemplo, support) cria support@inbound.example.com.
5. Consulte list_emails com direction: "in" e unread: true (opcionalmente inbox_id). Leia uma mensagem com get_email, a conversa com get_thread, os anexos com download_attachment e marque-a como tratada com mark_email (read: true).
6. Responda na mesma thread com send_email e reply_to_email_id; o SendHQ define In-Reply-To, References e a thread.

5. Webhooks e notificações de eventos

Atualmente, o SendHQ não oferece webhooks configuráveis pelo cliente, portanto não há uma ferramenta de webhook. As notificações dos provedores são processadas dentro do SendHQ e expostas por meio de leituras. Em vez disso, faça polling: list_email_events para o resultado de uma mensagem, list_emails com status (por exemplo, bounced) ou after para mudanças recentes, list_emails com direction: "in" e unread: true para novos e-mails de entrada e list_blocked_recipients para novas supressões. Consulte no máximo cerca de uma vez por minuto para cada pergunta.

6. Diagnosticar uma falha de entrega

1. Encontre a mensagem: list_emails com direction: "out" e to ou query, ou get_email se você tiver o ID. status: failed significa que o SendHQ ou o provedor a rejeitou na submissão; o erro do e-mail explica o motivo.
2. list_email_events: bounce (permanente ou transitório, com o diagnóstico do provedor), complaint, reject ou delivery. Nenhum evento ainda significa que o provedor não informou nada; aguarde e verifique de novo.
3. Se a própria chamada de envio falhou, leia o code do erro: sender_domain_unverified → conclua a verificação do domínio; recipient_suppressed → o endereço já teve hard bounce ou reclamação; sender_paused → inspecione list_sender_reputation e corrija a origem da lista; trial_recipient_restricted → limites do teste; quota_exhausted → uso em get_account.
4. get_domain verifica se DKIM, SPF e DMARC ainda estão publicados; deliverability_stats mostra se o problema é uma única mensagem ou uma tendência.
5. Relate o que as evidências mostram. Um evento delivery significa que o servidor do destinatário aceitou a mensagem, não que ela chegou à caixa de entrada nem que foi lida.

7. Tenha uma categoria de tarefas (marcadores)

1. create_label com name (por exemplo, Agent/Orders) e skip_inbox: true. Isso transforma o marcador em uma categoria: os e-mails recebidos que a recebem são arquivados e aparecem apenas no marcador, nunca na Caixa de entrada da pessoa.
2. Envie e-mails de tarefas com send_email (ou send_batch) e labels: ["Agent/Orders"]. As respostas a essa conversa herdam o marcador automaticamente e não vão para a Caixa de entrada.
3. Para e-mails que começam fora das suas conversas, adicione uma regra de arquivamento: create_label_rule com inbox_id (um endereço dedicado, como orders@…), from, to ou subject. Passe apply_to_existing: true para arquivar e-mails já recebidos.
4. Trabalhe a categoria: list_emails com label: "Agent/Orders", direction: "in" e unread: true; leia com get_email ou get_thread, responda com send_email e reply_to_email_id e use mark_email com read: true quando concluir.
5. Mova uma mensagem avulsa para dentro ou para fora com label_email (add / remove). Adicionar o marcador de uma categoria a uma mensagem recebida também a arquiva.
6. Opcionalmente, set_inbox_forwarding envia uma cópia de tudo o que um endereço de recebimento recebe para outra caixa postal (o destino confirma antes por e-mail).

{
  "name": "send_email",
  "arguments": {
    "from": "Orders <orders@example.com>",
    "to": [
      "customer@example.net"
    ],
    "subject": "Order 1042: confirm delivery window",
    "text": "Reply with a time that works.",
    "labels": [
      "Agent/Orders"
    ],
    "idempotency_key": "order-1042-window"
  }
}

8. Anexos e templates

Anexe até 10 arquivos com attachments de send_email (cada um precisa de content_base64 ou de um file_path local; filename assume por padrão o nome-base do arquivo) em um plano pago. Para templates hospedados: create_template → update_template_draft → render_template para pré-visualizar com dados de exemplo → send_template_test (envia um teste real) → publish_template e, depois, envie com send_email ou send_batch usando template: {key, data} e exatamente um destinatário em to.

Resultados, paginação e erros

Uma chamada bem-sucedida retorna o objeto JSON da API como structuredContent e como bloco de texto JSON. Toda ferramenta list_* aceita limit (1–200, padrão 50) e offset, e adiciona um objeto pagination. Continue chamando com offset: pagination.next_offset enquanto has_more for true.

{
  "data": [
    "…"
  ],
  "count": 50,
  "pagination": {
    "offset": 0,
    "limit": 50,
    "returned": 50,
    "total": 180,
    "has_more": true,
    "next_offset": 50
  }
}

Uma chamada com falha retorna isError: true com um erro estruturado. Siga o remedy em vez de tentar novamente às cegas; só tente de novo quando retryable for true.

{
  "error": {
    "code": "trial_recipient_restricted",
    "status": 402,
    "message": "The integration trial can deliver only to your account email or an AWS SES simulator address",
    "retryable": false,
    "explanation": "This workspace is on the unpaid integration trial. Trial sends can be delivered only to the account owner's email address or an AWS SES simulator address.",
    "remedy": "Send to the account email (get_account -> user.email) or a simulator address such as success@simulator.amazonses.com to test. To email anyone else, the account owner must activate a paid plan in the dashboard (Profile & Billing). Do not retry the same recipients."
  }
}

Campos de erro opcionais: request_id (informe-o ao suporte), retry_after_seconds, problems (lista de violações de schema para invalid_arguments) e idempotent_replayed (veja Idempotência).

Idempotência

send_email e send_batch aceitam idempotency_key (máx. 200 caracteres), enviado como o cabeçalho Idempotency-Key. Gere uma chave estável por mensagem lógica, por exemplo invoice-4812-receipt.

• Uma nova tentativa deve reutilizar a mesma chave E um corpo de requisição idêntico. A mesma chave com qualquer alteração (destinatário, assunto, corpo, cabeçalho, dados do template, até valores de argumentos) retorna 409 idempotency_conflict.
• Mesma chave, mesmo corpo, original já concluído: o SendHQ retorna o resultado armazenado sem enviar de novo. É assim que você tenta novamente com segurança após um timeout ou network_error.
• Mesma chave enquanto o original ainda está em execução: 409 idempotency_in_progress, com nova tentativa possível após uma curta espera.
• Uma nova mensagem lógica exige uma nova chave.
• Falhas armazenadas também são reproduzidas. Se a primeira tentativa falhou, tentar de novo com a mesma chave retorna essa mesma falha com idempotent_replayed: true e retryable: false. Verifique list_emails (direction: out) para confirmar que nada saiu, corrija a causa e envie com uma nova chave.
• O servidor nunca repete um POST por conta própria. Apenas chamadas GET somente leitura são repetidas automaticamente (até 3 tentativas em erros de rede, 429 e 5xx).
• send_email com attachments inline não pode receber um idempotency_key, porque executa várias requisições. Para envios de anexos seguros para novas tentativas: create_draft → upload_attachment → send_email com draft_id e idempotency_key.

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <billing@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Receipt #4812",
    "text": "Thanks for your payment.",
    "idempotency_key": "receipt-4812"
  }
}

Limites de taxa e cotas

O SendHQ não publica um limite fixo de requisições por segundo para a API. Os limites que um agente realmente encontra são limites de uso, retornados como 429:

• Entregas mensais a destinatários por plano. Cada endereço em To, Cc e Bcc conta como uma entrega. Veja get_account → usage.recipientDeliveries vs. usage.emailQuotaMonth.
• Destinatários diários por endereço De exato, definidos pelo estado de reputação desse remetente (list_sender_reputation → dailyLimit, 2.000 por padrão nos planos pagos).
• Teste de integração: 100 destinatários no total, apenas para o e-mail da conta ou endereços do simulador do SES.
• Anexos: no máximo 10 arquivos e 10 MB por mensagem; 10 GB de transferência de anexos ponderada por destinatário por mês nos planos pagos.
• Por requisição: To + Cc + Bcc até 100 endereços; send_batch até 100 mensagens.
• Disjuntor de reputação: em uma janela móvel de 7 dias, bounces ou reclamações acima do limite reduzem o ritmo ou pausam um endereço De (423 sender_paused). Ele se recupera automaticamente quando as taxas caem.

quota_exhausted não permite nova tentativa até que o período seja reiniciado ou o plano mude. rate_limited permite nova tentativa após retry_after_seconds; em envios, tente de novo com o mesmo idempotency_key e o corpo idêntico.

Catálogo de erros

code é estável; ramifique por ele e não por message.

Referência das ferramentas

Todas as ferramentas com sua classe de segurança, o endpoint REST que chamam, os parâmetros, o formato de retorno e um exemplo de objeto de params de tools/call. Os parâmetros são exatos: o servidor rejeita qualquer coisa que não esteja listada.

E-mails e threads: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Marcadores e regras de arquivamento automático: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Rascunhos, anexos e identidades de remetente: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Templates hospedados: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Domínios e DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
E-mail de entrada: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Entregabilidade, bounces e supressões: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Conta, uso, análises e chaves: get_account, get_analytics, list_api_keys, get_service_health

Nenhuma ferramenta corresponde a este filtro.

E-mails e threads

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Your export is ready",
    "text": "Download it from your dashboard.",
    "idempotency_key": "export-ready-42"
  }
}

{
  "name": "send_batch",
  "arguments": {
    "emails": [
      {
        "from": "Acme <hello@example.com>",
        "to": [
          "owner@example.com"
        ],
        "template": {
          "key": "account-welcome",
          "data": {
            "first_name": "Asha"
          }
        }
      }
    ],
    "idempotency_key": "welcome-batch-2026-09-26"
  }
}

{
  "name": "list_emails",
  "arguments": {
    "direction": "in",
    "unread": true,
    "limit": 25
  }
}

{
  "name": "get_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "mark_email",
  "arguments": {
    "email_id": "em_123",
    "read": true
  }
}

{
  "name": "delete_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "list_email_events",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "get_thread",
  "arguments": {
    "thread_id": "em_123"
  }
}

Marcadores e regras de arquivamento automático

{
  "name": "list_labels",
  "arguments": {}
}

{
  "name": "get_label",
  "arguments": {
    "label_id": "Billing"
  }
}

{
  "name": "create_label",
  "arguments": {
    "name": "Agent/Orders",
    "skip_inbox": true,
    "rules": [
      {
        "from": "@stripe.com"
      }
    ]
  }
}

{
  "name": "update_label",
  "arguments": {
    "label_id": "lbl_123",
    "name": "Finance/Billing"
  }
}

{
  "name": "delete_label",
  "arguments": {
    "label_id": "lbl_123"
  }
}

{
  "name": "create_label_rule",
  "arguments": {
    "label_id": "Billing",
    "inbox_id": "inb_123",
    "skip_inbox": true
  }
}

{
  "name": "delete_label_rule",
  "arguments": {
    "label_id": "lbl_123",
    "rule_id": "lrule_123"
  }
}

{
  "name": "label_email",
  "arguments": {
    "email_id": "em_123",
    "add": [
      "Billing"
    ],
    "remove": [
      "Support"
    ]
  }
}

Rascunhos, anexos e identidades de remetente

{
  "name": "list_sending_identities",
  "arguments": {}
}

{
  "name": "create_draft",
  "arguments": {
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice"
  }
}

{
  "name": "list_drafts",
  "arguments": {}
}

{
  "name": "get_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "update_draft",
  "arguments": {
    "draft_id": "dr_123",
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice (updated)",
    "text": "Attached."
  }
}

{
  "name": "delete_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "upload_attachment",
  "arguments": {
    "draft_id": "dr_123",
    "filename": "invoice.pdf",
    "content_type": "application/pdf",
    "file_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "download_attachment",
  "arguments": {
    "attachment_id": "att_123",
    "save_to_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "delete_attachment",
  "arguments": {
    "attachment_id": "att_123"
  }
}

Templates hospedados

{
  "name": "list_templates",
  "arguments": {
    "lifecycle": "active"
  }
}

{
  "name": "create_template",
  "arguments": {
    "name": "Account welcome",
    "key": "account-welcome",
    "starter": "welcome"
  }
}

{
  "name": "get_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "update_template_draft",
  "arguments": {
    "template_id": "account-welcome",
    "revision": 3,
    "name": "Account welcome",
    "subject_template": "Welcome, {{first_name}}",
    "text_template": "Hi {{first_name}}",
    "variables": [
      {
        "key": "first_name",
        "type": "text",
        "required": true
      }
    ],
    "sample_data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "create_template_draft",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "render_template",
  "arguments": {
    "template_id": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "send_template_test",
  "arguments": {
    "template_id": "account-welcome",
    "to": [
      "owner@example.com"
    ]
  }
}

{
  "name": "publish_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "archive_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "restore_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

Domínios e DNS

{
  "name": "list_domains",
  "arguments": {}
}

{
  "name": "get_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "add_domain",
  "arguments": {
    "name": "example.com"
  }
}

{
  "name": "verify_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "delete_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_dns_provider",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_domain_connect_link",
  "arguments": {
    "domain_id": "dom_123"
  }
}

E-mail de entrada

{
  "name": "setup_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "verify_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "list_inboxes",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

{
  "name": "create_inbox",
  "arguments": {
    "domain_id": "dom_123",
    "local_part": "support",
    "name": "Support"
  }
}

{
  "name": "update_inbox",
  "arguments": {
    "inbox_id": "inb_123",
    "status": "disabled"
  }
}

{
  "name": "set_inbox_forwarding",
  "arguments": {
    "inbox_id": "inb_123",
    "forward_to": "team@example.net"
  }
}

{
  "name": "delete_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

Entregabilidade, bounces e supressões

{
  "name": "deliverability_stats",
  "arguments": {}
}

{
  "name": "list_sender_reputation",
  "arguments": {}
}

{
  "name": "list_suppressions",
  "arguments": {}
}

{
  "name": "remove_suppression",
  "arguments": {
    "email": "fixed-mailbox@example.net"
  }
}

{
  "name": "list_blocked_recipients",
  "arguments": {}
}

Conta, uso, análises e chaves

{
  "name": "get_account",
  "arguments": {}
}

{
  "name": "get_analytics",
  "arguments": {
    "days": 30
  }
}

{
  "name": "list_api_keys",
  "arguments": {}
}

{
  "name": "get_service_health",
  "arguments": {}
}

Inventário de cobertura da API

Todas as operações da API pública e a ferramenta que as cobre. Tudo o que uma pessoa pode fazer no painel e que tem uma API está coberto; as exclusões abaixo são deliberadas.

Deliberadamente indisponível

Catálogo legível por máquina: /docs/mcp/tools.json (schemas, anotações, mapeamento de endpoints, exclusões). Versão em Markdown desta página: /docs/mcp.md. Com a CLI instalada, sendhq commands --format json imprime o mesmo catálogo.