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.
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.{ "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.
Seven tools. One connection.
list_domainsDiscover available Free mail domains.
Readlist_inboxesFind the inboxes linked to your account.
Readcreate_inboxCreate an address, with an optional name and domain.
Writelist_messagesCheck incoming mail with cursor pagination.
Readread_messageRead text, sanitized HTML, and attachment metadata.
Readget_otpExtract a verification code with confidence information.
Readget_auth_artifactsExtract OTPs and authentication links from a message.
ReadWorks 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