For agents · Model Context Protocol
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.
Cursor, Windsurf, VS Code and most agent frameworks read this JSON. Claude Desktop and Claude Code can add it with one command:
{
"mcpServers": {
"getvirtualphonenumber": {
"url": "https://getvirtualphonenumber.com/mcp"
}
}
}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 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.
list_numbers { country: "uk" }
Pick a line that is online; use its E.164 number in the sign-up form.
wait_for_code { number, service: "telegram" }
Poll every 10–20 s; the tool returns the newest matching SMS with the code extracted.
get_inbox { number }
Full recent history for the line — the same inbox humans see on the number's page.