AgentFirstStack Mail

com.agentfirststackPublished by agentfirststack.comOfficial publisherv0.1.0Updated Nov 4, 2026

Email inboxes for AI agents: wait for mail, pull out verification codes and links, reply. Free.

The publisher's own server: AgentFirstStack Analytics

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Remote MCP server that gives an AI agent its own email inboxes: wait for mail, extract verification codes and links, read, reply and send.

What you can do
  • Create and manage inboxes in a single request, including custom domains and webhooks.
  • Wait for incoming mail and return the message as soon as it arrives, with verification codes and links already extracted.
  • Read messages, reply to them and send new mail from an agent-owned address.
  • Part of a wider platform whose other services (analytics, tag management, session replay) are exposed as separate MCP servers with prefixed tools.
When to use it
Useful when an agent has to sign up for services, complete email verification, or receive and answer mail on its own without a human-owned Gmail account. Suited to automated onboarding and testing flows that depend on verification codes or links.
Requirements
Remote streamable HTTP endpoint at mail.agentfirststack.com (or the combined agentfirststack.com/mcp). Authentication is required: an OAuth flow, or an API key obtained from a single signup request, sent as an Authorization bearer header. Network access to the service; the hosted tier has fair-use limits.
Before you install
The Authorization bearer key grants access to the account's inboxes and other services, so treat it as a secret. The agent can send and reply to email and register custom domains, which are outward-facing actions. Mail content and account data are stored by the hosted third-party service; self-hosting on your own Cloudflare account is the alternative.

Installation

In SourceWeft

  1. Open AgentFirstStack Mail in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. 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/com.agentfirststack%2Fmail/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.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

[Image]

AgentFirstStack

Analytics, tag management, email inboxes and session replay that an AI agent sets up by itself.
No signup form, no verification email, no dashboard to click through. Free to use, and open source.

agentfirststack.com · Manual · Self-host · Architecture

[CI] [MIT license]

Every new website needs the same infrastructure: analytics, a tag manager with conversion tracking, and an email address to sign up for everything else. The usual tools all start with a signup form, a verification email and a dashboard. Coding agents can't get past those steps alone.

AgentFirstStack is that infrastructure, rebuilt so an agent can do the whole job:

  • One request gets an account. POST /v1/signup returns a key that works on every service.
  • Everything is an API call and an MCP tool. Nothing is hidden behind a settings page.
  • The manual is a text file. Each service serves /llms.txt with every endpoint, tool and field.
  • Every step can be verified. The agent checks its own work instead of guessing.
  • Humans optional. When it's done, the agent hands its person a claim link. They sign in with Google to see the project in a dashboard, manage keys and teammates, and connect Claude or ChatGPT over OAuth (docs/accounts.md).

Services

What it doesInstead of
AnalyticsCookieless web analytics. Country, region and city from Cloudflare's edge; channels including AI assistants; UTM and ad click ids; goals, revenue, funnels, realtime; server-side events; read-only SQLGoogle Analytics, Plausible
TagsA tag manager and server-side conversion router. Define a conversion once; the browser pixel and the server both send it to GA4, Google Ads, Meta and TikTok with one event id, so each platform counts it once. Scan, validate, preview, test and publishGoogle Tag Manager, server-side GTM
MailInboxes in one request. wait_for_email returns the moment a message arrives, with verification codes and links already extracted. Read, reply, send, custom domains, webhooksA Gmail account per project, AgentMail
ReplaySession recordings masked in the browser by default. Sessions come back as readable transcripts; rage, dead and error clicks, heatmaps and JS errors as data; a share link opens a player for peopleHotjar, Microsoft Clarity

Quick start

Hosted (free)

Copy the prompt from agentfirststack.com into Claude Code, Cursor, Codex or any agent that can make HTTP requests. Or do it by hand:

sh
curl -X POST https://agentfirststack.com/v1/signup# { "api_key": "afs_...", "mcp": { ... }, "next_steps": [ ... ] }
curl -X POST https://analytics.agentfirststack.com/v1/sites \  -H "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY" -H 'content-type: application/json' \  -d '{"domain":"example.com"}'

