MCP Server

The AgentInbox MCP (Model Context Protocol) server exposes 12 tools, enabling AI agents to create inboxes, wait for emails, and extract data directly.

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how AI agents connect to external tools and data sources. AgentInbox implements MCP so Claude, Cursor, and other agents can use it natively.

Available Tools

The MCP server provides 12 tools for AI agents to interact with AgentInbox.

create_inbox

Create a temporary email inbox with optional TTL and metadata.

list_inboxes

List all inboxes in your account with pagination.

get_inbox

Retrieve details of a specific inbox by ID.

delete_inbox

Delete an inbox and all its messages immediately.

list_messages

List messages in an inbox, newest first.

get_message

Read a specific message including body and headers.

create_wait

Block until an expected email arrives or timeout.

cancel_wait

Cancel an active wait before it completes.

create_extraction

Extract structured data from a received message.

create_session

Start a new session to track a workflow.

get_session

Retrieve session details and timeline.

create_workflow

Run a pre-built workflow like create-inbox-and-wait.

Setup for Claude

Add the MCP server to Claude Desktop using the configuration file.

claude_desktop_config.json

{
  "mcpServers": {
    "AgentInbox": {
      "command": "npx",
      "args": ["-y", "@AgentInbox/mcp-server"],
      "env": {
        "AgentInbox_API_KEY": "at_live_..."
      }
    }
  }
}

Claude Desktop

Restart Claude Desktop after editing the config file for changes to take effect.

Setup for Cursor

Configure the MCP server in Cursor settings.

Cursor Settings

Settings > MCP > Add Server
Name: AgentInbox
Command: npx -y @AgentInbox/mcp-server
Environment: AgentInbox_API_KEY=at_live_...

Setup for Windsurf

Configure the MCP server in Windsurf's cascade settings.

Windsurf Config

Cascade > MCP > Add Server
Name: AgentInbox
Type: stdio
Command: npx -y @AgentInbox/mcp-server
Env: AgentInbox_API_KEY=at_live_...

Example Conversation

With the MCP server connected, your AI agent can use AgentInbox directly through natural language.

User:

Create a temporary inbox and wait for an OTP from Stripe.

Agent:

I'll create an inbox and wait for the OTP. One moment...

(Calls create_inbox, then create_wait with type="otp")

Done! The OTP is 482931.

Next Steps

Node.js SDK

Programmatic API access

Learn more

Python SDK

Python API client

Learn more

CLI Tool

Command-line interface

Learn more

Inboxes

Core concept documentation

Learn more