AgentTemp

MCP (Model Context Protocol) server configuration for AgentInbox - Email verification infrastructure for AI agents.

What is MCP?

Model Context Protocol (MCP) allows AI agents (Claude, Cursor, Windsurf, etc.) to directly interact with AgentInbox's API through structured tools.

Quick Setup

1. Get API Key

Create an API key from the AgentInbox Dashboard (set AGENTINBOX_API_KEY or pass --api-key).

The MCP endpoint expects the same API key format as the REST API:

Authorization: Bearer at_live_...

2. Add to Your MCP Client

Claude Desktop:

{
  "mcpServers": {
    "agentinbox": {
      "url": "https://agentinbox.in/api/mcp",
      "headers": {
        "Authorization": "Bearer at_live_..."
      }
    }
  }
}

Cursor: Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agentinbox": {
      "url": "https://agentinbox.in/api/mcp",
      "headers": {
        "Authorization": "Bearer at_live_..."
      }
    }
  }
}

Opencode:

{
  "mcp": {
    "agentinbox": {
      "type": "remote",
      "url": "https://agentinbox.in/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:AGENTINBOX_API_KEY}"
      }
    }
  }
}

Windsurf: Add to your Cascade configuration.

3. Available Tools

Tool	Description
create_inbox	Create a temporary email inbox
list_inboxes	List all your inboxes
get_inbox	Get inbox details
delete_inbox	Delete an inbox
list_messages	List messages in an inbox
get_message	Get a specific message
list_extractions	List OTP/link extractions
wait_for_email	Wait for any email
wait_for_otp	Wait for OTP extraction
wait_for_magic_link	Wait for magic link
wait_for_password_reset	Wait for password reset link
check_wait	Check wait status (non-blocking)

Responses use the public AgentInbox API schema, including camelCase fields such as emailAddress, expiresAt, inboxId, and timeoutSeconds.

Example Usage

// Agent will use these tools automatically
// Just ask: "Create a temp email and wait for the OTP"

// Behind the scenes:
const inbox = await create_inbox({ ttlSeconds: 3600 });
const wait = await wait_for_otp({ inboxId: inbox.id, timeoutSeconds: 120 });
console.log(wait.result?.value); // "123456"

Resources

• Node.js SDK: https://github.com/agentinbox-in/agentinbox-node
• Python SDK: https://github.com/agentinbox-in/agentinbox-python
• CLI Tool: https://github.com/agentinbox-in/agentinbox-cli
• API Docs: https://agentinbox.in/api/v1/openapi.json

License

MIT