Skip to content
MCP server

Virtnumber

Rent phone numbers in 14 countries and have an agent wait for the verification SMS

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://www.virtnumber.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "virtnumber": {
      "url": "https://www.virtnumber.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity