Serveur MCP SendHQ

Présentation du serveur

Le serveur MCP SendHQ permet à un agent IA d’exploiter un espace de travail SendHQ via le Model Context Protocol : envoyer des e-mails (unitaires, par lot, à partir de modèles, réponses, pièces jointes, nouvelles tentatives idempotentes), lire et rechercher le courrier envoyé et reçu (objets, corps et noms de pièces jointes) ainsi que ses événements de livraison, classer le courrier sous des libellés avec des règles de classement automatique, gérer les brouillons et les pièces jointes privées, rédiger et publier des modèles hébergés, ajouter et vérifier des domaines et leur DNS, configurer la réception et les adresses entrantes, examiner la délivrabilité, les bounces, les plaintes et les suppressions, et consulter l’utilisation du compte, l’état de la facturation, les statistiques et les métadonnées des clés API.

C’est un serveur stdio local intégré au binaire CLI sendhq. Votre client MCP lance sendhq mcp comme processus enfant et communique en JSON-RPC via stdin/stdout. Chaque appel d’outil devient une requête documentée vers l’API REST de SendHQ à l’adresse https://sendhq.cc/api/v1, authentifiée avec la clé API de votre espace de travail : le serveur MCP a donc exactement les permissions de cette clé, et rien de plus.

• 59 outils répartis en 8 groupes, générés à partir d’un catalogue unique également publié sous le nom tools.json.
• Des JSON Schemas stricts : les arguments inconnus, les types incorrects et les champs obligatoires manquants sont rejetés localement avant que quoi que ce soit n’atteigne SendHQ.
• Des erreurs structurées avec un code stable, le status HTTP, une explanation, un remedy concret et l’indication qu’une nouvelle tentative peut ou non aider.
• Chaque outil qui envoie de vrais e-mails ou détruit des données l’indique dès les premiers mots de sa description et porte des annotations de sécurité MCP.
• Le mode --read-only masque tous les outils d’envoi et de modification.
• Rien n’est journalisé. stdout ne transporte que des messages de protocole ; la clé API et le contenu des messages n’apparaissent jamais dans un log.

Utiliser SendHQ dans Claude et ChatGPT

Aucune installation requise : SendHQ exécute aussi ce serveur sous forme de connecteur hébergé à l’adresse https://mcp.sendhq.cc/mcp, avec les mêmes outils. Vous vous connectez avec votre compte SendHQ au lieu de coller une clé.

Claude

1. Ouvrez Settings → Connectors et trouvez SendHQ dans l’annuaire, ou choisissez Add custom connector et collez https://mcp.sendhq.cc/mcp.
2. Cliquez sur Connect, connectez-vous à SendHQ, vérifiez les accès demandés et cliquez sur Allow.
3. Demandez à Claude de consulter votre boîte de réception, d’envoyer un e-mail depuis votre domaine vérifié ou d’expliquer un 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.

Approbation et déconnexion

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• Les outils qui envoient de vrais e-mails ou suppriment des données sont signalés comme tels. C’est dans l’assistant que vous choisissez, outil par outil, s’il doit d’abord vous demander votre accord : dans Claude, choisissez Needs approval pour ces outils sous Settings → Connectors → SendHQ.
• Le connecteur reçoit sa propre clé API, nommée d’après l’assistant (par exemple « Claude (AI connector) »). Supprimez-la sous API Keys pour le déconnecter immédiatement.
• Il ne peut ni créer ni révoquer de clés API, ni modifier la facturation. Les pièces jointes sont envoyées et renvoyées en base64 ; il n’y a aucun accès aux fichiers locaux.
• Les espaces de travail non payants (essai d’intégration) ne peuvent délivrer qu’à l’adresse e-mail du compte ou à une adresse du simulateur AWS SES.

Questions : postmaster@sendhq.cc. Confidentialité : sendhq.cc/privacy.

Installation

Installez le binaire sendhq (Linux, macOS et Windows, sur x86-64 et arm64). L’installateur vérifie la somme de contrôle de la version et place le binaire dans ~/.local/bin par défaut.

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

Créez une clé API dans le tableau de bord, à l’adresse https://sendhq.cc/app#/keys. Le serveur MCP ne peut pas créer de clés. La seule commande qui lance le serveur est :

