numberotp-mcp

An MCP server that gives AI agents a real phone number for SMS verification. The agent finds the service, picks a country, buys a number, reads the code and cancels for a refund when nothing arrives.

Get an API key at numberotp.com/dashboard/developer (a read,buy key is enough). Setup guides for every client: numberotp.com/docs/mcp.

claude mcp add numberotp --env NOTP_API_KEY=notp_… --env NOTP_MAX_SPEND=5 -- npx -y numberotp-mcp

For other clients, add this to mcpServers in Cursor, Claude Desktop, Codex, Windsurf, Zed and similar:

{ "numberotp": { "command": "npx", "args": ["-y", "numberotp-mcp"], "env": { "NOTP_API_KEY": "notp_…", "NOTP_MAX_SPEND": "5" } } }

| Tool | What it does | |---|---| | search_services | Name, code or domain → service code (never guess codes) | | get_prices | Price, stock and measured success rate by country | | buy_number | Buy a number (enforces the session budget and max_price) | | wait_for_code | Wait for the code (default 120 s per call; call again if needed) | | get_number / list_numbers | Status, code and every SMS | | request_another_sms | A second code on the same number | | cancel_number / finish_number | Refund if no SMS / close when done | | rent_number / get_rental | Longer-term numbers | | get_balance | Balance, money on hold, session budget left | | create_topup_link | A payment link for the user (the agent can't pay) |

Safety:

• NOTP_MAX_SPEND caps what one session can spend (default $5).
• Give the agent an API key limited to read,buy. Create it with notp keys create agent --scope read,buy.
• API keys can never manage keys, webhooks or the account.
• Errors come back as instructions the agent can act on, e.g. "Balance too low — create_topup_link…".