Server MCP di SendHQ

Che cos'è questo server

Il server MCP di SendHQ permette a un agente AI di gestire un workspace SendHQ tramite il Model Context Protocol: inviare email (singole, batch, da template, risposte, allegati, nuovi tentativi idempotenti), leggere e cercare la posta inviata e ricevuta (oggetti, corpi e nomi degli allegati) e i relativi eventi di consegna, organizzare la posta in etichette con regole di archiviazione automatica, gestire bozze e allegati privati, creare e pubblicare template ospitati, aggiungere e verificare domini e il relativo DNS, configurare la ricezione e gli indirizzi in entrata, consultare deliverability, bounce, segnalazioni di spam e soppressioni, e leggere utilizzo dell'account, stato della fatturazione, analytics e metadati delle chiavi API.

È un server stdio locale integrato nel binario della CLI sendhq. Il tuo client MCP avvia sendhq mcp come processo figlio e comunica in JSON-RPC su stdin/stdout. Ogni chiamata a uno strumento diventa una richiesta documentata all'API REST di SendHQ su https://sendhq.cc/api/v1, autenticata con la chiave API del tuo workspace: il server MCP ha quindi esattamente i permessi di quella chiave, non uno di più.

• 59 strumenti in 8 gruppi, generati da un unico catalogo pubblicato anche come tools.json.
• JSON Schema rigorosi: argomenti sconosciuti, tipi errati e campi obbligatori mancanti vengono rifiutati in locale, prima che qualcosa arrivi a SendHQ.
• Errori strutturati con un code stabile, lo status HTTP, una explanation, un remedy concreto e l'indicazione se un nuovo tentativo può essere utile.
• Ogni strumento che invia email reali o distrugge dati lo dichiara nelle prime parole della sua descrizione e riporta le annotazioni di sicurezza MCP.
• La modalità --read-only nasconde tutti gli strumenti che inviano o modificano dati.
• Non viene registrato nulla. stdout trasporta solo messaggi di protocollo; la chiave API e il contenuto dei messaggi non finiscono mai in un log.

Usare SendHQ in Claude e ChatGPT

Nessuna installazione necessaria: SendHQ esegue questo server anche come connettore ospitato su https://mcp.sendhq.cc/mcp, con gli stessi strumenti. Accedi con il tuo account SendHQ invece di incollare una chiave.

Claude

1. Apri Impostazioni → Connettori e cerca SendHQ nella directory, oppure scegli Aggiungi connettore personalizzato e incolla https://mcp.sendhq.cc/mcp.
2. Fai clic su Connetti, accedi a SendHQ, controlla l'accesso richiesto e fai clic su Consenti.
3. Chiedi a Claude di controllare la tua inbox, inviare un'email dal tuo dominio verificato o spiegarti 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.

Approvazione e disconnessione

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• Gli strumenti che inviano email reali o eliminano dati sono etichettati come tali. Se l'assistente debba chiederti conferma prima si imposta per singolo strumento nell'assistente: in Claude, scegli Richiede approvazione per quegli strumenti in Impostazioni → Connettori → SendHQ.
• Il connettore riceve una propria chiave API, con il nome dell'assistente (ad esempio “Claude (AI connector)”). Eliminala in Chiavi API per disconnetterlo immediatamente.
• Non può creare né revocare chiavi API né modificare la fatturazione. Gli allegati vengono inviati e restituiti in base64; non c'è accesso ai file locali.
• I workspace non a pagamento (prova di integrazione) possono consegnare solo all'email dell'account o a un indirizzo del simulatore di AWS SES.

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

Installazione

Installa il binario sendhq (Linux, macOS e Windows su x86-64 e arm64). L'installer verifica il checksum della release e, per impostazione predefinita, colloca il binario 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

Crea una chiave API nella dashboard su https://sendhq.cc/app#/keys. Il server MCP non può creare chiavi. L'unico comando che avvia il server è:

SENDHQ_API_KEY=re_your_key sendhq mcp

