Overview

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

Instead of writing API calls manually, you can simply ask your AI assistant:

“Get me a phone number for Telegram in the United States and wait for the SMS code”

The AI agent will call the appropriate MCP tools automatically.

🔑 Key Features#

• Full SMS activation lifecycle — browse countries and services, order a number, retrieve the SMS code, retry, or cancel
• Name resolution — order_number accepts human-readable names (“United States”, “Telegram”) and auto-resolves to IDs
• Dual transport — stdio (local) and http (remote) from a single codebase
• API key auth — works with your existing Platfone API key

🏗️ How It Works#

┌──────────────────┐       MCP Protocol        ┌──────────────────┐       HTTPS       ┌──────────────────┐
│   AI Client      │ ◄──────────────────────► │  Platfone MCP    │ ◄──────────────► │  Platfone API    │
│ (Claude, Copilot │       stdio / HTTP        │  Server          │                   │  Backend         │
│  Codex, etc.)    │                           │  @platfone/mcp   │                   │                  │
└──────────────────┘                           └──────────────────┘                   └──────────────────┘

1. Your AI client connects to the Platfone MCP server via stdio (local process) or HTTP (remote endpoint)
2. The AI discovers available tools (list_countries, order_number, check_sms, etc.)
3. When you ask for an SMS activation, the AI calls the right tools in sequence
4. The MCP server translates tool calls into Platfone API requests and returns results

▶️ Next Steps#