SendHQ MCP-Server

Was dieser Server ist

Der SendHQ MCP-Server lässt einen KI-Agenten über das Model Context Protocol einen SendHQ-Workspace bedienen: E-Mails senden (einzeln, als Batch, per Template, Antworten, Anhänge, idempotente Wiederholungsversuche), gesendete und empfangene E-Mails (Betreff, Text und Anhangsnamen) samt Zustell-Events lesen und durchsuchen, E-Mails mit Labels und automatischen Ablageregeln organisieren, Entwürfe und private Anhänge verwalten, gehostete Templates erstellen und veröffentlichen, Domains samt DNS hinzufügen und verifizieren, Inbound-Empfang und Inbound-Adressen einrichten, Zustellbarkeit, Bounces, Beschwerden und Sperrliste prüfen sowie Kontonutzung, Abrechnungsstatus, Analytics und Metadaten zu API-Schlüsseln lesen.

Es ist ein lokaler stdio-Server, der in die sendhq-CLI-Binärdatei eingebaut ist. Ihr MCP-Client startet sendhq mcp als Kindprozess und spricht JSON-RPC über stdin/stdout. Jeder Tool-Aufruf wird zu genau einer dokumentierten Anfrage an die SendHQ REST API unter https://sendhq.cc/api/v1, authentifiziert mit dem API-Schlüssel Ihres Workspace. Der MCP-Server hat also genau die Berechtigungen dieses Schlüssels und keine weiteren.

• 59 Tools in 8 Gruppen, erzeugt aus einem einzigen Katalog, der auch als tools.json veröffentlicht wird.
• Strikte JSON Schemas: Unbekannte Argumente, falsche Typen und fehlende Pflichtfelder werden lokal abgelehnt, bevor etwas SendHQ erreicht.
• Strukturierte Fehler mit stabilem code, dem HTTP-status, einer explanation, einem konkreten remedy und der Angabe, ob ein erneuter Versuch helfen kann.
• Jedes Tool, das echte E-Mails sendet oder Daten löscht, sagt das gleich in den ersten Worten seiner Beschreibung und trägt MCP-Sicherheitsannotationen.
• Der --read-only-Modus blendet alle sendenden und ändernden Tools aus.
• Es wird nichts protokolliert. stdout enthält nur Protokollnachrichten; der API-Schlüssel und der Nachrichteninhalt gelangen nie in ein Log.

SendHQ in Claude und ChatGPT nutzen

Keine Installation nötig: SendHQ betreibt diesen Server auch als gehosteten Connector unter https://mcp.sendhq.cc/mcp mit denselben Tools. Sie melden sich mit Ihrem SendHQ-Konto an, statt einen Schlüssel einzufügen.

Claude

1. Öffnen Sie Settings → Connectors und suchen Sie SendHQ im Verzeichnis, oder wählen Sie Add custom connector und fügen Sie https://mcp.sendhq.cc/mcp ein.
2. Klicken Sie auf Connect, melden Sie sich bei SendHQ an, prüfen Sie den Zugriff und klicken Sie auf Allow.
3. Bitten Sie Claude, Ihren Posteingang zu prüfen, eine E-Mail von Ihrer verifizierten Domain zu senden oder einen Bounce zu erklären.

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.

Freigabe und Trennen

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• Tools, die echte E-Mails senden oder Daten löschen, sind entsprechend gekennzeichnet. Ob der Assistent vorher nachfragt, legen Sie pro Tool im Assistenten fest: In Claude wählen Sie für diese Tools unter Settings → Connectors → SendHQ die Option Needs approval.
• Der Connector erhält einen eigenen API-Schlüssel, der nach dem Assistenten benannt ist (zum Beispiel „Claude (AI connector)“). Löschen Sie ihn unter API Keys, um die Verbindung sofort zu trennen.
• Er kann weder API-Schlüssel erstellen oder widerrufen noch die Abrechnung ändern. Anhänge werden als Base64 gesendet und zurückgegeben; es gibt keinen lokalen Dateizugriff.
• Nicht bezahlte Workspaces (Integrationstestphase) können nur an die Konto-E-Mail-Adresse oder eine AWS-SES-Simulatoradresse zustellen.