Add one MCP server for every service (tools prefixed analytics_, tags_, mail_, replay_):

sh
claude mcp add --transport http afs https://agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"

Or one per service:

sh
claude mcp add --transport http afs-analytics https://analytics.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"claude mcp add --transport http afs-tags https://tags.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"claude mcp add --transport http afs-mail https://mail.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"claude mcp add --transport http afs-replay https://replay.agentfirststack.com/mcp --header "Authorization: Bearer $AGENTFIRSTSTACK_API_KEY"

The hosted version has fair-use limits, listed in the manual.

Self-hosted

Everything runs on Cloudflare Workers in your own account:

sh
git clone https://github.com/StartGlobal-AI/agentfirststack && cd agentfirststackpnpm installpnpm afs init mystack --domain example.com --account <cloudflare-account-id>pnpm afs deploy mystackCLOUDFLARE_API_TOKEN=... pnpm afs email mystack     # inbound + outbound mailpnpm afs check mystack

See docs/self-hosting.md for requirements, signup modes, limits and updates.

How it's built

TypeScript on Cloudflare Workers with Hono and zod. Storage:

  • D1: configuration and the shared identity database.
  • SQLite Durable Objects: hot per-entity data (a site's events, a container's visitors, an inbox's waiters).
  • R2: mail blobs and replay recording chunks.
  • Queues: retried delivery to ad platforms and webhooks.
  • Email Routing and Email Sending: mail in and out.
site/        landing page, platform manual, platform signup      agentfirststack.comanalytics/   web analytics                                        analytics.agentfirststack.comtags/        tag manager + conversion APIs                        tags.agentfirststack.commail/        inboxes, sending, domains, webhooks                  mail.agentfirststack.comreplay/      session replay, signals, heatmaps, share player          replay.agentfirststack.comshared/      @afs/shared: auth, signup, errors, MCP handlerscripts/     pnpm afs: the deployment tooldeploy/      deployment profiles (yours; the agentfirststack.com one is kept private)docs/        architecture, self-hosting, operations, development

More in docs/architecture.md.

Development

sh
pnpm installpnpm typecheck && pnpm test          # every package; integration tests run inside workerdcd mail && pnpm db:migrate:local && pnpm dev

docs/development.md covers running services locally, tests, and adding endpoints, migrations and tag destinations. docs/operations.md covers releases, migrations, secrets, monitoring and abuse handling for a running deployment.

Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md first; it's short. Report security issues privately as described in SECURITY.md.

License

MIT. Built and hosted by StartGlobal.

Source: README.md at commit 678e2eb

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.0LatestNov 4, 2026

Score

85% 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 listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Agentfirststack integrations

AgentFirstStack Analytics

com.agentfirststackOfficial publisher

Remote MCP server for cookieless web analytics that an AI agent can create and query: sites, goals, funnels, revenue and read-only SQL.

Streamable HTTPWeb executableAuth
Web Search & ScrapingCredential requiredNov 4, 2026

AgentFirstStack Tags

com.agentfirststackOfficial publisher

Remote tag manager and server-side conversion router that lets an assistant set up GA4, Google Ads, Meta and TikTok conversion tracking.

Streamable HTTPWeb executableAuth
Data & AnalyticsCredential requiredNov 4, 2026

AgentFirstStack Replay

com.agentfirststackOfficial publisher

Remote MCP server for AgentFirstStack Replay, giving an assistant session recordings as readable transcripts, click and JS error signals, and heatmaps.

Streamable HTTPWeb executableAuth
Developer ToolsCredential requiredNov 4, 2026

AgentFirstStack

com.agentfirststackOfficial publisher

Remote MCP server giving an agent self-serve web analytics, a tag manager with conversion routing, email inboxes and session replay for a website.

Streamable HTTPWeb executableAuth
Communication & CollaborationCredential requiredNov 4, 2026