# Virtnumber

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: virtnumber
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/virtnumber/mcp
- Updated: 2026-11-07
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/virtnumber

## What it 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.

## Requirements
- Remote server: `https://www.virtnumber.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http virtnumber https://www.virtnumber.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add virtnumber --url https://www.virtnumber.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "virtnumber": {
            "url": "https://www.virtnumber.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "virtnumber": {
            "type": "http",
            "url": "https://www.virtnumber.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http virtnumber https://www.virtnumber.com/mcp
```

## When to use it
- 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
- 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.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