Di solito non lo esegui mai a mano: è il client MCP ad avviarlo. Se lo lanci in un terminale, resta in attesa di JSON-RPC su stdin.

Configura il tuo 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

Aggiungi --scope user per renderlo disponibile in tutti i progetti, oppure --scope project per scriverlo nel file .mcp.json del progetto. Per un .mcp.json condiviso, fai riferimento alla chiave tramite l'ambiente invece di committarla; Claude Code espande ${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" }

Oppure da riga di comando: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp.

Claude Desktop

Modifica claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) e riavvia l'app. Le app desktop non ereditano il PATH della tua shell, quindi usa il percorso assoluto del binario (which sendhq).

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

Qualsiasi altro client MCP

Configura un server stdio con il comando sendhq, gli argomenti ["mcp"] (facoltativamente "--read-only") e le variabili d'ambiente riportate sotto. Il server supporta le versioni del protocollo MCP 2024-11-05, 2025-03-26, 2025-06-18 e 2025-11-25, e implementa initialize, ping, tools/list e tools/call. I risultati degli strumenti contengono sia un blocco di testo JSON sia 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":{}}}

Non esiste un trasporto HTTP ospitato per il server con ambito limitato all'account. Un endpoint MCP remoto con permessi di scrittura richiederebbe OAuth per utente, che SendHQ non offre; il binario locale tiene la chiave sulla macchina che già la custodisce.

Ambiente e flag

La chiave viene inviata solo come intestazione Authorization: Bearer all'URL di base configurato. Non viene mai stampata, registrata nei log, ripetuta negli errori o inclusa nei risultati degli strumenti.

Modello di sicurezza per gli agenti

• Invia email reali. send_email, send_batch e send_template_test consegnano posta a persone reali e consumano crediti di consegna. Le loro descrizioni iniziano con SENDS REAL EMAIL. Chiamali solo quando l'utente ha chiesto esplicitamente di inviare quel messaggio specifico, con destinatari, mittente e contenuto confermati.
• Distruttivi. delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox e remove_suppression sono contrassegnati con destructiveHint: true e le loro descrizioni iniziano con DESTRUCTIVE. Chiedi prima conferma all'utente. remove_suppression indebolisce un blocco di sicurezza ed è appropriato solo quando una persona conferma che l'indirizzo funziona di nuovo.
• Modificano lo stato. Creare o aggiornare bozze, template, domini e inbox, pubblicare template e avviare la verifica modificano il workspace, ma non inviano posta.
• Sola lettura. Tutto il resto è readOnlyHint: true e si può chiamare liberamente.
• Questo server non modifica mai il DNS. add_domain restituisce i record che una persona deve pubblicare; get_domain_connect_link restituisce un URL di consenso che una persona deve aprire e approvare presso il proprio provider DNS.
• Questo server non modifica mai la fatturazione. get_account legge solo piano, utilizzo e stato dell'abbonamento.
• I workspace non a pagamento (prova di integrazione) possono consegnare solo all'email del titolare dell'account (get_account → user.email) o a un indirizzo del simulatore di AWS SES come success@simulator.amazonses.com, e non possono inviare allegati.
• Accettato non significa consegnato. Un invio riuscito restituisce un ID; le prove di consegna, bounce e segnalazione di spam arrivano più tardi in list_email_events. Non affermare mai che un messaggio è arrivato in inbox o che una persona lo ha letto.
• Non passare a un altro indirizzo From per aggirare una pausa 423, e non aggiungere mai di nuovo destinatari che si sono disiscritti o hanno segnalato spam.

Le chiavi API sono escluse

Per scelta progettuale non esistono strumenti che creano, modificano, ruotano, revocano o eliminano chiavi API. Un agente non deve generare né distruggere credenziali. list_api_keys restituisce solo nomi, prefissi non segreti e data dell'ultimo utilizzo. La gestione delle chiavi resta nella dashboard, in mano a una persona che ha effettuato l'accesso.

Flussi di lavoro

1. Primo invio

