# AgentFirstStack Mail

> AgentFirstStack Mail is a free MCP server for communication. Free email inboxes for AI agents that wait for mail and extract codes and links. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, self-hosted
- **Website:** https://agentfirststack.com/mcp
- **Repository:** https://github.com/startglobal-ai/agentfirststack
- **MCP Registry name:** com.agentfirststack/mail
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

The main tool, wait_for_email, returns the moment a message arrives with verification codes and links already pulled out, so an agent can finish a signup flow without a person reading an inbox. Inboxes are created in one request on agentfirstinbox.com or your own domain, and the Mail service also reads, replies, sends, forwards to a project's people (each email or a daily digest), and supports custom domains and webhooks.

Mail is one of four AgentFirstStack services, alongside analytics, tags and session replay, all sharing one API key from a single POST /v1/signup call with no signup form or verification email. The README describes a hosted free version with fair-use limits and an open-source self-hosted option on Cloudflare Workers.

When the agent has finished, it hands its person a claim link to sign in with Google, see the project in a dashboard and manage keys.

## Features

- **Wait for mail:** wait_for_email returns when a message arrives.
- **Codes and links extracted:** Verification codes and links come back parsed.
- **Reply and send:** Agents can read, reply and send.
- **Custom domains:** Use agentfirstinbox.com or your own domain.
- **Webhooks and forwarding:** Forward mail to people or push events to webhooks.
- **Self-hostable:** Runs on Cloudflare Workers in your account.

## Good for

- Let an agent sign up to a service and read the confirmation
- Receive a verification code in a test run
- Give each project its own inbox
- Forward agent mail to a teammate as a digest

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mail https://mail.agentfirststack.com/mcp
```

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

```sh
https://mail.agentfirststack.com/mcp
```

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

```json
{
  "mcpServers": {
    "mail": {
      "url": "https://mail.agentfirststack.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mail": {
      "type": "http",
      "url": "https://mail.agentfirststack.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mail": {
      "serverUrl": "https://mail.agentfirststack.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mail": {
      "type": "http",
      "url": "https://mail.agentfirststack.com/mcp"
    }
  }
}
```

## Tools

- `wait_for_email`: Wait for a message and return it with codes and links extracted

## FAQ

### Is it free?

The README says hosted use is free with fair-use limits, and it is open source.

### How do I get a key?

POST /v1/signup returns a key that works across every service.

### Can I use my own domain?

Yes, custom domains are supported.

### Can a human take over?

Yes, via a claim link that opens a dashboard after Google sign-in.

### Is AgentFirstStack Mail free?

Yes. AgentFirstStack Mail is free to use.

### How do I add AgentFirstStack Mail to Claude Code?

Run this command in your terminal: claude mcp add --transport http mail https://mail.agentfirststack.com/mcp

### What are the best alternatives to AgentFirstStack Mail?

The closest alternatives to AgentFirstStack Mail are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/agentfirststack-mail
