Skip to main content
MCP server CX Codex

Virtnumber — Claude Code MCP server: features and setup

The Virtnumber MCP server for Claude Code lets an agent rent phone numbers and read incoming SMS. It can check rates, request a number and wait for a message.

MIT updated 2026-11-07

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp
Open on GitHub

What Virtnumber does

Virtnumber connects an agent to a remote phone-number service. The available tools cover balance and pricing checks, renting or cancelling numbers, sending SMS, and reading messages; the agent can also wait up to 55 seconds for a new one. Numbers are available in 14 countries, while SMS sending works with numbers from the US and Sweden.

An account with funds is required. Sign-in uses OAuth 2.1 with PKCE; headless agents can authenticate with an API user and token in the x-api-user and x-api-token headers. Each connected agent gets its own permissions and spending cap. SMS content comes from third parties, so the agent must treat it as untrusted input.

What it helps with

  • check number rates and plans by country
  • rent a number to receive a verification SMS
  • read a code from an incoming message
  • send a text or cancel a rented number

Example prompts for the agent

  • Check the rates for numbers in the country I need and rent one.
  • Wait for the next SMS on my number and extract its code.
  • List my rented numbers and cancel the selected one.

How to install Virtnumber

Platform CLI: remote server

claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Virtnumber

How do I install Virtnumber in Claude Code?

Run claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp. Then authenticate with a Virtnumber account through OAuth.

What does Virtnumber do?

It gives an agent tools to rent phone numbers and manage SMS, including checking prices, reading incoming messages, and sending texts from US and Swedish numbers.

What does Virtnumber need to work?

It needs a funded Virtnumber account. Standard sign-in uses OAuth 2.1 with PKCE; headless agents need an API user and token.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open