SENDHQ_API_KEY=re_your_key sendhq mcp

En temps normal, vous ne la lancez jamais à la main : c’est le client MCP qui s’en charge. Lancée dans un terminal, elle attend du JSON-RPC sur stdin.

Configurer votre client

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

Ajoutez --scope user pour le rendre disponible dans tous les projets, ou --scope project pour l’écrire dans le fichier .mcp.json du projet. Pour un .mcp.json partagé, référencez la clé depuis l’environnement au lieu de la committer ; Claude Code développe ${VAR} dans .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 en ligne de commande : codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Modifiez claude_desktop_config.json (macOS : ~/Library/Application Support/Claude/, Windows : %APPDATA%\Claude\) et redémarrez l’application. Les applications de bureau n’héritent pas du PATH de votre shell : utilisez donc le chemin absolu du binaire (which sendhq).

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

Tout autre client MCP

Configurez un serveur stdio avec la commande sendhq, les arguments ["mcp"] (et éventuellement "--read-only") et les variables d’environnement ci-dessous. Le serveur prend en charge les versions 2024-11-05, 2025-03-26, 2025-06-18 et 2025-11-25 du protocole MCP, et implémente initialize, ping, tools/list et tools/call. Les résultats d’outils contiennent à la fois un bloc de texte JSON et un 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":{}}}

Il n’existe pas de transport HTTP hébergé pour le serveur rattaché au compte. Un endpoint MCP distant capable d’écrire nécessiterait un OAuth par utilisateur, que SendHQ ne propose pas ; le binaire local garde la clé sur la machine qui la détient déjà.

Environnement et options

La clé n’est envoyée que dans l’en-tête Authorization: Bearer, vers l’URL de base configurée. Elle n’est jamais affichée, journalisée, reprise dans les erreurs ni incluse dans les résultats d’outils.

Modèle de sécurité pour les agents

• Envoie de vrais e-mails. send_email, send_batch et send_template_test délivrent du courrier à de vraies personnes et consomment des crédits de livraison. Leur description commence par SENDS REAL EMAIL. Ne les appelez que lorsque l’utilisateur a explicitement demandé l’envoi de ce message précis, avec destinataires, expéditeur et contenu confirmés.
• Destructif. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox et remove_suppression sont marqués destructiveHint: true et leur description commence par DESTRUCTIVE. Demandez d’abord confirmation à l’utilisateur. remove_suppression affaiblit un blocage de sécurité et ne convient que lorsqu’un humain confirme que l’adresse fonctionne de nouveau.
• Modifie l’état. Créer ou mettre à jour des brouillons, des modèles, des domaines et des boîtes de réception, publier des modèles et lancer une vérification modifient l’espace de travail, mais n’envoient pas d’e-mail.
• Lecture seule. Tout le reste est readOnlyHint: true et peut être appelé librement.
• Ce serveur ne modifie jamais le DNS. add_domain renvoie des enregistrements qu’un humain doit publier ; get_domain_connect_link renvoie une URL de consentement qu’une personne doit ouvrir et approuver chez son fournisseur DNS.
• Ce serveur ne modifie jamais la facturation. get_account se contente de lire la formule, l’utilisation et l’état de l’abonnement.
• Les espaces de travail non payants (essai d’intégration) ne peuvent délivrer qu’à l’adresse e-mail du propriétaire du compte (get_account → user.email) ou à une adresse du simulateur AWS SES comme success@simulator.amazonses.com, et ne peuvent pas envoyer de pièces jointes.
• Accepté ne veut pas dire délivré. Un envoi réussi renvoie un identifiant ; les preuves de livraison, de bounce et de plainte arrivent ensuite dans list_email_events. N’affirmez jamais qu’un message est arrivé en boîte de réception ni qu’une personne l’a lu.
• Ne changez pas d’adresse From pour contourner une pause 423, et ne réintégrez jamais des destinataires désinscrits ou ayant porté plainte.

Les clés API sont hors périmètre

Par conception, il n’existe aucun outil pour créer, modifier, faire tourner, révoquer ou supprimer des clés API. Un agent ne doit ni émettre ni détruire d’identifiants. list_api_keys renvoie uniquement les noms, les préfixes non secrets et les dates de dernière utilisation. La gestion des clés reste dans le tableau de bord, entre les mains d’un humain connecté.

