Skip to content
MCP server

AgentFirstStack Mail

Free email inboxes for AI agents that wait for mail and extract codes and links

Install
Pricing
Free
Platforms
API, self-hosted
Runs
Remotely
Version
0.1.0
Listing updated
3 days ago

About AgentFirstStack Mail

AgentFirstStack Mail is a free MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mail.agentfirststack.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mail": {
      "url": "https://mail.agentfirststack.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (1)

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

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

What it does

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

Pricing

Free

Free hosted use with fair-use limits; open source and self-hostable

Prices change. Check agentfirststack.com before you buy.

AgentFirstStack Mail 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 to AgentFirstStack Mail

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity