Agenti IA e MCP

Fai inviare email agli agenti IA tramite MailingCore con il server MCP e docs leggibili dagli agenti.

MailingCore e pensato per essere guidato da agenti IA. Ci sono due vie: il server MCP per gli agenti che chiamano strumenti, e docs leggibili dalla macchina per tutto cio che legge il web.

Server MCP

@mailingcore/mcp-server (v0) espone MailingCore come strumenti Model Context Protocol su stdio. Aggiungilo al tuo client MCP (per esempio Claude Desktop):

{
  "mcpServers": {
    "mailingcore": {
      "command": "npx",
      "args": ["-y", "@mailingcore/mcp-server"],
      "env": { "MAILINGCORE_API_KEY": "mc_live_xxx" }
    }
  }
}

L'API key vive solo nel processo del server — non viene mai passata come argomento di uno strumento. La configurazione avviene tramite variabili d'ambiente: MAILINGCORE_API_KEY (obbligatoria), MAILINGCORE_BASE_URL (predefinito https://api.mailingcore.com), MAILINGCORE_TIMEOUT_MS (predefinito 30000).

Strumenti

Strumento	Cosa fa	Scope
`send_email`	Invia un'email transazionale con HTML diretto	`email:send`
`send_template`	Invia un template pubblicato per slug, riempiendo `{{variables}}`	`email:send`
`get_logs`	Elenca i log di invio recenti (paginato)	`email:read`
`list_templates`	Elenca i template cosi che l'agente trovi gli slug pubblicati	`templates:read`

Dai al server MCP una API key con scope limitato a cio che serve al tuo agente.

Docs leggibili dagli agenti

Per gli agenti che leggono il web invece di chiamare strumenti:

/llms.txt — un indice compatto della documentazione per gli LLM.
/agents.md — come un agente dovrebbe usare MailingCore.
GET /v1/agents/capabilities — un descrittore leggibile dalla macchina (auth, scope, limiti, codici di errore, endpoint, webhook).

Vedi API key e scope per creare una key con scope.