← Back to docs

MCP Server for AI Agents

Let AI assistants send and manage email through EuroMail using the Model Context Protocol server.

Overview

The EuroMail MCP server exposes the API as Model Context Protocol tools, so an AI assistant. Claude Desktop, an IDE agent, or your own LLM application. Can send email, check delivery status, manage domains, and more by calling tools directly, with no glue code from you.

Package: @euromail/mcp-server on npm

Adding it to an MCP client

The server runs over stdio via npx. Add it to your client's MCP configuration with your API key in the environment.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "euromail": {
      "command": "npx",
      "args": ["@euromail/mcp-server"],
      "env": {
        "EUROMAIL_API_KEY": "em_live_your_key_here"
      }
    }
  }
}

The same command / args / env block works in any MCP-compatible client (Claude Code, Cursor, and others). Restart the client and the EuroMail tools become available to the assistant.

What the assistant can do

Through the MCP tools, an agent can carry out the same operations this documentation covers, for example: send a transactional email, look up the status of a previous send, list and verify sending domains, manage templates, validate an address, and check suppression status. The package README lists the exact tool set and parameters.

Because the tools are backed by your API key, the assistant operates within your account's plan and quota and every send is subject to the same domain verification and suppression rules as any other request.

Discoverability endpoints

EuroMail is also natively discoverable by agents that crawl rather than use MCP. The API serves machine-readable descriptors so an assistant can learn the service on its own:

Endpoint	Purpose
`https://euromail.dev/llms.txt`	Concise product overview (llmstxt.org)
`https://api.euromail.dev/llms-full.txt`	Full API summary for LLMs
`https://api.euromail.dev/.well-known/ai-plugin.json`	AI plugin manifest
`https://api.euromail.dev/.well-known/agent-card.json`	Agent card

Security notes

Give agents a dedicated API key so you can revoke their access independently. See API Keys.
Treat the key as a secret in the MCP config; do not commit the config with the key inlined.
For agents that need to receive mail (not just send), see Agent Mailboxes, which adds a lease/ack/nack inbox built for autonomous workers.

Send your first email in about 90 seconds

The free tier includes 1,000 emails a month. All data stays in Finland | GDPR compliance without the paperwork.

Create free account See live delivery data