Workflows

1. Premier envoi

1. get_service_health confirme que l’API est joignable (fonctionne sans clé).
2. get_account indique la formule (access.tier), le quota restant et user.email. Pendant l’essai, cette adresse est le seul vrai destinataire autorisé.
3. list_sending_identities liste les adresses From que vous pouvez utiliser. Si la liste est vide, suivez d’abord le workflow de domaine.
4. Confirmez l’expéditeur, le destinataire, l’objet et le corps avec l’utilisateur, puis appelez send_email avec une idempotency_key.
5. list_email_events avec l’id renvoyé affiche delivery, bounce, complaint ou reject dès que le fournisseur le signale (généralement en quelques secondes à quelques minutes).

{
  "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. Vérification de domaine de bout en bout

1. add_domain avec name: "example.com". Le résultat contient les enregistrements DNS (CNAME DKIM, vérification SES, SPF, DMARC recommandé).
2. get_dns_provider avec le domain_id détecte le fournisseur DNS faisant autorité et renvoie l’hôte relatif exact à saisir pour chaque enregistrement chez ce fournisseur.
3. Si providers.domainConnect.available vaut true, get_domain_connect_link renvoie une URL de consentement. Transmettez-la à l’humain ; rien ne change tant qu’il n’a pas approuvé chez le fournisseur. Sinon, donnez à l’humain les enregistrements à publier. Ne publiez jamais un second enregistrement SPF : fusionnez include:amazonses.com dans la valeur v=spf1 existante.
4. verify_domain revérifie le DNS et SES. Le statut passe par pending, checking et propagating jusqu’à verified. Interrogez verify_domain ou get_domain toutes les 30 à 60 secondes ; le DNS peut mettre de quelques minutes à quelques heures.
5. Lorsque status vaut verified, les adresses du domaine apparaissent dans list_sending_identities.

3. Bounces, plaintes et suppressions

1. list_blocked_recipients renvoie chaque adresse bloquée avec son motif (bounce, complaint, unsubscribe) ainsi qu’un décompte récapitulatif.
2. list_suppressions renvoie les suppressions pour hard bounce et pour plainte ; deliverability_stats fournit les taux de livraison, de bounces et de plaintes sur 30 jours ; list_sender_reputation indique quelles adresses From sont bridées ou en pause.
3. Un envoi contenant un destinataire en liste de suppression échoue avec 422 recipient_suppressed. Retirez ce destinataire et renvoyez.
4. N’appelez remove_suppression que lorsqu’un humain confirme qu’une boîte aux lettres en bounce fonctionne désormais. Les suppressions pour plainte sont permanentes (409 complaint_suppression_locked).

4. Recevoir des e-mails entrants

1. Le domaine (souvent un sous-domaine comme inbound.example.com) doit être vérifié.
2. setup_inbound configure la réception et renvoie un enregistrement MX. Un humain le publie.
3. verify_inbound jusqu’à ce que status vaille ready.
4. create_inbox avec domain_id et local_part (par exemple support) crée support@inbound.example.com.
5. Interrogez list_emails avec direction: "in" et unread: true (et éventuellement inbox_id). Lisez un message avec get_email, sa conversation avec get_thread, ses pièces jointes avec download_attachment, et marquez-le comme traité avec mark_email (read: true).
6. Répondez dans le fil avec send_email et reply_to_email_id ; SendHQ définit In-Reply-To, References et le fil de discussion.

5. Webhooks et notifications d’événements

SendHQ ne propose pas actuellement de webhooks configurables par les clients ; il n’existe donc pas d’outil webhook. Les notifications des fournisseurs sont traitées dans SendHQ et exposées via des lectures. Interrogez plutôt : list_email_events pour le résultat d’un message, list_emails avec status (par exemple bounced) ou after pour les changements récents, list_emails avec direction: "in" et unread: true pour le nouveau courrier entrant, et list_blocked_recipients pour les nouvelles suppressions. N’interrogez pas plus d’une fois par minute environ pour une même question.

6. Diagnostiquer un échec de livraison

1. Trouvez le message : list_emails avec direction: "out" et to ou query, ou get_email si vous avez l’identifiant. status: failed signifie que SendHQ ou le fournisseur l’a rejeté lors de la soumission ; l’erreur de l’e-mail en explique la raison.
2. list_email_events : bounce (permanent ou transitoire, avec le diagnostic du fournisseur), complaint, reject ou delivery. L’absence d’événements signifie que le fournisseur n’a encore rien signalé ; attendez et vérifiez à nouveau.
3. Si l’appel d’envoi lui-même a échoué, lisez le code d’erreur : sender_domain_unverified → terminez la vérification du domaine ; recipient_suppressed → l’adresse a déjà généré un hard bounce ou une plainte ; sender_paused → examinez list_sender_reputation et corrigez la source de la liste ; trial_recipient_restricted → limites de l’essai ; quota_exhausted → utilisation dans get_account.
4. get_domain vérifie que DKIM, SPF et DMARC sont toujours publiés ; deliverability_stats montre si le problème concerne un seul message ou une tendance.
5. Rapportez ce que montrent les preuves. Un événement delivery signifie que le serveur du destinataire a accepté le message, pas qu’il est arrivé en boîte de réception ni qu’il a été lu.

7. Gérer sa propre catégorie de tâches (libellés)

1. create_label avec name (par exemple Agent/Orders) et skip_inbox: true. Le libellé devient alors une catégorie : le courrier reçu qui l’obtient est archivé, de sorte qu’il n’apparaît que dans le libellé, jamais dans la Boîte de réception de l’humain.
2. Envoyez le courrier lié à la tâche avec send_email (ou send_batch) et labels: ["Agent/Orders"]. Les réponses à cette conversation héritent automatiquement du libellé et évitent la Boîte de réception.
3. Pour le courrier qui commence en dehors de vos conversations, ajoutez une règle de classement : create_label_rule avec inbox_id (une adresse dédiée comme orders@…), from, to ou subject. Passez apply_to_existing: true pour classer le courrier déjà reçu.
4. Traitez la catégorie : list_emails avec label: "Agent/Orders", direction: "in" et unread: true ; lisez avec get_email ou get_thread, répondez avec send_email et reply_to_email_id, puis appelez mark_email read: true une fois le message traité.
5. Déplacez un message égaré vers la catégorie ou hors de celle-ci avec label_email (add / remove). Ajouter un libellé de catégorie à un message reçu l’archive également.
6. En option, set_inbox_forwarding envoie une copie de tout ce que reçoit une adresse de réception vers une autre boîte aux lettres (la cible confirme d’abord par 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. Pièces jointes et modèles

Joignez jusqu’à 10 fichiers avec le paramètre attachments de send_email (chacun nécessite content_base64 ou un file_path local ; filename vaut par défaut le nom de base du fichier) sur une formule payante. Pour les modèles hébergés : create_template → update_template_draft → render_template pour prévisualiser avec des données d’exemple → send_template_test (envoie un vrai test) → publish_template, puis envoyez avec send_email ou send_batch en utilisant template: {key, data} et exactement un destinataire to.

Résultats, pagination et erreurs

Un appel réussi renvoie l’objet JSON de l’API sous forme de structuredContent et de bloc de texte JSON. Chaque outil list_* accepte limit (1–200, 50 par défaut) et offset, et ajoute un objet pagination. Continuez à appeler avec offset: pagination.next_offset tant que has_more vaut true.

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

Un appel en échec renvoie isError: true avec une erreur structurée. Suivez le remedy au lieu de réessayer à l’aveugle ; ne réessayez que si retryable vaut 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."
  }
}

