# Platfone - Virtual Numbers MCP

MCP server connects AI agents to Platfone's virtual number platform. Agents can rent phone numbers across 200+ countries, receive incoming SMS messages, and manage the full activation lifecycle — all…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add dima-p0g6/platfone

# Browse available tools
npx -y @smithery/cli@latest tool list dima-p0g6/platfone

# Get full schema for a tool
npx -y @smithery/cli@latest tool get dima-p0g6/platfone get_balance

# Call a tool
npx -y @smithery/cli@latest tool call dima-p0g6/platfone get_balance '{}'
```

## Direct MCP Connection

Endpoint: `https://platfone--dima-p0g6.run.tools`

**Required config:**
- `x-api-key` (header) — Platfone API key — get one at https://platfone.com/app/api

## Tools (6)

- `get_balance` — Returns the current Platfone account balance: total available funds and the amount reserved by active orders. All value…
- `check_price` — Check pricing for a country + service pair before ordering. Returns min, max, and suggested price, average quality scor…
- `order_number` — Rent a virtual phone number via the Platfone API for the given country and service category. Returns phone number, acti…
- `check_sms` — Retrieve the current state of a Platfone activation: SMS text, parsed code, status, and expiration. Can be used to poll…
- `cancel_activation` — Cancel a Platfone activation and release the phone number. Allowed when activation_status is "active", sms_status is "s…
- `retry_activation` — Request an additional SMS on the same Platfone number. Overwrites the previous SMS data with the next message. Free of …

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get dima-p0g6/platfone <tool-name>
```