MCP-server van SendHQ

Wat deze server is

Met de MCP-server van SendHQ kan een AI-agent één SendHQ-workspace bedienen via het Model Context Protocol: e-mail versturen (los, in batches, met templates, als antwoord, met bijlagen, met idempotente retries), verzonden en ontvangen e-mail lezen en doorzoeken (onderwerpen, berichtteksten en namen van bijlagen) inclusief de bezorgevents, e-mail ordenen in labels met automatische sorteerregels, concepten en privébijlagen beheren, gehoste templates opstellen en publiceren, domeinen en hun DNS toevoegen en verifiëren, inkomende e-mail en inkomende adressen inrichten, deliverability, bounces, klachten en suppressies bekijken, en accountgebruik, factureringsstatus, analytics en metadata van API-sleutels lezen.

Het is een lokale stdio-server die is ingebouwd in de sendhq CLI-binary. Je MCP-client start sendhq mcp als childproces en communiceert via JSON-RPC over stdin/stdout. Elke toolcall wordt één gedocumenteerd request naar de SendHQ REST API op https://sendhq.cc/api/v1, geauthenticeerd met de API-sleutel van je workspace. De MCP-server heeft dus precies de rechten van die sleutel en niet meer.

• 59 tools in 8 groepen, gegenereerd uit één catalogus die ook wordt gepubliceerd als tools.json.
• Strikte JSON Schemas: onbekende argumenten, verkeerde types en ontbrekende verplichte velden worden lokaal geweigerd voordat er iets bij SendHQ aankomt.
• Gestructureerde fouten met een stabiele code, de HTTP-status, een explanation, een concrete remedy en of opnieuw proberen zin heeft.
• Elke tool die echte e-mail verstuurt of data vernietigt, zegt dat in de eerste woorden van de beschrijving en heeft MCP-veiligheidsannotaties.
• De modus --read-only verbergt alle tools die verzenden of iets wijzigen.
• Er wordt niets gelogd. stdout bevat alleen protocolberichten; de API-sleutel en berichtinhoud komen nooit in een log terecht.

SendHQ gebruiken in Claude en ChatGPT

Geen installatie nodig: SendHQ draait deze server ook als gehoste connector op https://mcp.sendhq.cc/mcp, met dezelfde tools. Je logt in met je SendHQ-account in plaats van een sleutel te plakken.

Claude

1. Open Settings → Connectors en zoek SendHQ in de directory, of kies Add custom connector en plak https://mcp.sendhq.cc/mcp.
2. Klik op Connect, log in bij SendHQ, controleer de toegang en klik op Allow.
3. Vraag Claude om je inbox te controleren, een e-mail vanaf je geverifieerde domein te versturen of een bounce uit te leggen.

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.

Goedkeuring en verbinding verbreken

• 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-mail versturen of data verwijderen, zijn als zodanig gelabeld. Of de assistent je eerst om toestemming vraagt, stel je per tool in de assistent in: kies in Claude voor die tools Needs approval onder Settings → Connectors → SendHQ.
• De connector krijgt een eigen API-sleutel, genoemd naar de assistent (bijvoorbeeld “Claude (AI connector)”). Verwijder die onder API Keys om de verbinding direct te verbreken.
• De connector kan geen API-sleutels aanmaken of intrekken en de facturering niet wijzigen. Bijlagen worden als base64 verstuurd en teruggegeven; er is geen toegang tot lokale bestanden.
• Onbetaalde workspaces (integratieproefperiode) kunnen alleen afleveren bij het e-mailadres van het account of bij een AWS SES-simulatoradres.

Vragen: postmaster@sendhq.cc. Privacy: sendhq.cc/privacy.

Installeren

Installeer de sendhq-binary (Linux, macOS en Windows op x86-64 en arm64). Het installatieprogramma controleert de checksum van de release en zet de binary standaard in ~/.local/bin.

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

Maak een API-sleutel aan in het dashboard op https://sendhq.cc/app#/keys. De MCP-server kan geen sleutels aanmaken. Het enige commando dat de server start is:

SENDHQ_API_KEY=re_your_key sendhq mcp