Fragen: postmaster@sendhq.cc. Datenschutz: sendhq.cc/privacy.

Installation

Installieren Sie die sendhq-Binärdatei (Linux, macOS und Windows auf x86-64 und arm64). Das Installationsprogramm prüft die Prüfsumme des Releases und legt die Binärdatei standardmäßig in ~/.local/bin ab.

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

Erstellen Sie im Dashboard unter https://sendhq.cc/app#/keys einen API-Schlüssel. Der MCP-Server kann keine Schlüssel erstellen. Der eine Befehl, der den Server startet, lautet:

SENDHQ_API_KEY=re_your_key sendhq mcp

Sie führen das normalerweise nie selbst aus: Der MCP-Client startet den Server. Im Terminal ausgeführt, wartet er auf stdin auf JSON-RPC.

Client konfigurieren

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

Fügen Sie --scope user hinzu, damit der Server in jedem Projekt verfügbar ist, oder --scope project, um ihn in die .mcp.json des Projekts zu schreiben. Verweisen Sie in einer gemeinsam genutzten .mcp.json auf den Schlüssel in der Umgebung, statt ihn einzuchecken; Claude Code expandiert ${VAR} in .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" }

Oder über die Kommandozeile: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Bearbeiten Sie claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) und starten Sie die App neu. Desktop-Apps erben nicht den PATH Ihrer Shell, verwenden Sie daher den absoluten Pfad der Binärdatei (which sendhq).

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

Jeder andere MCP-Client

Konfigurieren Sie einen stdio-Server mit dem Befehl sendhq, den Argumenten ["mcp"] (optional "--read-only") und den unten genannten Umgebungsvariablen. Der Server unterstützt die MCP-Protokollversionen 2024-11-05, 2025-03-26, 2025-06-18 und 2025-11-25 und implementiert initialize, ping, tools/list und tools/call. Tool-Ergebnisse enthalten sowohl einen JSON-Textblock als auch 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":{}}}

Für den kontobezogenen Server gibt es keinen gehosteten HTTP-Transport. Ein entfernter, schreibfähiger MCP-Endpunkt würde OAuth pro Nutzer erfordern, das SendHQ nicht anbietet; die lokale Binärdatei hält den Schlüssel auf dem Rechner, der ihn ohnehin besitzt.

Umgebung und Flags

Der Schlüssel wird nur als Authorization: Bearer-Header an die konfigurierte Basis-URL gesendet. Er wird nie ausgegeben, protokolliert, in Fehlern wiederholt oder in Tool-Ergebnisse aufgenommen.

Sicherheitsmodell für Agenten

• Sendet echte E-Mails. send_email, send_batch und send_template_test stellen E-Mails an echte Personen zu und verbrauchen Zustellkontingent. Ihre Beschreibungen beginnen mit SENDS REAL EMAIL. Rufen Sie sie nur auf, wenn der Nutzer ausdrücklich darum gebeten hat, genau diese Nachricht zu senden, und Empfänger, Absender und Inhalt bestätigt sind.
• Destruktiv. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox und remove_suppression sind mit destructiveHint: true markiert, und ihre Beschreibungen beginnen mit DESTRUCTIVE. Holen Sie vorher die Bestätigung des Nutzers ein. remove_suppression schwächt eine Schutzsperre ab und ist nur angebracht, wenn ein Mensch bestätigt, dass die Adresse wieder funktioniert.
• Ändert den Zustand. Das Erstellen oder Aktualisieren von Entwürfen, Templates, Domains und Postfächern, das Veröffentlichen von Templates und das Starten der Verifizierung verändern den Workspace, senden aber keine E-Mails.
• Nur lesend. Alles andere ist readOnlyHint: true und kann bedenkenlos aufgerufen werden.
• Dieser Server ändert nie das DNS. add_domain gibt Einträge zurück, die ein Mensch veröffentlichen muss; get_domain_connect_link gibt eine Zustimmungs-URL zurück, die eine Person öffnen und bei ihrem DNS-Provider bestätigen muss.
• Dieser Server ändert nie die Abrechnung. get_account liest nur Tarif, Nutzung und Abostatus.
• Nicht bezahlte Workspaces (Integrationstestphase) können nur an die E-Mail-Adresse des Kontoinhabers (get_account → user.email) oder an eine AWS-SES-Simulatoradresse wie success@simulator.amazonses.com zustellen und keine Anhänge senden.
• Angenommen heißt nicht zugestellt. Ein erfolgreicher Versand liefert eine ID; Belege für Zustellung, Bounce und Beschwerde erscheinen später in list_email_events. Behaupten Sie nie eine Platzierung im Posteingang oder dass eine Person die Nachricht gelesen hat.
• Wechseln Sie nicht auf eine andere Absenderadresse, um eine 423-Pause zu umgehen, und fügen Sie abgemeldete oder beschwerdeführende Empfänger nie wieder hinzu.

