# Virtnumber

> Virtnumber is a paid MCP server for communication. Rent phone numbers in 14 countries and have an agent wait for the verification SMS. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://www.virtnumber.com/developer
- **Repository:** https://github.com/virtnumber/mcp
- **MCP Registry name:** com.virtnumber/virtnumber
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.virtnumber.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "virtnumber": {
      "url": "https://www.virtnumber.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "virtnumber": {
      "type": "http",
      "url": "https://www.virtnumber.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "virtnumber": {
      "serverUrl": "https://www.virtnumber.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "virtnumber": {
      "type": "http",
      "url": "https://www.virtnumber.com/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/virtnumber