1. get_service_health conferma che l'API è raggiungibile (funziona senza chiave).
2. get_account mostra il piano (access.tier), la quota residua e user.email. Durante la prova, quell'email è l'unico destinatario reale consentito.
3. list_sending_identities elenca gli indirizzi From che puoi usare. Se è vuoto, completa prima il flusso del dominio.
4. Conferma con l'utente mittente, destinatario, oggetto e corpo, poi chiama send_email con una idempotency_key.
5. list_email_events con l'id restituito mostra delivery, bounce, complaint o reject non appena il provider lo segnala (di solito da pochi secondi a qualche minuto).

{
  "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 del dominio dall'inizio alla fine

1. add_domain con name: "example.com". Il risultato include i record DNS (CNAME DKIM, verifica SES, SPF, DMARC consigliato).
2. get_dns_provider con il domain_id rileva il provider DNS autoritativo e restituisce l'host relativo esatto da inserire per ogni record presso quel provider.
3. Se providers.domainConnect.available è true, get_domain_connect_link restituisce un URL di consenso. Passalo alla persona: non cambia nulla finché non approva presso il provider. Altrimenti, dai alla persona i record da pubblicare. Non pubblicare mai un secondo record SPF: unisci include:amazonses.com al valore v=spf1 esistente.
4. verify_domain ricontrolla DNS e SES. Lo stato passa da pending, checking e propagating a verified. Interroga verify_domain o get_domain ogni 30–60 secondi; il DNS può richiedere da qualche minuto a qualche ora.
5. Quando status è verified, gli indirizzi del dominio compaiono in list_sending_identities.

3. Bounce, segnalazioni di spam e soppressioni

1. list_blocked_recipients restituisce ogni indirizzo bloccato con il relativo motivo (bounce, complaint, unsubscribe) e un conteggio riassuntivo.
2. list_suppressions restituisce le soppressioni per hard bounce e per segnalazione di spam; deliverability_stats fornisce i tassi di consegna, bounce e segnalazioni di spam degli ultimi 30 giorni; list_sender_reputation mostra quali indirizzi From sono rallentati o in pausa.
3. Un invio che contiene un destinatario soppresso fallisce con 422 recipient_suppressed. Rimuovi quel destinatario e invia di nuovo.
4. Chiama remove_suppression solo quando una persona conferma che una casella in bounce ora funziona. Le soppressioni per segnalazione di spam sono permanenti (409 complaint_suppression_locked).

4. Ricevere email in entrata

1. Il dominio (spesso un sottodominio come inbound.example.com) deve essere verificato.
2. setup_inbound predispone la ricezione e restituisce un record MX, che una persona pubblica.
3. verify_inbound finché status non è ready.
4. create_inbox con domain_id e local_part (ad esempio support) crea support@inbound.example.com.
5. Interroga periodicamente list_emails con direction: "in" e unread: true (facoltativamente inbox_id). Leggi un messaggio con get_email, la sua conversazione con get_thread, gli allegati con download_attachment, e segnalo come gestito con mark_email (read: true).
6. Rispondi nel thread con send_email e reply_to_email_id; SendHQ imposta In-Reply-To, References e il thread.

5. Webhook e notifiche degli eventi

Al momento SendHQ non offre webhook configurabili dai clienti, quindi non esiste uno strumento per i webhook. Le notifiche del provider vengono elaborate all'interno di SendHQ ed esposte tramite letture. Usa invece il polling: list_email_events per l'esito di un messaggio, list_emails con status (ad esempio bounced) o after per le modifiche recenti, list_emails con direction: "in" e unread: true per la nuova posta in entrata e list_blocked_recipients per le nuove soppressioni. Non interrogare più di circa una volta al minuto per ogni domanda.

6. Diagnosticare un errore di consegna

1. Trova il messaggio: list_emails con direction: "out" e to o query, oppure get_email se hai l'ID. status: failed significa che SendHQ o il provider lo ha rifiutato all'invio; l'errore dell'email spiega il motivo.
2. list_email_events: bounce (permanente o transitorio, con la diagnostica del provider), complaint, reject o delivery. Se non ci sono ancora eventi, il provider non ha ancora segnalato nulla: attendi e ricontrolla.
3. Se è fallita la chiamata di invio stessa, leggi il code dell'errore: sender_domain_unverified → completa la verifica del dominio; recipient_suppressed → l'indirizzo ha già generato un hard bounce o una segnalazione di spam; sender_paused → controlla list_sender_reputation e correggi l'origine della lista; trial_recipient_restricted → limiti della prova; quota_exhausted → utilizzo in get_account.
4. get_domain controlla che DKIM, SPF e DMARC siano ancora pubblicati; deliverability_stats mostra se il problema riguarda un solo messaggio o è una tendenza.
5. Riporta ciò che mostrano le prove. Un evento delivery significa che il server del destinatario ha accettato il messaggio, non che è arrivato in inbox o è stato letto.

7. Gestire un bucket di lavoro (etichette)

1. create_label con name (ad esempio Agent/Orders) e skip_inbox: true. Così l'etichetta diventa un bucket: la posta ricevuta che la ottiene viene archiviata, quindi compare solo nell'etichetta e mai nella Inbox della persona.
2. Invia la posta di lavoro con send_email (o send_batch) e labels: ["Agent/Orders"]. Le risposte a quella conversazione ereditano automaticamente l'etichetta e saltano la Inbox.
3. Per la posta che nasce fuori dalle tue conversazioni, aggiungi una regola di archiviazione: create_label_rule con inbox_id (un indirizzo dedicato come orders@…), from, to o subject. Passa apply_to_existing: true per archiviare anche la posta già ricevuta.
4. Lavora sul bucket: list_emails con label: "Agent/Orders", direction: "in" e unread: true; leggi con get_email o get_thread, rispondi con send_email e reply_to_email_id, e chiama mark_email read: true una volta gestito.
5. Sposta un messaggio fuori posto dentro o fuori con label_email (add / remove). Aggiungere l'etichetta di un bucket a un messaggio ricevuto lo archivia anche.
6. Facoltativamente, set_inbox_forwarding invia a un'altra casella una copia di tutto ciò che riceve un indirizzo (la destinazione conferma prima via email).

{
  "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. Allegati e template

Con un piano a pagamento, allega fino a 10 file con attachments di send_email (ognuno richiede content_base64 o un file_path locale; filename ha come valore predefinito il nome base del file). Per i template ospitati: create_template → update_template_draft → render_template per l'anteprima con dati di esempio → send_template_test (invia un test reale) → publish_template, quindi invia con send_email o send_batch usando template: {key, data} ed esattamente un destinatario to.

Risultati, paginazione ed errori

Una chiamata riuscita restituisce l'oggetto JSON dell'API come structuredContent e come blocco di testo JSON. Ogni strumento list_* accetta limit (1–200, predefinito 50) e offset, e aggiunge un oggetto pagination. Continua a chiamarlo con offset: pagination.next_offset finché has_more è true.

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

Una chiamata non riuscita restituisce isError: true con un errore strutturato. Segui remedy invece di ritentare alla cieca; ritenta solo quando retryable è 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."
  }
}

