otpbox

OTPBox / AI / Cursor

AI coding agent · MCP

Test email verification with Cursor

Point Cursor at OTPBox's remote MCP server and it can create test inboxes and read real verification emails without leaving the editor.

Get a free key Read the MCP docs

Connect OTPBox

Mint a free key first (no account, no card):

curl -X POST https://otpbox.io/api/v1/keys/free -H "content-type: application/json" -d '{}'
→ { "id": "lic_...", "key": "...", "plan": "free", "quotaLimit": 200 }

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "otpbox": {
      "url": "https://otpbox.io/mcp",
      "headers": { "Authorization": "Bearer <your-otpbox-key>" }
    }
  }
}
Cursor resolves ${env:VAR} references inside headers, so you can keep the raw key out of the file: "Authorization": "Bearer ${env:OTPBOX_KEY}".

Try a prompt

Once connected, Cursor can call OTPBox's 13 MCP tools directly. For example:

"Use otpbox to create a test inbox, register a new account on this app with that address, then get the OTP and complete verification."

What you get

Real inboxes, not mocks

Every code and link comes from a real delivered email, not a stub - so the test proves the actual signup flow works.

Extraction built in

OTP codes and verification links are parsed out automatically. No regex against raw email bodies.

Free tier, no card

200 requests/month with a key minted in one call - no account, no payment info, no waiting.

13 MCP tools

create_test_inbox, wait_for_email, get_otp, get_verification_link, create_test_identity, and more - the full loop is agent-callable.

Official Cursor docs

For Cursor's own MCP setup UI/flags beyond the snippet above, see Cursor's MCP documentation.

Next steps

← Back to OTPBox