Agentes IA y MCP

Deja que agentes de IA envien email por MailingCore con el servidor MCP y docs legibles por agentes.

MailingCore esta hecho para que lo manejen agentes de IA. Hay dos vias: el servidor MCP para agentes que llaman herramientas, y docs legibles por maquina para cualquier cosa que lea la web.

Servidor MCP

@mailingcore/mcp-server (v0) expone MailingCore como herramientas de Model Context Protocol sobre stdio. Anadelo a tu cliente MCP (por ejemplo Claude Desktop):

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

La API key vive solo en el proceso del servidor — nunca se pasa como argumento de herramienta. La configuracion es por variables de entorno: MAILINGCORE_API_KEY (requerida), MAILINGCORE_BASE_URL (por defecto https://api.mailingcore.com), MAILINGCORE_TIMEOUT_MS (por defecto 30000).

Herramientas

Herramienta	Que hace	Scope
`send_email`	Envia un email transaccional con HTML directo	`email:send`
`send_template`	Envia una plantilla publicada por slug, rellenando `{{variables}}`	`email:send`
`get_logs`	Lista logs de envio recientes (paginado)	`email:read`
`list_templates`	Lista plantillas para que el agente encuentre los slugs publicados	`templates:read`

Dale al servidor MCP una API key con scope justo para lo que necesita tu agente.

Docs legibles por agentes

Para agentes que leen la web en vez de llamar herramientas:

/llms.txt — un indice compacto de la documentacion para LLMs.
/agents.md — como debe un agente usar MailingCore.
GET /v1/agents/capabilities — un descriptor legible por maquina (auth, scopes, limites, codigos de error, endpoints, webhooks).

Ver API keys y scopes para crear una key con scope.