last drop 31 Oct 2026: +12

For agents · Model Context Protocol

Give your agent a phone number.

An MCP server over Streamable HTTP. Five tools: list countries, list numbers, latest drop, read an inbox, wait for a code. No key, same public numbers as the site, with new numbers every day at 00:00 UTC.

MCP (Model Context Protocol) is an open standard that lets an AI assistant call outside tools. Add this server to Claude, Cursor, VS Code or your own agent, and the agent can pick a free number, enter it in a sign-up form and read the verification code by itself. For scripts and apps, the same data is in the free JSON API.

EndpointPOST · JSON-RPC 2.0 · protocol 2025-06-18
https://getvirtualphonenumber.com/mcp

Add it to your client

Cursor, Windsurf, VS Code and most agent frameworks read this JSON. Claude Desktop and Claude Code can add it with one command:

Terminal
claude mcp add --transport http getvirtualphonenumber https://getvirtualphonenumber.com/mcp
mcp.json
{
  "mcpServers": {
    "getvirtualphonenumber": {
      "url": "https://getvirtualphonenumber.com/mcp"
    }
  }
}

Tools

list_countriesCountries with free public numbers online right now, with dial code and how many lines are online.args: none
list_numbersPublic numbers online, best delivery first (optionally for one country slug such as 'uk' or 'usa'). Each item: number in E.164, country, date added (daily drops at 00:00 UTC), SMS count, last SMS age, page URL.args: country, limit
latest_dropNew public numbers are added every day at 00:00 UTC. Returns the numbers of the latest drop (or of a given date), when the next drop goes live and how many numbers are queued per country. Fresh numbers have the fewest sign-ups on them.args: date
get_inboxLatest SMS received by one public number (E.164 or national digits). Codes are shown in full for 30 minutes after arrival, then partly masked — same as the website.args: number, limit
wait_for_codeReturn the newest SMS for a number that arrived after a given time and matches an optional sender/service filter — call it after you submitted the number somewhere.args: number, service, since

How an agent uses it

The client connects to https://getvirtualphonenumber.com/mcp, asks for the tool list and then calls tools with JSON arguments. Each call returns text for the model and structured JSON. Nothing is installed locally and there is no key.

MCP or API?

MCP is for AI agents that decide which number to take and when to check for the code. The REST API is for code you write yourself: the same countries, numbers, used numbers, SMS lists and daily drops as plain JSON.

A typical run

1

list_numbers { country: "uk" }

Pick a line that is online; use its E.164 number in the sign-up form.

2

wait_for_code { number, service: "telegram" }

Poll every 10–20 s; the tool returns the newest matching SMS with the code extracted.

3

get_inbox { number }

Full recent history for the line — the same inbox humans see on the number's page.

Questions

Does the MCP need a key?
No. It reads the same public inboxes as the website, with the same 30-minute masking of codes.
Which clients work?
Any client that speaks MCP over Streamable HTTP: Claude Desktop and Claude Code, Cursor, Windsurf, VS Code agents, custom agents with the official SDKs.
Is there a rate limit?
Live inbox reads are cached for 15 seconds per number; poll wait_for_code every 10–20 seconds.