1つのツールコールで任意のAIエージェントに使い捨てのメール受信トレイを与えます。

インストール

インタラクティブなインストーラーは、AI コーディングエージェント (Claude Code, Codex CLI, Cursor, Gemini CLI, Windsurf) を自動検出し、MCP サーバーを構成し、それぞれにオプションのスキルをインストールします。

MCP クライアント(非 TTY)で起動すると、MCP サーバーが正常に起動します。 ターミナルから実行するとインストーラが取得されます。

それが何をするか

要求に応じて、リアルタイムのメールアドレスを作成するMCPサーバー。 エージェントは、サービスにサインアップしたり、確認メールを受信したり、検証リンクを抽出したり、指を持ち上げることなくクリーンアップしたりすることができます。

APIキーはありません。 アカウントはありません。 構成無し。 Supabase、Resend、SendGrid、Postmark、AWS SESなどのメール送信サービスと連携。

問題

サービスが電子メールの検証を必要とするときにAIエージェントが壁に当たる. サインアップフォームを記入できますが、確認メールを受信できません。 そこで、止まって、それをやろうと聞いてください。

修正

手動設定

インストーラを使用する代わりに手動で設定したい場合:

##Claudeコード

または [~/.claude/settings.json に追加します。

###Codex CLIのコード

[~/.codex/config.tomlに追加します。

カーソル

`~/.cursor/mcp に追加します.

agent-inbox

Give any AI agent a disposable email inbox in one tool call.

Install

npx gsd-agent-inbox

The interactive installer auto-detects your AI coding agents (Claude Code, Codex CLI, Cursor, Gemini CLI, Windsurf), configures the MCP server, and installs the optional skill for each.

When launched by an MCP client (non-TTY), it starts the MCP server normally. When you run it from a terminal, you get the installer.

What it does

An MCP server that creates real, temporary email addresses on demand. Your agent can sign up for services, receive confirmation emails, extract verification links, and clean up — without you lifting a finger.

No API keys. No accounts. No configuration. Works with any email-sending service — Supabase, Resend, SendGrid, Postmark, AWS SES, whatever.

The problem

AI agents hit a wall when a service requires email verification. They can fill out a sign-up form, but they can’t receive the confirmation email. So they stop and ask you to do it.

The fix

Agent: create_inbox({ prefix: "signup", name: "test" })
→ [email protected] (name: test)

Agent: [fills sign-up form with that email]

Agent: verify_email({ address: "test", subject_contains: "confirm" })
→ Email verified successfully!
  Verification URL: https://myapp.supabase.co/auth/v1/verify?token=abc123
  HTTP Status: 200

Agent: delete_inbox({ address: "test" })
→ Done.

Manual setup

If you prefer to configure manually instead of using the installer:

Claude Code

claude mcp add agent-inbox -- npx -y gsd-agent-inbox

Or add to ~/.claude/settings.json:

{
  "mcpServers": {
    "agent-inbox": {
      "command": "npx",
      "args": ["-y", "gsd-agent-inbox"]
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.agent-inbox]
command = "npx"
args = ["-y", "gsd-agent-inbox"]
env = { }

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agent-inbox": {
      "command": "npx",
      "args": ["-y", "gsd-agent-inbox"]
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "agent-inbox": {
      "command": "npx",
      "args": ["-y", "gsd-agent-inbox"]
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "agent-inbox": {
      "command": "npx",
      "args": ["-y", "gsd-agent-inbox"]
    }
  }
}

Any other MCP client

Any client that supports stdio transport:

{
  "command": "npx",
  "args": ["-y", "gsd-agent-inbox"]
}

Build from source

git clone https://github.com/gsd-build/agent-inbox.git
cd agent-inbox
npm install
npm run build
npm start

Tools