Relay MCP server

An inbox your
agent can use.

Give your agent a private address and a focused set of tools. Create inboxes, read incoming mail, and extract verification codes through MCP.

Streamable HTTPScoped API keysAccount-owned inboxes

Quick Setup

Paste this into Cursor, Claude, or another MCP-capable assistant. It should write the config, use your API key, and verify the server responds.

Set up Relay MCP in this environment.

1. I will create a Relay API key at https://www.relaymcp.net/account (keep the full secret; only the prefix is shown later).
2. Add Relay to my MCP host config:
   • Cursor: project file `.cursor/mcp.json` or Cursor Settings → MCP.
   • Claude Desktop: `claude_desktop_config.json` → `mcpServers`.
   • Other hosts: their documented MCP JSON config location.
3. Merge this server (I will paste my real key where shown):
{
  "mcpServers": {
    "relay": {
      "type": "http",
      "url": "https://www.relaymcp.net/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RELAY_API_KEY"
      }
    }
  }
}
   Replace YOUR_RELAY_API_KEY with the key I created. Do not commit it to git.
4. Verify: send an MCP `initialize` request via POST to https://www.relaymcp.net/api/mcp with the same Authorization header. Expect HTTP 200, not 401. Then confirm the `list_domains` tool is available.

If the host prefers environment variables, map RELAY_API_KEY and set Authorization to Bearer plus that value in the transport or config the host supports.
Connect your agentmcp-config.json
{  "mcpServers": {    "relay": {      "type": "http",      "url": "https://www.relaymcp.net/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_RELAY_API_KEY"      }    }  }}

A real receiving address

Provision an inbox inside your agent workflow, then read the mail your application sends to it.

Tools with a clear purpose

Named tools cover inbox creation, message retrieval, code extraction, and reliable email workflows.

Access stays in your hands

Keys are scoped, hashed, and revocable. Each key accesses only its account's inboxes.

The toolset

Seven tools. One connection.

Full reference
list_domains

Discover available Free mail domains.

Read
list_inboxes

Find the inboxes linked to your account.

Read
create_inbox

Create an address, with an optional name and domain.

Write
list_messages

Check incoming mail with cursor pagination.

Read
read_message

Read text, sanitized HTML, and attachment metadata.

Read
get_otp

Extract a verification code with confidence information.

Read
get_auth_artifacts

Extract OTPs and authentication links from a message.

Read

Works with your MCP client.

Connect a client that supports Streamable HTTP and custom Authorization headers. Keep your key in the client's credential configuration.

Read the MCP setup guide
FROM THE COLLECTIONS

Guides for MCP and AI agents

Connect agents to real inboxes with scoped credentials, explicit tool boundaries, and untrusted-data handling.