Campi di errore facoltativi: request_id (da citare al supporto), retry_after_seconds, problems (elenco delle violazioni di schema per invalid_arguments) e idempotent_replayed (vedi Idempotenza).

Idempotenza

send_email e send_batch accettano idempotency_key (massimo 200 caratteri), inviata come intestazione Idempotency-Key. Genera una chiave stabile per ogni messaggio logico, ad esempio invoice-4812-receipt.

• Un nuovo tentativo deve riutilizzare la stessa chiave E un corpo della richiesta identico. La stessa chiave con una qualsiasi modifica (destinatario, oggetto, corpo, intestazione, dati del template, perfino i valori degli argomenti) restituisce 409 idempotency_conflict.
• Stessa chiave, stesso corpo, originale completato: SendHQ restituisce il risultato memorizzato senza inviare di nuovo. È così che ritenti in sicurezza dopo un timeout o un network_error.
• Stessa chiave mentre l'originale è ancora in esecuzione: 409 idempotency_in_progress, ritentabile dopo una breve attesa.
• Un nuovo messaggio logico richiede una nuova chiave.
• Anche gli errori memorizzati vengono riprodotti. Se il primo tentativo è fallito, ritentare con la stessa chiave restituisce lo stesso errore con idempotent_replayed: true e retryable: false. Controlla list_emails (direction: out) per confermare che non sia partito nulla, correggi la causa e poi invia con una chiave nuova.
• Il server non ritenta mai una POST di sua iniziativa. Solo le chiamate GET di sola lettura vengono ritentate automaticamente (fino a 3 tentativi in caso di errori di rete, 429 e 5xx).
• send_email con attachments inline non accetta una idempotency_key, perché esegue più richieste. Per inviare allegati in modo sicuro rispetto ai nuovi tentativi: create_draft → upload_attachment → send_email con 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"
  }
}

