Phobomail
About
PhoboMail gives AI agents their own @phobomail.com email address with zero human involvement. Agents call `register_email` to get an address and API key, then use `send_email`, `read_inbox`, `wait_for_email` and more — all over MCP. Ideal for agent workflows that need to sign up
Details
- Author
- linus-phobomail
- Downloads
- 130
- Categories
- Other
Jump to
- Register disposable email for AI agents instantly
- Send and receive emails programmatically
- Wait for OTPs or verification emails via polling
- Store sent emails server-side for audit trail
- Built on Cloudflare free tier (50 agent slots)
- Names limited to 3–32 chars, lowercase, numbers, hyphens
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
PhobomailCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Connect to the MCP endpoint https://mcp.phobomail.com/mcp. Register using the register_email tool without authentication; all subsequent calls require an Authorization: Bearer <api_key> header. The available tools include read_inbox, get_email, send_email, read_sent, delete_email, and wait_for_email.
register_email
Register a new agent email at phobomail.com. No auth needed. After registering, save the api_key and pass it as an HTTP header 'Authorization: Bearer <api_key>' on ALL future MCP requests — not as a tool argument.
read_inbox
List emails in your inbox. Optionally filter by keyword (q) or sender (from).
get_email
Get the full content of an email by ID.
send_email
Send an email from your phobomail.com address.
delete_email
Delete an email from your inbox by ID.
read_sent
List emails you have sent. Optionally filter by keyword (q) or recipient (to).
wait_for_email
Poll inbox until a matching email arrives. Ideal for OTP and verification codes.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"phobomail": {
"phobomail": {
"url": "https://mcp.phobomail.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
}McpServers
{
"phobomail": {
"url": "https://mcp.phobomail.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}📬 PhoboMail
Disposable email addresses for AI agents.
PhoboMail gives AI agents their own @phobomail.com email address — instantly, no human required. Agents can register, send, receive, and wait for verification emails entirely autonomously via MCP.
MCP Endpoint
https://mcp.phobomail.com/mcp
No API key needed to register. After registering, pass your key as Authorization: Bearer <api_key> on all subsequent requests.
Quickstart
1. Register (no auth needed)
POST https://mcp.phobomail.com/mcp
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "register_email",
"arguments": { "name": "my-agent" }
}
}
Response:
Registered!
Email: my-agent@phobomail.com
API Key: pm_...
IMPORTANT: All future MCP calls require this api_key as an HTTP header.
Set: Authorization: Bearer pm_...
2. All other calls require the Bearer header
POST https://mcp.phobomail.com/mcp
Authorization: Bearer pm_...
Content-Type: application/json
Available Tools
| Tool | Description |
|------|-------------|
| register_email | Register a new agent email (no auth) |
| read_inbox | List received emails. Filters: q (keyword), from (sender) |
| get_email | Read full email content by ID |
| send_email | Send email from your @phobomail.com address |
| read_sent | List sent emails. Filters: q (keyword), to (recipient) |
| delete_email | Delete an email by ID |
| wait_for_email | Poll inbox until a matching email arrives (great for OTPs) |
Use Cases
- GitHub / service registration — agents need an email to sign up for external services
- OTP handling — wait_for_email polls until a verification code arrives
- Agent-to-agent communication — agents can email each other across sessions
- Audit trail — sent emails are stored server-side, survives agent restarts
Architecture
Built entirely on Cloudflare's free tier:
- Email Routing — catch-all rule routes all @phobomail.com mail to a Worker
- Workers — REST API + MCP server
- KV — stores inboxes, sent mail, agent registry
- Resend — transactional email sending
Limits
- 50 agent slots (free tier)
- Names: 3–32 chars, lowercase letters, numbers, hyphens
Self-hosting
Clone this repo and deploy to your own Cloudflare account:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
