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_contactsupsert_contactlist_tagscreate_tagupdate_tagdelete_tagtag_contactslist_listscreate_listupdate_listdelete_listadd_contacts_to_listremove_contacts_from_listlist_segmentscreate_segmentestimate_segmentcreate_custom_field
Template
list_templatesget_templatecreate_templateupdate_template
Invio
send_emailsend_messagelist_campaignsget_campaignget_campaign_metricscreate_campaignupdate_campaignestimate_campaignsend_campaign
Allegati e immagini
upload_attachmentlist_attachmentsdelete_attachmentupload_imagelist_images
Automazioni
list_automationsget_automationcreate_automationupdate_automationactivate_automationenroll_contactstest_automationget_automation_logget_automation_stats
Agent Email
list_inboxescreate_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
Import
connect_activecampaignstart_activecampaign_importget_import_status

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": "[email protected]", "from": "[email protected]",
  "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.