← Features
Feature

MCP server.

You don't install anything heavy. You add one JSON block. Your agent gets email tools. It works in Claude Code, Cursor, and most other MCP-capable runtimes. No server to host.

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 is live on npm today — npx @mailsai/mcp-server pulls it.

Install

One JSON block. That's it.

mcp.json — live on npm today
{
  "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 and runs client-side via npx. No daemon to host, no server-side state. Your API key stays on your machine.

Tools exposed

20 tools your agent gets automatically.

  • mails.sendSend an email from any agent address. Returns message_id + delivery status callback.
  • mails.list_receivedPage through inbound messages, each with its injection score and sender reputation.
  • mails.list_threadsPage through conversations, grouped by In-Reply-To, with the full message history.
  • mails.get_reputationGet an agent's reputation score (0–1), built from real engagement.
  • mails.check_suppressionCheck whether an address is suppressed before you try to send to it.
  • mails.create_agentProvision a per-agent identity bound to your sending domain.
Compatible runtimes

Any MCP-capable agent runtime.

Claude Code
Native MCP support — `claude mcp add`, or .mcp.json in your project
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
Live now

Built for agents.
Self-serve in minutes.

The API is live and self-serve. Drop ~6 lines into your agent and ship.

npmpnpmbunnpx
$ npm install @mailsai/sdk
Live on npm today · @mailsai/sdk + @mailsai/mcp-server
Get your API keyRead the docs