Limiti di frequenza e quote

SendHQ non pubblica un limite fisso di richieste al secondo (rate limit) per l'API. I limiti che un agente incontra davvero sono limiti di utilizzo, restituiti come 429:

• Consegne mensili per destinatario per piano. Ogni indirizzo To, Cc e Bcc conta come una consegna. Confronta get_account → usage.recipientDeliveries con usage.emailQuotaMonth.
• Destinatari giornalieri per indirizzo From esatto, stabiliti dallo stato di reputazione di quel mittente (list_sender_reputation → dailyLimit, 2.000 per impostazione predefinita sui piani a pagamento).
• Prova di integrazione: 100 destinatari in totale, solo verso l'email dell'account o gli indirizzi del simulatore SES.
• Allegati: al massimo 10 file e 10 MB per messaggio; 10 GB al mese di trasferimento di allegati ponderato per destinatario sui piani a pagamento.
• Per richiesta: To + Cc + Bcc fino a 100 indirizzi; send_batch fino a 100 messaggi.
• Circuit breaker della reputazione: in una finestra mobile di 7 giorni, bounce o segnalazioni di spam sopra soglia rallentano o mettono in pausa un indirizzo From (423 sender_paused). Si ripristina automaticamente quando i tassi scendono.

quota_exhausted non è ritentabile finché il periodo non si azzera o il piano non cambia. rate_limited è ritentabile dopo retry_after_seconds; per gli invii, ritenta con la stessa idempotency_key e un corpo identico.

Catalogo degli errori

code è stabile: basa la logica su di esso, non su message.

Riferimento degli strumenti

Ogni strumento con la sua classe di sicurezza, l'endpoint REST che chiama, i parametri, la struttura della risposta e un oggetto params di esempio per tools/call. I parametri sono esatti: il server rifiuta tutto ciò che non è elencato.

Email e thread: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
Etichette e regole di archiviazione automatica: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
Bozze, allegati e identità mittente: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
Template ospitati: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
Domini e DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
Email in entrata: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
Deliverability, bounce e soppressioni: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
Account, utilizzo, analytics e chiavi: get_account, get_analytics, list_api_keys, get_service_health

Nessuno strumento corrisponde a questo filtro.

Email e thread

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

Etichette e regole di archiviazione automatica

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

Bozze, allegati e identità mittente

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

Template ospitati

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

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

Email in entrata

{
  "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, bounce e soppressioni

{
  "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, utilizzo, analytics e chiavi

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

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

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

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

Inventario della copertura dell'API

Ogni operazione dell'API pubblica e lo strumento che la copre. Tutto ciò che un utente può fare nella dashboard e che ha un'API è coperto; le esclusioni riportate sotto sono intenzionali.

Non disponibile per scelta

Catalogo leggibile dalle macchine: /docs/mcp/tools.json (schemi, annotazioni, mappatura degli endpoint, esclusioni). Versione Markdown di questa pagina: /docs/mcp.md. Con la CLI installata, sendhq commands --format json stampa lo stesso catalogo.