Champs d’erreur facultatifs : request_id (à citer au support), retry_after_seconds, problems (liste des violations de schéma pour invalid_arguments) et idempotent_replayed (voir Idempotence).

Idempotence

send_email et send_batch acceptent idempotency_key (200 caractères max.), envoyée dans l’en-tête Idempotency-Key. Générez une clé stable par message logique, par exemple invoice-4812-receipt.

• Une nouvelle tentative doit réutiliser la même clé ET un corps de requête identique. La même clé avec la moindre modification (destinataire, objet, corps, en-tête, données de modèle, voire valeurs d’arguments) renvoie 409 idempotency_conflict.
• Même clé, même corps, requête d’origine terminée : SendHQ renvoie le résultat enregistré sans renvoyer l’e-mail. C’est ainsi que l’on réessaie sans risque après un timeout ou une network_error.
• Même clé alors que la requête d’origine est encore en cours : 409 idempotency_in_progress, à réessayer après une courte attente.
• Un nouveau message logique nécessite une nouvelle clé.
• Les échecs enregistrés sont eux aussi rejoués. Si la première tentative a échoué, réessayer avec la même clé renvoie ce même échec avec idempotent_replayed: true et retryable: false. Vérifiez avec list_emails (direction: out) que rien n’est parti, corrigez la cause, puis envoyez avec une nouvelle clé.
• Le serveur ne réessaie jamais un POST de lui-même. Seuls les appels GET en lecture seule sont réessayés automatiquement (jusqu’à 3 tentatives en cas d’erreur réseau, de 429 et de 5xx).
• send_email avec des attachments en ligne ne peut pas prendre d’idempotency_key, car il exécute plusieurs requêtes. Pour des envois de pièces jointes sûrs en cas de nouvelle tentative : create_draft → upload_attachment → send_email avec draft_id et 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 débit et quotas

