ReceiveHQ

Guides · MCP

Manage inbound email from Cursor or Claude over MCP

ReceiveHQ is agent-native inbound email: connect Model Context Protocol from Cursor or Claude, complete magic-link login, then configure domains, create blackhole or webhook endpoints, and read mail — without living in the web console.

Guide · MCP inbound email · ReceiveHQ

Why MCP for inbound email

Traditional inbound providers stop at “POST JSON to your URL.” Agents still need humans to click DNS wizards and paste API keys. ReceiveHQ exposes the full account lifecycle over OAuth MCP so an agent can stand up EU-hosted inbound in one conversation.

Connect the server

Add this to Cursor mcp.json, Claude Desktop, or any OAuth MCP client:

{
  "mcpServers": {
    "receivehq": {
      "url": "https://receivehq.com/api/mcp"
    }
  }
}

Endpoint: https://receivehq.com/api/mcp. Discovery: mcp.md, llms.txt, /.well-known/mcp.

Sign up from the agent

  1. Start the MCP client — it discovers OAuth and opens a browser.
  2. Enter your email on ReceiveHQ (magic link, no password). Confirm the link, then consent to mcp:read and/or mcp:admin.
  3. Tokens stay in the client. Revoke apps anytime under Settings → MCP in the console.

Prefer the browser first? Use home agent signup or Sign in / Sign up, then attach MCP.

Blackhole quick start (no webhook URL)

  1. Ask the agent to run setup_inbound_domain with endpointKind: "blackhole" (omit endpointUrl).
  2. Point MX for your domain at mx.receivehq.com; call verify_inbound_domain_mx.
  3. Send a test message; use list_messages, get_message, and list_deliveries (status blackholed).

First 10 emails per tenant are free (up to 3 trial tenants). After that, subscribe via Stripe — agents can open Checkout links from billing tools.

Add a webhook later

Create or update an endpoint with endpointKind: "webhook", an HTTPS url, and payloadFormat of postmark, mailgun-sendgrid, or cloudmailin. Same drop-in shapes as provider alternatives.

What agents can do

  • Tenants, inbound domains, MX verify, domain setup wizard
  • Blackhole and webhook endpoints (create / update / delete)
  • List/search messages, deliveries, resend, raw .eml / attempt logs
  • Members, invitations, billing checkout and portal

Full tool list: mcp.md.

Next steps

Copy MCP config on the home page · Inbound email processing · GDPR & inbound · Webhook docs