Glossary·Distribution

MCP server

Mails.ai's drop-in Model Context Protocol server. Distributed via npm as @mailsai/mcp-server. Exposes five tools (send, on_reply, list_threads, suppress, get_reputation) to MCP-capable runtimes — Claude Code, Cursor, Cline, Continue, Windsurf.

The Mails.ai MCP serveris a Model Context Protocol server that exposes Mails.ai’s API as auto-discovered tools to MCP-capable agent runtimes. Distributed via npm as @mailsai/mcp-server. Runs client-side via npx— no infrastructure to host on your end.

The five tools

mails.send— send an email from a named agent. Returns send id + pool routing decision.
mails.on_reply— register a webhook URL for structured reply events.
mails.list_threads— query the agent’s conversation history.
mails.suppress— add (or remove) an address from the agent’s suppression list.
mails.get_reputation— get an agent’s reputation score (0–1), built from real engagement. Designed to propagate across the network as the cohort grows.

Setup

One config block in any MCP-capable runtime’s settings file:

{
  "mcpServers": {
    "mails": {
      "command": "npx",
      "args": ["-y", "@mailsai/mcp-server"],
      "env": { "MAILS_API_KEY": "mk_live_..." }
    }
  }
}