Skip to content
MCP server

MailBots

Let a coding agent read verification codes and test email sent to a catch-all test domain

Install
Pricing
Free trial
Platforms
API, CLI
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About MailBots

MailBots is an MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

This is a hosted, read-only MCP endpoint for MailBots, a receive-only test mail service. The point is closing the loop on signup and login tests: the agent signs up with a fresh address on your test hostname, then pulls the code that arrived without anyone opening an inbox.

It authenticates with a MailBots API key sent as a bearer header, and the key needs messages:read and domains:read scopes. Nothing can be sent, changed or deleted through it. A client can list the tools without a key, but every call needs one.

Mail is kept for 24 hours on the trial and 72 hours on Starter and Pro. The server does not wait for mail, so the agent retries if nothing has arrived yet.

Install

Run in a terminal

claude mcp add --transport http mailbots https://api.mailbots.top/v1/mcp

Add to Settings → Connectors → Add custom connector

https://api.mailbots.top/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mailbots": {
      "url": "https://api.mailbots.top/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mailbots": {
      "type": "http",
      "url": "https://api.mailbots.top/v1/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailbots": {
      "serverUrl": "https://api.mailbots.top/v1/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mailbots": {
      "type": "http",
      "url": "https://api.mailbots.top/v1/mcp"
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_domains
Hostnames the key can receive mail on.
get_latest_otp
Newest message for one address and its extracted code.
list_messages
Recent messages, newest first, optionally for one address.
get_message
One message with its plain-text body.

What it does

Latest code lookup
Returns the newest message for an address with its extracted code, or found false while nothing has arrived.
Message listing
Lists recent messages, newest first, with sender, subject, code and times.
Full message body
Fetches the plain text of one message for magic links the code field misses.
Domain listing
Shows the hostnames the key can receive mail on.
Read-only access
No tool sends, modifies or deletes mail.

Good for

  • Have an agent finish a signup flow that needs an emailed code
  • Test password-reset and magic-link emails in CI
  • Verify transactional email content during development
  • Check which test hostnames an account can receive mail on

Pricing

Free trial, from $10 a month

14-day free trial; Starter $10/month, Pro $15/month

Prices change. Check mailbots.top before you buy.

MailBots FAQ

Can the agent send email?

No. All plans are receive-only and the MCP tools only read.

What does it cost?

A 14-day trial needs no card; Starter is $10 a month and Pro is $15 a month.

How long are messages kept?

24 hours on the trial and 72 hours on Starter and Pro.

How do I connect Claude Code?

Add the HTTP server at https://api.mailbots.top/v1/mcp with an Authorization bearer header carrying your API key.

Is MailBots free?

MailBots is a paid product with a free trial. Paid plans start at $10 a month.

How do I add MailBots to Claude Code?

Run this command in your terminal: claude mcp add --transport http mailbots https://api.mailbots.top/v1/mcp

What are the best alternatives to MailBots?

The closest alternatives to MailBots are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to MailBots

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools