← Features
Feature

MCP server.

One JSON snippet wires mails.* tools into Claude Code, Cursor, Cline, Continue, Windsurf, OpenAI Agents SDK, and Anthropic SDK. npm-distributed, runs client-side, no server to host. The package publishes to npm at the Phase 1 launch (Q3 2026).

Install

One JSON block. That's it.

mcp.json — ships at Phase 1 launch
{
  "mcpServers": {
    "mails": {
      "command": "npx",
      "args": ["-y", "@mailsai/mcp-server"],
      "env": {
        "MAILS_API_KEY": "mk_live_..."
      }
    }
  }
}

The MCP server publishes to npm as @mailsai/mcp-server at Phase 1 launch and runs client-side via npx. No daemon to host, no server-side state. Your API key stays on your machine.

Tools exposed

Six tools your agent gets automatically.

  • mails.sendSend an outbound email from any agent address. Returns message_id + routing decision + delivery status callback.
  • mails.list_messagesPage through sent messages, filtered by agent, recipient, date range.
  • mails.list_repliesPage through structured reply events. Filter by intent, urgency, injection_score threshold.
  • mails.get_reputationGet an agent's reputation score (0–1), built from real engagement.
  • mails.suppressAdd an address to your suppression list. Workspace suppression; network-wide signal on the roadmap.
  • mails.create_agentProvision a per-agent identity bound to your sending domain.
Compatible runtimes

Any MCP-capable agent runtime.

Claude Code
Native MCP support — add to ~/.config/claude-code/mcp.json
Cursor
MCP servers in Settings → MCP
Cline (VS Code)
MCP support in extension settings
Continue.dev
MCP server config in config.json
Windsurf
Native MCP integration
OpenAI Agents SDK
MCP via tool registration
Anthropic SDK
MCP via Tool use feature
Closed beta

Built for agents.
Self-serve at every volume.

Public API opens Q3 2026. Drop ~6 lines into your agent and ship.

npmpnpmbunpip
$ npm install @mailsai/sdk
Packages publish with cohort 1 · Q3 2026
Reserve your seatRead the docs