100MB FREEResidential proxiesClaim
NumberOTP
MCP for AI agents

Let your AI agent verify accounts

numberotp-mcp gives Claude, Cursor, Codex and any MCP client a real phone number for SMS verification. The agent finds the service, picks a country, reads the code and asks for a refund when nothing arrives.

Run$ NOTP_API_KEY=notp_… npx -y numberotp-mcp

Add it to your client

Use an API key with the read,buy scope. NOTP_MAX_SPEND caps what one session can spend (default $5).

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

What the agent can do

search_servicesName, code or website → the right service code
get_pricesPrice, stock and measured success rate by country
buy_numberBuy a number, within the session budget and max_price
wait_for_codeWait for the SMS code (call again to keep waiting)
get_number / list_numbersStatus, code and every SMS
request_another_smsA second code on the same number
cancel_number / finish_numberRefund when nothing arrived, or close when done
rent_number / get_rentalLonger-term numbers
get_balanceBalance and how much of the budget is left
create_topup_linkA payment link for you — the agent never pays

Safe by design

Spending cap

NOTP_MAX_SPEND limits what a session can spend on numbers, whatever the agent decides.

Agents never pay

When the balance is low, the agent hands you a top-up link instead.

Limited keys

A read,buy key can buy and read numbers, never manage keys, webhooks or your account.

No guessing

Service codes come from search_services, so the agent never buys the wrong service.

Refunds built in

Nothing arrived? cancel_number returns the full price to your balance.

Errors it can act on

Failures come back as instructions, e.g. “balance too low — create a top-up link”.

Questions

Which clients work?▾
Any client that supports MCP over stdio: Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Zed and others. It runs locally with Node 20+ through npx.
How do I create a key for the agent?▾
In Dashboard → Developer, or with the CLI: notp keys create agent --scope read,buy.
What does it cost?▾
The same as buying on the website. The server itself is free and MIT-licensed.

Keep going