MCP Server on Platfone Docs

Overview

Mon, 01 Jan 0001 00:00:00 +0000

📝 What Is It?

The Platfone MCP Server is a Model Context Protocol server that exposes the Platfone SMS Activation API as MCP tools. This makes Platfone accessible from any MCP-compatible AI client — Claude, VS Code Copilot, Cursor, Windsurf, Codex, and more.

Tools Reference

Mon, 01 Jan 0001 00:00:00 +0000

Tool	Description	Side Effects
`get_balance`	Check account balance	Read-only
`check_price`	Check pricing and availability for a country + service	Read-only
`order_number`	Order a virtual phone number	Reserves balance
`check_sms`	Check activation status / get SMS code	Read-only
`retry_activation`	Request another SMS on same number	Free
`cancel_activation`	Cancel activation, release number	Refunds balance

Note: Country and service catalogs are cached server-side and auto-resolved from human-readable names. The agent never receives the full catalog — only resolved IDs or disambiguation hints.

Setup & Configuration

Mon, 01 Jan 0001 00:00:00 +0000

📋 Prerequisites

Node.js ≥ 18 (for local stdio transport)
Platfone API key

Environment Variables

Variable	Required	Description
`PLATFONE_API_KEY`	Yes	Your Platfone API key. For HTTP transport, can also be passed via `x-api-key` header.
`PLATFONE_API_URL`	No	Override API base URL. Default: `https://temp-number-api.com/api/v1`

Option 1: npm package (stdio)

Use the @platfone/mcp npm package for local transport — works with Claude Desktop, VS Code Copilot, Cursor, Windsurf, Codex, and other stdio-compatible MCP clients.

Testing with Sandbox

Mon, 01 Jan 0001 00:00:00 +0000

The Platfone sandbox lets you test the full MCP flow for free — no real money needed. You can send fake SMS messages through the sandbox dashboard to simulate the complete activation lifecycle.