I
io.github.platfone-com/platfone
Virtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.
ActiveNot tested
54CNo CVEsactive
Quick Install
{
"mcpServers": {
"io-github-platfone-com-platfone": {
"args": [
"-y",
"@platfone/mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/io-github-platfone-com-platfone)
Should you use this server?
Virtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.
✓
Is it safe?
No known CVEs for @platfone/mcp.
No authentication — any process on your machine can connect.
License not specified.
✓
Is it maintained?
Last commit 2 days ago. 2 stars.
i
Will it work with my client?
Transport: stdio, http. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
README
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.
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 codebase - API 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/mcp
Agent Guidelines
- Always call
check_pricefirst to verify cost and availability - Then call
order_numberto rent a number - Call
check_smsuntil SMS is received or expired - Use
retry_activationif no SMS arrives - Use
cancel_activationto release funds if no longer needed
Tools
| Tool | Description |
|---|---|
get_balance | Check account balance: total, reserved, and available funds. |
check_price | Check pricing and availability for a country + service pair before ordering. |
order_number | Order a virtual phone number. Accepts names ("Israel") or IDs ("il"). Returns activation_id + phone. |
check_sms | Poll activation state. Returns SMS code when received, or current status with polling instructions. |
retry_activation | Request another SMS on the same number. Free of charge. |
cancel_activation | 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 SMS
Optional 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 test
Test This Server
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@platfone/mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Help improve this page
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationScore Breakdown
Security
20/30No known vulnerabilities.
✓
○
Tool safety — No tools to analyze
○
Tool poisoning — No tools to analyze
○
Injection vectors — No tools to analyze
✓
Tool stability — Tool definitions stable
○
Dependency health — found on deps.dev, recently updated
✗
License — No license specified
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is io.github.platfone-com/platfone safe to use?
- io.github.platfone-com/platfone has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
- How do I install io.github.platfone-com/platfone?
- io.github.platfone-com/platfone supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
- What AI clients work with io.github.platfone-com/platfone?
- io.github.platfone-com/platfone is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio and http transport.
- Is io.github.platfone-com/platfone actively maintained?
- io.github.platfone-com/platfone is actively maintained — last commit was 2 days ago. It has 2 GitHub stars.
Similar servers
View all →
Sequential Thinking MCP Server
OfficialNo CVEs98A
Dynamic problem-solving through sequential thought chains
1 toolsstdio83.8k111.0k/wk1d ago
XcodeBuildMCP
OfficialNo CVEs97A
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
2 toolsremote5.2k46.6k/wk1d ago
Python Sdk
OfficialNo CVEs95A
The official Python SDK for Model Context Protocol servers and clients
1 toolsremote22.6k156.5k/wk21h ago
Gemini Cli
No CVEs95A
An open-source AI agent that brings the power of Gemini directly into your terminal.
8 toolsremote101.3k814.6k/wk12h ago
MCP Security Weekly
Get CVE alerts and security updates for io.github.platfone-com/platfone and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.