Home / Integrations

MCP server (AI coding agents)

Give Claude Code, Cursor or any MCP client real temporary email inboxes: create addresses, wait for OTPs and assert on emails while testing your app.

InboxDome runs a hosted Model Context Protocol server at https://inboxdome.com/mcp. Connect it and your coding agent can test signup and OTP flows against the app it is building, with real email and no mocks.

Claude Code

claude mcp add --transport http inboxdome https://inboxdome.com/mcp \
  --header "Authorization: Bearer idk_live_..."

Any MCP client (JSON config)

{
  "mcpServers": {
    "inboxdome": {
      "type": "http",
      "url": "https://inboxdome.com/mcp",
      "headers": { "Authorization": "Bearer idk_live_..." }
    }
  }
}

Tools

ToolWhat it does
create_inboxNew temporary address (optionally on a chosen domain)
wait_for_emailLong-poll for the next email or OTP (up to 50s per call)
list_messages / get_messageRead what arrived: body, links, OTP, SPF/DKIM/DMARC
run_assertionsWait + verify content, OTP, link responds, auth results
delete_message / empty_inbox / delete_inbox / list_domainsCleanup and domain discovery

A typical agent flow: create_inbox → fill the signup form with the address →wait_for_email with waitFor: "otp" → submit the code →run_assertions on the welcome email.

Getting a key

Connecting without a key still works: the server initializes and lists its tools, so you (or your agent) can inspect it first. To call them, log in with your DevDome account and copy the API key from Account. Reconnect withAuthorization: Bearer <apiKey> and every tool works. The key is shown once; store it.

Rate limits and usage are the same as your API plan.

InboxDome is for testing applications you own or are authorized to test; see theAcceptable Use Policy.

API reference →