otpbox

OTPBox / AI / Connect

MCP · one-click install

Connect OTPBox to your AI agent

Give Cursor, VS Code, Claude or Codex a real inbox in under a minute. Your agent can then sign up for your app, wait for the email and read the OTP code or verification link itself.

1

Get a free key

200 requests a month, no account, no card. The install links below fill it in for you.

or paste one you have
Your key is ready. Save it somewhere safe: it won't be shown again.
2

Install in your editor

No key yet: the snippets below use a placeholder. Get a key in step 1 and they update automatically.

Cursor

Opens Cursor and asks you to confirm. Or add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

VS Code (GitHub Copilot agent mode)

Or add this to .vscode/mcp.json, or run MCP: Open User Configuration to use it in every workspace:

Claude Code

Run this once in your terminal. Add --scope user to use it in every project:

Check it with claude mcp list. Prefer a skill? Install the OTPBox Agent Skill.

Claude Desktop

Settings → Developer → Edit Config, then add this to claude_desktop_config.json and restart Claude. It uses the mcp-remote bridge, so Node.js 18+ must be installed:

OpenAI Codex CLI

Add to ~/.codex/config.toml:

Codex reads the key from an environment variable, so set it in your shell profile:

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json (Cascade → MCP servers → View raw config), then refresh:

Gemini CLI

Add to ~/.gemini/settings.json. Gemini CLI needs httpUrl rather than url for this transport:

Any MCP client

OTPBox is a remote streamable HTTP MCP server. Point your client at it with this header:

Also listed in the official MCP Registry as io.otpbox/otpbox. Per-client guides: Copilot, Devin, Qwen Code, Trae, Kimi Code.

3

Ask your agent

Once connected, try one of these in agent mode:

Use otpbox to create a test inbox and tell me its address.
Sign up on http://localhost:3000 with a new otpbox inbox, get the OTP from the verification email and finish signing up. Tell me if any step fails.
Test our password reset: request a reset for a fresh otpbox inbox, open the reset link from the email and set a new password.

The tools your agent gets:

← Back to OTPBox