list_domains
List receiving hostnames
List the hostnames this API key can receive mail on, with their status. Any address at an active hostname reaches the inbox.
Takes no parameters.
MailBots
top.mailbotsPublished by mailbots.topOfficial publisherv1.0.0Updated Nov 7, 2026
Read verification codes (OTP) and test email sent to your catch-all test hostnames.
Overview
AI-generated overview
MailBots lets an assistant read email sent to catch-all test hostnames and pull out verification codes (OTP) for end-to-end tests.
- What you can do
- List the hostnames the API key can receive mail on, with their status
- List recent messages newest first, optionally filtered to one address, with metadata and extracted OTP
- Fetch a single message by id, including its plain-text body
- Return the newest message for an address together with its verification code
- When to use it
- Useful when testing signup, login or password-reset flows that send email: give each test run a fresh address on a catch-all hostname, then have the assistant fetch the OTP or message body instead of checking a mailbox by hand.
- Requirements
- A remote MCP endpoint; no local package. A MailBots API key from a trial or paid plan, sent as an Authorization bearer header. At least one catch-all hostname configured on the account.
Before you install
The API key is a secret sent in the Authorization header and grants access to the account's inbox. The assistant can read full message bodies, which may contain personal data. Only test applications you own or are authorized to test.
Installation
In SourceWeft
- Open MailBots in the dashboard and add it to a workspace.
- Connect Authorization token credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/top.mailbots%2Fmailbots/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config.
{
"mcpServers": {
"mailbots": {
"type": "http",
"url": "https://api.mailbots.top/v1/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}Tools
4get_latest_otp
Get the latest verification code
Return the newest message sent to an address and the verification code (OTP) extracted from it. Returns found=false when nothing has arrived yet; wait a few seconds and retry.
Parameters
torequiredsincelist_messages
List recent messages
List recent messages, newest first, optionally only those sent to one address. Returns metadata and the OTP, not the body.
Parameters
tolimitget_message
Read one message
Return one message by id, including its plain-text body (truncated to 20,000 characters).
Parameters
idrequiredVersion history
1- v1.0.0LatestNov 7, 2026
Score
83% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listedRequired15 pts
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
- LicenseNot applicable
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.