@jassra25/inboxr-mcp

MCP server giving AI agents access to disposable email + SMS + voice inboxes, webhooks, mail forwards, and domain/credit info via Inboxr.

v0.2.0 adds webhook, forward, SMS-credit, domain, SMTP-credential and TTS tools — and fixes a bug where every voice_* tool in v0.1.0 called a path (/v1/sms/voice/*) that doesn't exist and always 404'd. If you use the voice tools, upgrade.

Install

npm install -g @jassra25/inboxr-mcp
# or run on demand: npx -y @jassra25/inboxr-mcp

Configure your MCP client

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "inboxr": {
      "command": "npx",
      "args": ["-y", "@jassra25/inboxr-mcp"],
      "env": { "INBOXR_API_KEY": "inb_live_..." }
    }
  }
}

Cursor, Continue, Cline — same shape, same env.

Generate your API key at https://getinboxr.app/api-keys.

Tools

Email

| Tool | What it does | |---|---| | create_inbox | Create a disposable address (optional label) | | list_inboxes | List active inboxes for your workspace | | delete_inbox | Tear down an inbox | | wait_for_message | Long-poll for the next arrival (up to 60s) | | get_messages | List messages in an inbox | | get_message | Fetch full body (text + html) | | extract_otp | Pull the first 6-digit code from a message | | extract_link | Pull the first URL (optional regex filter) |

SMS

| Tool | What it does | |---|---| | sms_create_inbox | Claim a phone-number-backed SMS inbox | | sms_list_inboxes | List SMS inboxes | | sms_delete_inbox | Release an SMS inbox | | sms_send | Send an SMS from an inbox | | sms_claim_sender | Stake the route for an expected sender number | | sms_wait_for_message | Long-poll for the next inbound SMS | | sms_get_messages | List SMS in an inbox | | sms_extract_otp | Pull an OTP (4–8 digits) from an SMS body | | sms_credit_balance | (0.2.0) Current credit balance + top-up packs |

Voice / IVR

| Tool | What it does | |---|---| | voice_list_flows | List IVR flows | | voice_create_flow | Create a flow from raw JSON | | voice_create_flow_from_description | Let Claude design the JSON tree | | voice_assign_flow | Attach a flow to an inbox | | voice_test_flow | Dry-run with simulated DTMF | | voice_list_traces | See how recent calls traversed a flow | | voice_list_voices | (0.2.0) TTS voice catalogue | | voice_tts_generate | (0.2.0) Pre-render a phrase to an audio URL |

Webhooks (0.2.0)

| Tool | What it does | |---|---| | list_webhooks | List subscriptions + the full event vocabulary | | create_webhook | Subscribe a URL to events (signing secret returned once) | | delete_webhook | Revoke a subscription | | test_webhook | Fire a synthetic event, return receiver status + body | | webhook_deliveries | Last 50 delivery attempts |

Forwards · domains · workspace (0.2.0)

| Tool | What it does | |---|---| | list_forwards / create_forward / delete_forward | Mail-alias rules (A → B). Requires forward:write scope, not auto-granted by write. | | list_domains | Every domain the workspace can use (public + platform + custom) | | inbox_smtp_credentials | Issue SMTP/IMAP credentials for an inbox (returned once) |

Example agent workflow

1. create_inbox(label="signup-test")          → [email protected]
2. <fill the address into the signup form>
3. wait_for_message(inbox_id, timeout_s=30)
4. extract_otp(message_uid, domain)           → "428104"
5. <enter the code>
6. delete_inbox(inbox_id)

Configuration

| Env var | Default | Notes | |---|---|---| | INBOXR_API_KEY | (required) | Bearer token. Scope must cover the tools you use: read/write for email + inboxes, sms:send/sms:read for SMS, voice:call/voice:read for voice, forward:write/forward:read for forwards. admin covers everything. | | INBOXR_API_BASE | https://api.getinboxr.app | Override for self-hosted / dev |

Scopes note

forward:write is not granted by the coarse write scope — tick it explicitly when generating the key, otherwise create_forward / delete_forward return 403. This is deliberate: a forwarding rule can silently redirect mail, so it requires explicit authorisation.