API-Schlüssel sind ausgeschlossen

Es gibt bewusst keine Tools, die API-Schlüssel erstellen, ändern, rotieren, widerrufen oder löschen. Ein Agent darf keine Zugangsdaten erzeugen oder vernichten. list_api_keys gibt nur Namen, nicht geheime Präfixe und Zeitpunkte der letzten Nutzung zurück. Die Schlüsselverwaltung bleibt im Dashboard bei einem angemeldeten Menschen.

Workflows

1. Erster Versand

1. get_service_health bestätigt, dass die API erreichbar ist (funktioniert ohne Schlüssel).
2. get_account zeigt den Tarif (access.tier), das verbleibende Kontingent und user.email. In der Testphase ist diese E-Mail-Adresse der einzige erlaubte echte Empfänger.
3. list_sending_identities listet die nutzbaren Absenderadressen auf. Ist die Liste leer, führen Sie zuerst den Domain-Workflow aus.
4. Bestätigen Sie Absender, Empfänger, Betreff und Text mit dem Nutzer und rufen Sie dann send_email mit einem idempotency_key auf.
5. list_email_events mit der zurückgegebenen id zeigt delivery, bounce, complaint oder reject, sobald der Provider es meldet (meist nach Sekunden bis Minuten).

{
  "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. Domain-Verifizierung von Anfang bis Ende

1. add_domain mit name: "example.com". Das Ergebnis enthält die DNS-Einträge (DKIM-CNAMEs, SES-Verifizierung, SPF, empfohlenes DMARC).
2. get_dns_provider mit der domain_id erkennt den maßgeblichen DNS-Provider und liefert für jeden Eintrag den exakten relativen Host, der bei diesem Provider einzutragen ist.
3. Wenn providers.domainConnect.available true ist, liefert get_domain_connect_link eine Zustimmungs-URL. Geben Sie sie dem Menschen; es ändert sich nichts, bevor er sie beim Provider bestätigt. Andernfalls geben Sie dem Menschen die zu veröffentlichenden Einträge. Veröffentlichen Sie nie einen zweiten SPF-Eintrag: Führen Sie include:amazonses.com mit dem vorhandenen v=spf1-Wert zusammen.
4. verify_domain prüft DNS und SES erneut. Der Status wechselt von pending über checking und propagating zu verified. Rufen Sie verify_domain oder get_domain alle 30–60 Sekunden ab; DNS kann Minuten bis Stunden brauchen.
5. Sobald status den Wert verified hat, erscheinen die Adressen der Domain in list_sending_identities.

3. Bounces, Beschwerden und Sperrliste

1. list_blocked_recipients gibt jede blockierte Adresse mit Grund (bounce, complaint, unsubscribe) und einer zusammenfassenden Anzahl zurück.
2. list_suppressions gibt Sperrlisteneinträge für Hard Bounces und Beschwerden zurück; deliverability_stats liefert die Zustell-, Bounce- und Beschwerderaten der letzten 30 Tage; list_sender_reputation zeigt, welche Absenderadressen gedrosselt oder pausiert sind.
3. Ein Versand mit einem gesperrten Empfänger schlägt mit 422 recipient_suppressed fehl. Entfernen Sie diesen Empfänger und senden Sie erneut.
4. Rufen Sie remove_suppression nur auf, wenn ein Mensch bestätigt, dass ein zuvor gebouncetes Postfach jetzt funktioniert. Sperren wegen Beschwerden sind dauerhaft (409 complaint_suppression_locked).

4. Eingehende E-Mails empfangen

1. Die Domain (oft eine Subdomain wie inbound.example.com) muss verifiziert sein.
2. setup_inbound richtet den Empfang ein und gibt einen MX-Eintrag zurück. Ein Mensch veröffentlicht ihn.
3. Rufen Sie verify_inbound auf, bis status den Wert ready hat.
4. create_inbox mit domain_id und local_part (zum Beispiel support) erstellt support@inbound.example.com.
5. Fragen Sie list_emails mit direction: "in" und unread: true (optional inbox_id) regelmäßig ab. Lesen Sie eine Nachricht mit get_email, die Unterhaltung mit get_thread, Anhänge mit download_attachment und markieren Sie sie mit mark_email (read: true) als erledigt.
6. Antworten Sie im Thread mit send_email und reply_to_email_id; SendHQ setzt In-Reply-To, References und den Thread.

5. Webhooks und Event-Benachrichtigungen

SendHQ bietet derzeit keine vom Kunden konfigurierbaren Webhooks an, daher gibt es kein Webhook-Tool. Provider-Benachrichtigungen werden intern in SendHQ verarbeitet und über lesende Abfragen bereitgestellt. Fragen Sie stattdessen per Polling ab: list_email_events für das Ergebnis einer Nachricht, list_emails mit status (zum Beispiel bounced) oder after für aktuelle Änderungen, list_emails mit direction: "in" und unread: true für neue eingehende E-Mails und list_blocked_recipients für neue Sperren. Fragen Sie pro Fragestellung höchstens etwa einmal pro Minute ab.

6. Einen Zustellfehler diagnostizieren

1. Finden Sie die Nachricht: list_emails mit direction: "out" und to oder query, oder get_email, wenn Sie die ID haben. status: failed bedeutet, dass SendHQ oder der Provider die Nachricht bei der Einlieferung abgelehnt hat; der Fehler der E-Mail nennt den Grund.
2. list_email_events: bounce (permanent oder vorübergehend, mit der Diagnose des Providers), complaint, reject oder delivery. Noch keine Events bedeutet, dass der Provider noch nichts gemeldet hat; warten Sie und prüfen Sie erneut.
3. Wenn der Sendeaufruf selbst fehlgeschlagen ist, lesen Sie den Fehler-code: sender_domain_unverified → Domain-Verifizierung abschließen; recipient_suppressed → die Adresse hat zuvor gebounct oder sich beschwert; sender_paused → list_sender_reputation prüfen und die Listenquelle korrigieren; trial_recipient_restricted → Grenzen der Testphase; quota_exhausted → Nutzung in get_account prüfen.
4. get_domain prüft, ob DKIM, SPF und DMARC weiterhin veröffentlicht sind; deliverability_stats zeigt, ob das Problem eine einzelne Nachricht oder ein Trend ist.
5. Berichten Sie, was die Belege zeigen. Ein delivery-Event bedeutet, dass der Server des Empfängers die Nachricht angenommen hat, nicht dass sie im Posteingang gelandet ist oder gelesen wurde.

7. Einen Aufgaben-Bucket führen (Labels)

1. create_label mit name (zum Beispiel Agent/Orders) und skip_inbox: true. Das macht das Label zu einem Bucket: Empfangene E-Mails, die es erhalten, werden archiviert und erscheinen nur im Label, nie im Posteingang des Menschen.
2. Senden Sie Aufgaben-E-Mails mit send_email (oder send_batch) und labels: ["Agent/Orders"]. Antworten auf diese Unterhaltung erben das Label automatisch und umgehen den Posteingang.
3. Für E-Mails, die außerhalb Ihrer Unterhaltungen beginnen, fügen Sie eine Ablageregel hinzu: create_label_rule mit inbox_id (eine dedizierte Adresse wie orders@…), from, to oder subject. Übergeben Sie apply_to_existing: true, um bereits empfangene E-Mails abzulegen.
4. Den Bucket abarbeiten: list_emails mit label: "Agent/Orders", direction: "in" und unread: true; lesen Sie mit get_email oder get_thread, antworten Sie mit send_email und reply_to_email_id und setzen Sie nach der Bearbeitung mark_email read: true.
5. Verschieben Sie eine verirrte Nachricht mit label_email (add / remove) in den Bucket oder heraus. Wenn Sie einer empfangenen Nachricht ein Bucket-Label hinzufügen, wird sie ebenfalls archiviert.
6. Optional sendet set_inbox_forwarding eine Kopie von allem, was eine Empfangsadresse erhält, an ein anderes Postfach (das Ziel bestätigt zuvor per 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. Anhänge und Templates

Hängen Sie mit send_email attachments bis zu 10 Dateien an (jede braucht content_base64 oder einen lokalen file_path; filename entspricht standardmäßig dem Basisnamen der Datei), in einem kostenpflichtigen Tarif. Für gehostete Templates: create_template → update_template_draft → render_template für die Vorschau mit Beispieldaten → send_template_test (sendet eine echte Test-E-Mail) → publish_template. Senden Sie danach mit send_email oder send_batch unter Verwendung von template: {key, data} und genau einem to-Empfänger.

Ergebnisse, Paginierung und Fehler

Ein erfolgreicher Aufruf gibt das JSON-Objekt der API als structuredContent und als JSON-Textblock zurück. Jedes list_*-Tool akzeptiert limit (1–200, Standard 50) und offset und fügt ein pagination-Objekt hinzu. Rufen Sie weiter mit offset: pagination.next_offset auf, solange has_more true ist.

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

Ein fehlgeschlagener Aufruf gibt isError: true mit einem strukturierten Fehler zurück. Befolgen Sie remedy, statt blind zu wiederholen; versuchen Sie es nur erneut, wenn retryable true ist.

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

Optionale Fehlerfelder: request_id (nennen Sie sie dem Support), retry_after_seconds, problems (Liste der Schema-Verstöße bei invalid_arguments) und idempotent_replayed (siehe Idempotenz).

Idempotenz

send_email und send_batch akzeptieren idempotency_key (max. 200 Zeichen), der als Idempotency-Key-Header gesendet wird. Erzeugen Sie pro logischer Nachricht einen stabilen Schlüssel, zum Beispiel invoice-4812-receipt.

• Ein Wiederholungsversuch muss denselben Schlüssel UND einen identischen Anfrage-Body verwenden. Derselbe Schlüssel mit irgendeiner Änderung (Empfänger, Betreff, Text, Header, Template-Daten, sogar Argumentwerte) liefert 409 idempotency_conflict.
• Gleicher Schlüssel, gleicher Body, Original abgeschlossen: SendHQ gibt das gespeicherte Ergebnis zurück, ohne erneut zu senden. So wiederholen Sie nach einem Timeout oder network_error sicher.
• Gleicher Schlüssel, solange das Original noch läuft: 409 idempotency_in_progress, nach kurzer Wartezeit wiederholbar.
• Eine neue logische Nachricht braucht einen neuen Schlüssel.
• Auch gespeicherte Fehler werden wiedergegeben. Ist der erste Versuch fehlgeschlagen, liefert ein Wiederholungsversuch mit demselben Schlüssel genau diesen Fehler mit idempotent_replayed: true und retryable: false. Prüfen Sie mit list_emails (direction: out), dass nichts versendet wurde, beheben Sie die Ursache und senden Sie dann mit einem neuen Schlüssel.
• Der Server wiederholt nie von sich aus einen POST. Nur lesende GET-Aufrufe werden automatisch wiederholt (bis zu 3 Versuche bei Netzwerkfehlern, 429 und 5xx).
• send_email mit Inline-attachments kann keinen idempotency_key annehmen, da es mehrere Anfragen ausführt. Für wiederholungssichere Versände mit Anhang: create_draft → upload_attachment → send_email mit draft_id und 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"
  }
}