Normaal start je dit nooit handmatig: de MCP-client doet dat. Als je het in een terminal uitvoert, wacht het op JSON-RPC via stdin.

Je client configureren

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

Voeg --scope user toe om de server in elk project beschikbaar te maken, of --scope project om hem naar de .mcp.json van het project te schrijven. Verwijs in een gedeelde .mcp.json naar de sleutel uit de omgeving in plaats van hem te committen; Claude Code expandeert ${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" }

Of via de commandline: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Bewerk claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) en herstart de app. Desktopapps nemen het PATH van je shell niet over, dus gebruik het absolute pad van de binary (which sendhq).

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

Elke andere MCP-client

Configureer een stdio-server met het commando sendhq, de argumenten ["mcp"] (optioneel "--read-only") en de omgevingsvariabelen hieronder. De server ondersteunt de MCP-protocolversies 2024-11-05, 2025-03-26, 2025-06-18 en 2025-11-25, en implementeert initialize, ping, tools/list en tools/call. Toolresultaten bevatten zowel een JSON-tekstblok als 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":{}}}

Er is geen gehost HTTP-transport voor de server met toegang tot je account. Een remote MCP-endpoint met schrijfrechten zou OAuth per gebruiker vereisen, en dat biedt SendHQ niet; de lokale binary houdt de sleutel op de machine waar hij al staat.

Omgeving en flags

De sleutel wordt alleen als Authorization: Bearer-header naar de geconfigureerde base-URL gestuurd. Hij wordt nooit afgedrukt, gelogd, herhaald in foutmeldingen of opgenomen in toolresultaten.

Veiligheidsmodel voor agents

• Verstuurt echte e-mail. send_email, send_batch en send_template_test leveren e-mail af bij echte mensen en verbruiken bezorgcredits. Hun beschrijvingen beginnen met SENDS REAL EMAIL. Roep ze alleen aan als de gebruiker expliciet heeft gevraagd om dat specifieke bericht te versturen, met bevestigde ontvangers, afzender en inhoud.
• Destructief. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox en remove_suppression zijn gemarkeerd met destructiveHint: true en hun beschrijvingen beginnen met DESTRUCTIVE. Vraag eerst bevestiging aan de gebruiker. remove_suppression verzwakt een veiligheidsblokkade en is alleen gepast als een mens bevestigt dat het adres weer werkt.
• Wijzigt de status. Concepten, templates, domeinen en inboxen aanmaken of bijwerken, templates publiceren en verificatie starten wijzigt de workspace, maar verstuurt geen e-mail.
• Alleen-lezen. Al het andere is readOnlyHint: true en kun je vrij aanroepen.
• Deze server wijzigt nooit DNS. add_domain geeft records terug die een mens moet publiceren; get_domain_connect_link geeft een toestemmings-URL terug die iemand moet openen en bij de DNS-provider moet goedkeuren.
• Deze server wijzigt nooit de facturering. get_account leest alleen het abonnement, het gebruik en de status van het abonnement.
• Onbetaalde workspaces (integratieproefperiode) kunnen alleen afleveren bij het e-mailadres van de accounteigenaar (get_account → user.email) of bij een AWS SES-simulatoradres zoals success@simulator.amazonses.com, en kunnen geen bijlagen versturen.
• Geaccepteerd is niet afgeleverd. Een geslaagde verzending geeft een ID terug; bewijs van bezorging, bounces en klachten komt later binnen in list_email_events. Beweer nooit dat een bericht in de inbox is beland of dat iemand het heeft gelezen.
• Stap niet over op een ander From-adres om een 423-pauze te omzeilen, en voeg afgemelde ontvangers of ontvangers met een klacht nooit opnieuw toe.

API-sleutels vallen buiten de scope

Er zijn bewust geen tools die API-sleutels aanmaken, wijzigen, roteren, intrekken of verwijderen. Een agent mag geen credentials aanmaken of vernietigen. list_api_keys geeft alleen namen, niet-geheime prefixen en het tijdstip van laatste gebruik terug. Sleutelbeheer blijft in het dashboard, bij een ingelogde mens.

Workflows

1. Eerste verzending

