Virtnumber
Rent phone numbers in 14 countries and have an agent wait for the verification SMS
- Pricing
- Paid
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 2.2.0
- Listing updated
- 3 days ago
About Virtnumber
Virtnumber is a paid MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.
Virtnumber lets an agent buy a number and read what arrives, all from a prepaid balance. A typical flow is get_pricing, then buy_number, then wait_for_sms, which waits up to 55 seconds for the next message. Messages come back with detected codes.
Spending is bounded: when you connect an app through OAuth you choose its permissions and a spending limit, and every connected agent has its own limit. Headless agents can instead use x-api-user and x-api-token headers. The README warns that message text comes from third parties and should be treated as untrusted input.
The same operations exist as a REST API with webhooks, RFC 9457 error bodies and rate limit headers; the REST API requires a balance of at least 1 EUR.
Install
Run in a terminal
claude mcp add --transport http virtnumber https://www.virtnumber.com/mcpAdd to Settings → Connectors → Add custom connector
https://www.virtnumber.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"virtnumber": {
"url": "https://www.virtnumber.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"virtnumber": {
"type": "http",
"url": "https://www.virtnumber.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"virtnumber": {
"serverUrl": "https://www.virtnumber.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"virtnumber": {
"type": "http",
"url": "https://www.virtnumber.com/mcp"
}
}
}Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- get_balance
- Balance, spending limit and permissions.
- get_pricing
- Countries, plans and prices.
- list_my_numbers
- Your rented numbers.
- list_messages
- Read SMS on a number, with detected codes.
- wait_for_sms
- Wait up to 55 seconds for the next SMS.
- buy_number
- Rent a number.
- send_sms
- Send an SMS.
- delete_number
- Cancel a number.
What it does
- Number rental
- Buy and cancel real and virtual numbers.
- Wait for SMS
- Blocks up to 55 seconds for the next message.
- Detected codes
- Message listings include detected codes.
- Spending limits
- Per-agent limits set at consent.
- Idempotent purchases
- Buy calls accept an idempotency key.
- REST and webhooks
- Same operations through an API.
Good for
- Receive a signup verification code in an agent flow
- Compare number prices by country
- Send an SMS from the same account
- Retire numbers you no longer use
Pricing
Paid
Prepaid balance; REST API requires at least 1 EUR
Prices change. Check virtnumber.com before you buy.
Virtnumber FAQ
How do agents authenticate?
OAuth with chosen permissions and spending limit, or API user and token headers.
Which countries are covered?
14, according to the registry description.
Can it send SMS?
Yes, through `send_sms`; long text is billed as several SMS.
Is the message text safe to trust?
No. It comes from third parties and should be treated as untrusted input.
Is Virtnumber free?
No. Virtnumber is a paid product.
How do I add Virtnumber to Claude Code?
Run this command in your terminal: claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp
What are the best alternatives to Virtnumber?
The closest alternatives to Virtnumber are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Virtnumber

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity