otpbox

OTPBox / AI / Claude Code

AI coding agent · MCP

Test email verification with Claude Code

Add OTPBox as a remote MCP server and Claude Code can create a disposable inbox, drive your signup form, and read back the real OTP or verification link - all mid-task, no copy-pasting a code out of your own inbox.

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 }

Register the server with the Claude Code CLI:

claude mcp add --transport http otpbox https://otpbox.io/mcp \
  --header "Authorization: Bearer <your-otpbox-key>"
Add --scope project to share the config with your team via .mcp.json, or --scope user for every project on your machine.

Try a prompt

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

"Create a disposable inbox, sign up for my app at localhost:3000 with it, wait for the verification email, and finish the signup with the code."

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 Claude Code docs

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

Next steps

← Back to OTPBox