Panoramica MCP

Endpoint MCP, autenticazione e tool disponibili.

Sending espone un endpoint MCP (Model Context Protocol) su https://sending.dev/api/mcp (streamable HTTP). Gli agenti si autenticano con la stessa API key bearer, oppure con OAuth 2.1 per conto di un utente, e operano entro guardrail server-side: cap di volume e spesa giornaliero, audit log e scope per chiave.

Il server è remoto: non c'è niente da installare. Per i comandi e i file di configurazione dei singoli client (Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code, Cline, Windsurf) vedi Installare Sending nel tuo agente.

Tool disponibili

Domini e usage

list_domainsverify_domainset_domain_sender_nameget_usageset_frequency_cap

CRM

list_contactsget_contactupsert_contactdelete_contactlist_tagscreate_tagupdate_tagdelete_tagtag_contactslist_listscreate_listupdate_listdelete_listadd_contacts_to_listremove_contacts_from_listlist_segmentscreate_segmentupdate_segmentdelete_segmentestimate_segmentcreate_custom_field

Template

list_templatesget_templatecreate_templateupdate_templatedelete_template

Invio

send_emailsend_messageget_emaillist_emailslist_campaignsget_campaignget_campaign_metricsexport_campaign_analysiscreate_campaignupdate_campaignestimate_campaignsend_campaign

Allegati e immagini

upload_attachmentlist_attachmentsdelete_attachmentupload_imagelist_images

Eventi e automazioni

track_eventlist_automationsget_automationcreate_automationupdate_automationactivate_automationenroll_contactstest_automationrestart_enrollmentsget_automation_logget_automation_statsexport_automation_analysis

Agent Email

list_inboxescreate_inboxdelete_inboxlist_threadsget_threadsend_from_inboxreply_threadget_agent_email_metrics

Webhooks e regole

list_webhookscreate_webhookdelete_webhooklist_email_rulescreate_email_ruledelete_email_rule

Attribuzione

get_utm_summarylist_utm_toucheslist_utm_conversionsget_contact_conversionsget_contact_journeyget_conversion_stats

E-commerce

list_ordersget_contact_commerce

Import

connect_activecampaignstart_activecampaign_importget_import_status

Una connessione vede solo i tool che i suoi permessi le consentono: una API key con il solo email:send elenca i tool di invio e dello storico email, non quelli di automazioni o contatti. Con OAuth i permessi sono quelli scelti nella schermata di consenso, e si cambiano poi da Impostazioni › Connessioni MCP senza riconnettere. Se un agente dice che un tool non esiste, quasi sempre la funzione c'è ma non è stata concessa.

Allegati

I tool di invio (send_email, send_message, send_from_inbox, reply_thread, create_campaign) accettano attachments: per elemento indica una sorgente, { id }, { filename, content } (base64) oppure { filename, url }. Con file non minuscoli conviene upload_attachment una volta sola e poi riusare l'id: il base64 inline gonfia il contesto dell'agente a ogni chiamata.

{ "name": "send_email", "arguments": {
  "to": "sara@acme.io", "from": "ciao@tuodominio.dev",
  "subject": "La tua fattura", "html": "<p>In allegato.</p>",
  "attachments": [{ "id": "<ATTACHMENT_ID>" }]
} }

Limiti e regole (max 20 allegati, 10 MB l'uno, 25 MB complessivi, estensioni eseguibili rifiutate) sono gli stessi dell'API REST: vedi Allegati.

Allow / Block

Installare Sending nel tuo agente