1. get_service_health bevestigt dat de API bereikbaar is (werkt zonder sleutel).
2. get_account toont het abonnement (access.tier), het resterende quotum en user.email. Tijdens de proefperiode is dat e-mailadres de enige echte ontvanger die is toegestaan.
3. list_sending_identities toont de From-adressen die je kunt gebruiken. Is de lijst leeg, doorloop dan eerst de domeinworkflow.
4. Bevestig afzender, ontvanger, onderwerp en berichttekst met de gebruiker en roep daarna send_email aan met een idempotency_key.
5. list_email_events met het teruggegeven id toont delivery, bounce, complaint of reject zodra de provider dat meldt (meestal binnen seconden tot 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. Domeinverificatie van begin tot eind

1. add_domain met name: "example.com". Het resultaat bevat de DNS-records (DKIM-CNAME's, SES-verificatie, SPF, aanbevolen DMARC).
2. get_dns_provider met de domain_id detecteert de gezaghebbende DNS-provider en geeft per record de exacte relatieve host terug die je bij die provider moet invullen.
3. Is providers.domainConnect.available true, dan geeft get_domain_connect_link een toestemmings-URL terug. Geef die aan de mens; er verandert niets totdat die bij de provider goedkeurt. Geef de mens anders de records om te publiceren. Publiceer nooit een tweede SPF-record: voeg include:amazonses.com samen met de bestaande v=spf1-waarde.
4. verify_domain controleert DNS en SES opnieuw. De status loopt via pending, checking en propagating naar verified. Poll verify_domain of get_domain elke 30–60 seconden; DNS kan minuten tot uren duren.
5. Als status verified is, verschijnen de adressen van het domein in list_sending_identities.

3. Bounces, klachten en suppressies

1. list_blocked_recipients geeft elk geblokkeerd adres terug met de reden (bounce, complaint, unsubscribe) en een totaaloverzicht.
2. list_suppressions geeft suppressies door hard bounces en klachten terug; deliverability_stats geeft bezorg-, bounce- en klachtpercentages over 30 dagen; list_sender_reputation laat zien welke From-adressen worden afgeremd of gepauzeerd.
3. Een verzending met een ontvanger op de suppressielijst mislukt met 422 recipient_suppressed. Verwijder die ontvanger en verstuur opnieuw.
4. Roep remove_suppression alleen aan als een mens bevestigt dat een mailbox met een bounce nu weer werkt. Suppressies door klachten zijn permanent (409 complaint_suppression_locked).

4. Inkomende e-mail ontvangen

1. Het domein (vaak een subdomein zoals inbound.example.com) moet geverifieerd zijn.
2. setup_inbound richt ontvangst in en geeft één MX-record terug. Een mens publiceert het.
3. verify_inbound totdat status ready is.
4. create_inbox met domain_id en local_part (bijvoorbeeld support) maakt support@inbound.example.com aan.
5. Poll list_emails met direction: "in" en unread: true (optioneel inbox_id). Lees een bericht met get_email, de conversatie met get_thread, bijlagen met download_attachment, en markeer het als afgehandeld met mark_email (read: true).
6. Antwoord in de thread met send_email en reply_to_email_id; SendHQ stelt In-Reply-To, References en de thread in.

5. Webhooks en eventnotificaties

SendHQ biedt op dit moment geen webhooks die klanten zelf kunnen configureren, dus er is geen webhooktool. Notificaties van de provider worden binnen SendHQ verwerkt en zijn via leesoperaties beschikbaar. Poll in plaats daarvan: list_email_events voor de uitkomst van één bericht, list_emails met status (bijvoorbeeld bounced) of after voor recente wijzigingen, list_emails met direction: "in" en unread: true voor nieuwe inkomende e-mail, en list_blocked_recipients voor nieuwe suppressies. Poll niet vaker dan ongeveer één keer per minuut per vraag.

6. Een mislukte bezorging diagnosticeren

1. Zoek het bericht: list_emails met direction: "out" en to of query, of get_email als je het ID hebt. status: failed betekent dat SendHQ of de provider het bij het aanbieden heeft geweigerd; de fout bij de e-mail legt uit waarom.
2. list_email_events: bounce (permanent of tijdelijk, met de diagnose van de provider), complaint, reject of delivery. Nog geen events betekent dat de provider nog niets heeft gemeld; wacht en kijk later opnieuw.
3. Is de verzendcall zelf mislukt, lees dan de fout-code: sender_domain_unverified → rond de domeinverificatie af; recipient_suppressed → het adres gaf eerder een hard bounce of een klacht; sender_paused → bekijk list_sender_reputation en herstel de bron van de lijst; trial_recipient_restricted → limieten van de proefperiode; quota_exhausted → gebruik in get_account.
4. get_domain controleert of DKIM, SPF en DMARC nog gepubliceerd zijn; deliverability_stats laat zien of het probleem één bericht betreft of een trend is.
5. Rapporteer wat het bewijs laat zien. Een delivery-event betekent dat de server van de ontvanger het bericht heeft geaccepteerd, niet dat het in de inbox is beland of is gelezen.

7. Een eigen taakbucket (labels)

1. create_label met name (bijvoorbeeld Agent/Orders) en skip_inbox: true. Daarmee wordt het label een bucket: ontvangen e-mail die het label krijgt, wordt gearchiveerd, zodat hij alleen in het label verschijnt en nooit in de Inbox van de mens.
2. Verstuur taakmail met send_email (of send_batch) en labels: ["Agent/Orders"]. Antwoorden in die conversatie krijgen automatisch het label en slaan de Inbox over.
3. Voeg voor e-mail die buiten je conversaties begint een sorteerregel toe: create_label_rule met inbox_id (een apart adres zoals orders@…), from, to of subject. Geef apply_to_existing: true mee om al ontvangen e-mail ook te sorteren.
4. Werk de bucket af: list_emails met label: "Agent/Orders", direction: "in" en unread: true; lees met get_email of get_thread, antwoord met send_email en reply_to_email_id, en roep mark_email read: true aan als het is afgehandeld.
5. Verplaats een verdwaald bericht naar de bucket of eruit met label_email (add / remove). Een bucketlabel toevoegen aan een ontvangen bericht archiveert het ook.
6. Optioneel stuurt set_inbox_forwarding een kopie van alles wat een ontvangend adres binnenkrijgt naar een andere mailbox (het doeladres bevestigt eerst 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. Bijlagen en templates

Voeg op een betaald abonnement maximaal 10 bestanden toe met send_email attachments (elk bestand heeft content_base64 of een lokaal file_path nodig; filename is standaard de basisnaam van het bestand). Voor gehoste templates: create_template → update_template_draft → render_template voor een voorbeeld met voorbeelddata → send_template_test (verstuurt één echte test) → publish_template, en verstuur daarna met send_email of send_batch via template: {key, data} en precies één to-ontvanger.

Resultaten, paginering en fouten

Een geslaagde call geeft het JSON-object van de API terug als structuredContent en als JSON-tekstblok. Elke list_*-tool accepteert limit (1–200, standaard 50) en offset, en voegt een pagination-object toe. Blijf aanroepen met offset: pagination.next_offset zolang has_more true is.

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

Een mislukte call geeft isError: true terug met een gestructureerde fout. Volg remedy in plaats van blind opnieuw te proberen; probeer alleen opnieuw als retryable true is.

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

Optionele foutvelden: request_id (vermeld die bij support), retry_after_seconds, problems (lijst met schemaschendingen bij invalid_arguments) en idempotent_replayed (zie Idempotentie).

Idempotentie

send_email en send_batch accepteren idempotency_key (maximaal 200 tekens), die wordt meegestuurd als Idempotency-Key-header. Genereer één stabiele sleutel per logisch bericht, bijvoorbeeld invoice-4812-receipt.

• Een retry moet dezelfde sleutel EN een identieke requestbody gebruiken. Dezelfde sleutel met welke wijziging dan ook (ontvanger, onderwerp, berichttekst, header, templatedata, zelfs argumentwaarden) geeft 409 idempotency_conflict.
• Dezelfde sleutel, dezelfde body, origineel afgerond: SendHQ geeft het opgeslagen resultaat terug zonder opnieuw te versturen. Zo probeer je het veilig opnieuw na een time-out of network_error.
• Dezelfde sleutel terwijl het origineel nog loopt: 409 idempotency_in_progress, na korte tijd opnieuw te proberen.
• Een nieuw logisch bericht heeft een nieuwe sleutel nodig.
• Opgeslagen fouten worden ook opnieuw afgespeeld. Is de eerste poging mislukt, dan geeft een retry met dezelfde sleutel diezelfde fout terug met idempotent_replayed: true en retryable: false. Controleer met list_emails (direction: out) dat er niets is verstuurd, los de oorzaak op en verstuur daarna met een nieuwe sleutel.
• De server probeert een POST nooit uit zichzelf opnieuw. Alleen alleen-lezen GET-calls worden automatisch opnieuw geprobeerd (maximaal 3 pogingen bij netwerkfouten, 429 en 5xx).
• send_email met inline attachments kan geen idempotency_key meekrijgen, omdat het meerdere requests uitvoert. Voor verzendingen met bijlagen die veilig opnieuw kunnen: create_draft → upload_attachment → send_email met draft_id en 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 en quota

SendHQ publiceert geen vaste limiet voor het aantal requests per seconde op de API. De limieten waar een agent echt tegenaan loopt, zijn gebruikslimieten, die als 429 worden teruggegeven:

• Maandelijkse afleveringen aan ontvangers per abonnement. Elk To-, Cc- en Bcc-adres telt als één aflevering. Zie get_account → usage.recipientDeliveries vs. usage.emailQuotaMonth.
• Dagelijkse ontvangers per exact From-adres, bepaald door de reputatiestatus van die afzender (list_sender_reputation → dailyLimit, standaard 2.000 op betaalde abonnementen).
• Integratieproefperiode: in totaal 100 ontvangers, alleen naar het e-mailadres van het account of naar SES-simulatoradressen.
• Bijlagen: maximaal 10 bestanden en 10 MB per bericht; 10 GB aan bijlagenverkeer per maand, gewogen naar ontvangers, op betaalde abonnementen.
• Per request: To + Cc + Bcc tot 100 adressen; send_batch tot 100 berichten.
• Reputatie-circuitbreaker: in een rollend venster van 7 dagen zorgen bounces of klachten boven de drempel ervoor dat één From-adres wordt afgeremd of gepauzeerd (423 sender_paused). Het herstelt automatisch zodra de percentages dalen.

quota_exhausted kun je pas opnieuw proberen als de periode opnieuw begint of het abonnement verandert. rate_limited kun je opnieuw proberen na retry_after_seconds; probeer verzendingen opnieuw met dezelfde idempotency_key en een identieke body.

Foutencatalogus

code is stabiel; baseer je logica daarop en niet op message.

Toolreferentie

Elke tool met zijn veiligheidsklasse, het REST-endpoint dat hij aanroept, zijn parameters, de responsstructuur en een voorbeeld van een params-object voor tools/call. De parameters zijn exact: de server weigert alles wat niet vermeld staat.

E-mails en threads: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Labels en automatische sorteerregels: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Concepten, bijlagen en afzenderidentiteiten: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Gehoste templates: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Domeinen en DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
Inkomende e-mail: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Deliverability, bounces en suppressies: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Account, gebruik, analytics en sleutels: get_account, get_analytics, list_api_keys, get_service_health

Geen tools gevonden voor dit filter.

E-mails en 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 en automatische sorteerregels

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

Concepten, bijlagen en afzenderidentiteiten

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

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

Domeinen en 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"
  }
}

Inkomende e-mail

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

Deliverability, bounces en suppressies

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

Account, gebruik, analytics en sleutels

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

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

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

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

Overzicht van de API-dekking

Elke bewerking in de publieke API en de tool die haar dekt. Alles wat een gebruiker in het dashboard kan doen en een API heeft, wordt gedekt; de uitzonderingen hieronder zijn bewust.

Bewust niet beschikbaar

Machineleesbare catalogus: /docs/mcp/tools.json (schema's, annotaties, koppeling met endpoints, uitzonderingen). Markdownversie van deze pagina: /docs/mcp.md. Met de CLI geïnstalleerd print sendhq commands --format json dezelfde catalogus.