SendHQ ne publie pas de limite fixe de requêtes par seconde pour l’API. Les limites qu’un agent rencontre réellement sont des limites d’utilisation, renvoyées sous forme de 429 :

• Livraisons mensuelles par destinataire selon la formule. Chaque adresse To, Cc et Bcc compte pour une livraison. Voir get_account → usage.recipientDeliveries par rapport à usage.emailQuotaMonth.
• Destinataires quotidiens par adresse From exacte, selon l’état de réputation de cet expéditeur (list_sender_reputation → dailyLimit, 2 000 par défaut sur les formules payantes).
• Essai d’intégration : 100 destinataires au total, uniquement vers l’adresse e-mail du compte ou des adresses du simulateur SES.
• Pièces jointes : au maximum 10 fichiers et 10 MB par message ; 10 GB de transfert de pièces jointes pondéré par destinataire par mois sur les formules payantes.
• Par requête : To + Cc + Bcc jusqu’à 100 adresses ; send_batch jusqu’à 100 messages.
• Disjoncteur de réputation : sur une fenêtre glissante de 7 jours, des bounces ou des plaintes au-delà du seuil brident ou mettent en pause une adresse From (423 sender_paused). Elle se rétablit automatiquement une fois les taux redescendus.

quota_exhausted ne peut pas être réessayé avant la réinitialisation de la période ou un changement de formule. rate_limited peut être réessayé après retry_after_seconds ; pour les envois, réessayez avec la même idempotency_key et un corps identique.

Catalogue des erreurs

Le code est stable ; basez vos branchements sur lui plutôt que sur message.

Référence des outils

Chaque outil avec sa classe de sécurité, l’endpoint REST qu’il appelle, ses paramètres, son format de retour et un exemple d’objet params pour tools/call. Les paramètres sont exacts : le serveur rejette tout ce qui n’est pas listé.

E-mails et fils de discussion : send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Libellés et règles de classement automatique : list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Brouillons, pièces jointes et identités d’expéditeur : list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Modèles hébergés : list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Domaines et DNS : list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
E-mails entrants : setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Délivrabilité, bounces et suppressions : deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Compte, utilisation, statistiques et clés : get_account, get_analytics, list_api_keys, get_service_health

Aucun outil ne correspond à ce filtre.

E-mails et fils de discussion

{
  "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"
  }
}

Libellés et règles de classement automatique

{
  "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"
    ]
  }
}

Brouillons, pièces jointes et identités d’expéditeur

{
  "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"
  }
}

Modèles hébergés

{
  "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"
  }
}

Domaines et 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-mails entrants

{
  "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"
  }
}

Délivrabilité, bounces et suppressions

{
  "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": {}
}

Compte, utilisation, statistiques et clés

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

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

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

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

Inventaire de couverture de l’API

Chaque opération de l’API publique et l’outil qui la couvre. Tout ce qu’un utilisateur peut faire dans le tableau de bord et qui dispose d’une API est couvert ; les exclusions ci-dessous sont délibérées.

Délibérément non disponible

Catalogue lisible par machine : /docs/mcp/tools.json (schémas, annotations, correspondance des endpoints, exclusions). Version Markdown de cette page : /docs/mcp.md. Si la CLI est installée, sendhq commands --format json affiche le même catalogue.