Rate-Limits und Kontingente

SendHQ veröffentlicht kein festes Limit für Anfragen pro Sekunde an die API. Die Grenzen, auf die ein Agent tatsächlich stößt, sind Nutzungslimits, die als 429 zurückgegeben werden:

• Monatliche Empfängerzustellungen pro Tarif. Jede To-, Cc- und Bcc-Adresse zählt als eine Zustellung. Siehe get_account → usage.recipientDeliveries im Vergleich zu usage.emailQuotaMonth.
• Tägliche Empfänger pro exakter Absenderadresse, bestimmt durch den Reputationsstatus dieses Absenders (list_sender_reputation → dailyLimit, in bezahlten Tarifen standardmäßig 2.000).
• Integrationstestphase: insgesamt 100 Empfänger, nur an die Konto-E-Mail-Adresse oder SES-Simulatoradressen.
• Anhänge: höchstens 10 Dateien und 10 MB pro Nachricht; 10 GB empfängergewichteter Anhangstransfer pro Monat in bezahlten Tarifen.
• Pro Anfrage: To + Cc + Bcc bis zu 100 Adressen; send_batch bis zu 100 Nachrichten.
• Reputations-Schutzschalter: Überschreiten Bounces oder Beschwerden in einem gleitenden 7-Tage-Fenster den Schwellenwert, wird eine Absenderadresse gedrosselt oder pausiert (423 sender_paused). Sie erholt sich automatisch, sobald die Raten sinken.

