MCP Integration

Model Context Protocol (MCP) Server

Create an inbox key in API Keys, then add it as a Bearer token in your MCP client configuration.

This page is the setup guide. Your MCP client connects to https://beta.inboxagents.net/mcp/rpc using the Authorization header; opening the API directly in a browser does not send that header.

Cursor IDE Config.cursor/mcp.json

Add this to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "open-agent-email": {
      "url": "https://beta.inboxagents.net/mcp/rpc",
      "headers": {
        "Authorization": "Bearer PASTE_AGENT_API_KEY"
      }
    }
  }
}
Claude Code CLITerminal command

Run this in your terminal to register the tools:

claude mcp add --transport http open-agent-email https://beta.inboxagents.net/mcp/rpc --header "Authorization: Bearer PASTE_AGENT_API_KEY"

Tool Examples (9)

MCP over HTTP
list_agentsTool

Lists all configured AI agent email addresses and statuses.

{}
list_messagesTool

Fetches recent emails received or sent by an agent inbox.

{"agent_email": "[email protected]", "status": "delivered"}
get_messageTool

Reads full email body, RFC headers, and SPF/DKIM verification tags.

{"agent_email": "[email protected]", "message_id": "msg_..."}
send_messageTool

Dispatches a new outbound email from the agent's verified address.

{"agent_email": "[email protected]", "recipient": "[email protected]", "subject": "Hello", "body_text": "..."}
reply_to_messageTool

Replies in-thread to an existing email, preserving RFC Message-ID and In-Reply-To.

{"agent_email": "[email protected]", "message_id": "msg_...", "body_text": "Got it!"}
forward_to_humanTool

Hand an email to a human teammate with optional context; outbound approval rules still apply.

{"agent_email": "[email protected]", "message_id": "msg_...", "recipient": "[email protected]", "note": "Please review this request"}
list_reviewsTool

Fetches emails held in the Human-in-the-Loop review queue.

{"status": "pending"}
approve_reviewTool

Approves a held email and delivers it to the target agent.

{"review_id": "rev_...", "notes": "Approved via MCP"}
reject_reviewTool

Quarantines a dangerous prompt injection email from delivery.

{"review_id": "rev_...", "notes": "Prompt injection detected"}