Platfone MCP - Receive SMS & Virtual Numbers
The Platfone MCP server enables AI agents to rent virtual phone numbers and receive SMS messages for account verification, testing, and automation workflows. It uses human-friendly inputs for countries and services (auto-resolved server-side) and authenticates via an API key.
get_balance: Check your total, reserved, and available funds (in USD cents).check_price: Look up pricing, availability, and quality score for a country + service pair before ordering.order_number: Rent a virtual phone number for a given country and service (e.g., "Israel" + "Telegram"). Returns the number, activation ID, price, expiry, and cancellation details.check_sms: Poll an activation for incoming SMS — retrieves message content, parsed verification code, and status. Can be polled repeatedly until an SMS arrives or the activation expires.retry_activation: Request an additional SMS on the same number, free of charge, if the first didn't arrive or a new code is needed.cancel_activation: Cancel an active order before an SMS is received to release reserved funds back to your balance.
Provides virtual phone numbers for Telegram account verification and SMS reception, allowing AI agents to automate registration and testing workflows.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Platfone MCP Server
Platfone provides virtual phone numbers for account verification, testing, and automation workflows. The Platfone MCP server enables AI agents to obtain temporary numbers and receive SMS messages from MCP-compatible clients like Claude, VS Code Copilot, Codex, etc.
📖 Docs · 🔧 Setup Guide · 🔑 Get API Key · 📦 npm
Why MCP?
Instead of manually integrating the API, AI agents can:
Order numbers autonomously by country and service name
Wait for SMS codes
Retry or cancel activations
All via structured tool calls — no custom backend required.
Related MCP server: agentline-mcp
Features
Full activation lifecycle — from ordering a number to receiving SMS
ETag-cached catalog — countries and services are cached in-memory with 5-minute TTL and ETag-based conditional refresh — never sent to the agent
Human-friendly inputs — use "Israel" or "Telegram" instead of IDs; names are auto-resolved server-side
Dual transport —
stdioandhttpfrom a single codebaseAPI key auth — works with your existing Platfone API key
Installation
See the full Installation Guide for detailed instructions.
Quick Start
NPM:
PLATFONE_API_KEY=your_key npx @platfone/mcpAgent Guidelines
Always call
check_pricefirst to verify cost and availabilityThen call
order_numberto rent a numberCall
check_smsuntil SMS is received or expiredUse
retry_activationif no SMS arrivesUse
cancel_activationto release funds if no longer needed
Tools
Tool | Description |
| Check account balance: total, reserved, and available funds. |
| Check pricing and availability for a country + service pair before ordering. |
| Order a virtual phone number. Accepts names ("Israel") or IDs ("il"). Returns |
| Poll activation state. Returns SMS code when received, or current status with polling instructions. |
| Request another SMS on the same number. Free of charge. |
| Cancel an active activation before SMS is received. Refunds reserved amount. |
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.
Typical AI Agent Flow
1. check_price (country: "Israel", service: "Telegram") → verify cost & availability
2. order_number (country: "Israel", service: "Telegram") → returns activation_id + phone
3. check_sms (activation_id) → poll or check once for SMSOptional steps:
retry_activation— request another SMS on the same number (free)cancel_activation— cancel before SMS arrives (refunds balance)
Development
Read the full Development Guide for setup instructions and testing tips.
Troubleshooting
Error | Solution |
| Check your |
| Top up your Platfone balance |
| Try a different country or service |
| Rate limited — wait and retry |
| Retry |
| Max concurrent active activations reached — cancel or wait for expiry |
License
See LICENSE.md. Licensed under the MIT License.
Use of the Platfone API is subject to Terms of Service and Privacy Policy.
Available Tools
6 toolscancel_activationCancel ActivationADestructiveInspect
Cancel a Platfone activation and release the phone number. Allowed when activation_status is "active", sms_status is "smsRequested", and the cancelable_after timestamp has passed. If cancelable_after is null, cancellation is not supported.
Inputs: activation_id (required).
check_priceCheck PriceARead-onlyIdempotentInspect
Check pricing for a country + service pair before ordering. Returns min, max, and suggested price, average quality score, and number of available phone numbers. Use this before order_number to verify cost and availability. Accepts country and service as human-readable names or IDs.
Inputs: country (required), service (required), max_price.
check_smsCheck SMSARead-onlyIdempotentInspect
Retrieve the current state of a Platfone activation: SMS text, parsed code, status, and expiration. Can be used to poll periodically or check once on demand.
Inputs: activation_id (required).
get_balanceGet BalanceARead-onlyIdempotentInspect
Returns the current Platfone account balance: total available funds and the amount reserved by active orders. All values are in USD cents. Use this after a 402 error to inform the user how much they need to top up.
Inputs: no named parameters.
order_numberOrder NumberAInspect
Rent a virtual phone number via the Platfone API for the given country and service category. Returns phone number, activation_id, resolved country & service names, price, expiry time, retriable flag, and whether/when the activation can be canceled. Accepts country and service as human-readable names or IDs — names are auto-resolved from the cached catalog. Use check_price first to verify cost and availability. Use check_sms with the activation_id to poll for incoming SMS. Only received messages are billed. IMPORTANT: Only call this tool once per order. Never call it multiple times in parallel — duplicate orders will be rejected.
Inputs: country (required), service (required), max_price, quality_factor.
retry_activationRetry ActivationAInspect
Request an additional SMS on the same Platfone number. Overwrites the previous SMS data with the next message. Free of charge. Only possible when sms_status is "smsReceived" or "retryReceived", activation_status is "active", and is_retriable is true. After calling, poll check_sms every 5 seconds until sms_status becomes "retryReceived" or the activation expires.
Inputs: activation_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: cancel activation, check price, check SMS, get balance, order number, and retry activation. No overlap in functionality.
All tools follow the snake_case verb_noun pattern (e.g., cancel_activation, check_price), which is consistent and predictable.
With 6 tools, the set is well-scoped for the domain of receiving SMS via virtual numbers, covering ordering, checking, retrying, canceling, and balance/price queries.
Core lifecycle operations are present, but missing an explicit tool to list supported countries/services. However, the tools accept names directly, reducing the gap.
Maintenance
Related MCP Connectors
Virtual phone numbers and SMS verification codes for AI agents: 800+ services, 200+ countries.
Rent real and virtual phone numbers in 14 countries and read their SMS from your AI agent.
Real phone numbers for AI agents: SMS, iMessage, WhatsApp, AI voice calls, and inbound events.
Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for provisioning dedicated real-SIM US phone numbers, receiving inbound SMS, and extracting OTP codes. Built for AI agents automating phone verification workflows.12134 npm1MIT
- AlicenseAqualityCmaintenanceGives AI agents phone numbers, email, SMS, and voice calls as MCP tools, enabling them to provision numbers, capture 2FA codes, send messages, and make calls.15MIT
- AlicenseNot gradedqualityBmaintenanceConnect AI agents to Wavix's communications platform to send SMS, make and manage voice calls, run 2FA flows, and access speech analytics, phone number management, and SIP infrastructure.5MIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage phone numbers, send/receive SMS, and place voice calls through natural language, connecting to the phone network via the AgentPhone API.28353 npm130MIT