quota_exhausted ist nicht wiederholbar, bis die Periode zurückgesetzt wird oder sich der Tarif ändert. rate_limited ist nach retry_after_seconds wiederholbar; wiederholen Sie Versände mit demselben idempotency_key und identischem Body.

Fehlerkatalog

code ist stabil; verzweigen Sie danach und nicht anhand von message.

Tool-Referenz

Jedes Tool mit Sicherheitsklasse, dem aufgerufenen REST-Endpunkt, seinen Parametern, dem Rückgabeformat und einem Beispiel für das tools/call-params-Objekt. Die Parameter sind exakt: Der Server lehnt alles ab, was nicht aufgeführt ist.

E-Mails und Threads: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Labels und automatische Ablageregeln: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Entwürfe, Anhänge und Absenderidentitäten: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Gehostete Templates: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Domains und DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
Eingehende E-Mails: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Zustellbarkeit, Bounces und Sperrliste: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Konto, Nutzung, Analytics und Schlüssel: get_account, get_analytics, list_api_keys, get_service_health

Keine Tools entsprechen diesem Filter.

E-Mails und 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"
  }
}

Labels und automatische Ablageregeln

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

Entwürfe, Anhänge und Absenderidentitäten

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

Gehostete Templates

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

Domains und 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"
  }
}

Eingehende E-Mails

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

Zustellbarkeit, Bounces und Sperrliste

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

Konto, Nutzung, Analytics und Schlüssel

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

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

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

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

Abdeckung der API

Jede Operation der öffentlichen API und das Tool, das sie abdeckt. Alles, was ein Nutzer im Dashboard tun kann und wofür es eine API gibt, ist abgedeckt; die folgenden Ausnahmen sind beabsichtigt.

Bewusst nicht verfügbar

Maschinenlesbarer Katalog: /docs/mcp/tools.json (Schemas, Annotationen, Endpunktzuordnung, Ausnahmen). Markdown-Version dieser Seite: /docs/mcp.md. Mit installierter CLI gibt sendhq commands --format json denselben Katalog aus.