# MailBots

> MailBots is an MCP server for developer tools. Let a coding agent read verification codes and test email sent to a catch-all test domain. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $10 a month
- **Platforms:** API, CLI
- **Website:** https://mailbots.top/docs/mcp
- **MCP Registry name:** top.mailbots/mailbots
- **Categories:** developer tools, communication
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.mailbots.top/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mailbots": {
      "url": "https://api.mailbots.top/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mailbots
