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
claude mcp add --transport http virtnumber https://www.virtnumber.com/mcpWhat 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/mcpPlatform CLI: remote server
codex mcp add virtnumber --url https://www.virtnumber.com/mcpConfig file
{
"mcpServers": {
"virtnumber": {
"url": "https://www.virtnumber.com/mcp"
}
}
}Config file
{
"servers": {
"virtnumber": {
"type": "http",
"url": "https://www.virtnumber.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http virtnumber https://www.virtnumber.com/mcpStep 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.