mailsai
  • Overview
  • Threads
  • Eventslive
Send
  • Agents
  • Messages
  • Drafts
  • Suppression
Wire
  • API keys
  • Webhooks
  • Domains
  • MCP server
Account
  • Audit log
  • Billing
  • Settings
  • Docs
M
Account
not signed in

MCP server

17 tools · drop-in for Claude, Cursor, Windsurf

Add mails.ai to your agent runtime

@mailsai/mcp-server exposes the full mails.ai surface to any MCP-compatible client. Configure with an API key from your workspace and the agent can send, reply, manage drafts, read threads, and check reputation.

Claude Desktop / Cursor / Windsurf config
→ mint an API key
{
  "mcpServers": {
    "mails": {
      "command": "npx",
      "args": ["-y", "@mailsai/mcp-server"],
      "env": { "MAILS_API_KEY": "mk_live_…" }
    }
  }
}
Workspace: empty.mails.ai · tier free
Compose5
mails.send
Send an email from an agent.
mails.reply
Reply to a received message. Sets headers + Re: subject server-side.
mails.forward
Forward a message to new recipients.
mails.create_draft
Stage a draft, optionally scheduled.
mails.send_draft
Send a draft now or schedule.
Read7
mails.list_threads
List threads in workspace or per agent.
mails.get_thread
Get a thread with all messages in order.
mails.list_received
Recent inbound messages.
mails.get_received
One inbound message including extracted reply text.
mails.list_replies
Recent reply.received events for an agent.
mails.list_messages
Recent message.received (cold/first-contact inbound) for an agent.
mails.get_event
Get an inbound event by id.
Manage6
mails.list_agents
List agents.
mails.create_agent
Create a new agent identity at <name>@workspace.mails.ai.
mails.get_reputation
Get an agent's reputation score (0-1).
mails.check_suppression
Check if an address is suppressed.
mails.allowlist_address
Override suppression with a prior-relationship attestation.
mails.get_usage
Current billing-period usage and tier caps.