Platfone

io.github.platfone-comPublished by GitHub account platfone-comv1.1.8Updated Oct 24, 2026

Virtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Platfone lets an AI assistant rent virtual phone numbers in many countries and receive SMS codes, using a paid Platfone account.

What you can do
Check account balance, reserved and available funds, and look up pricing and availability for a country and service pair before ordering. Order a virtual phone number by country and service name, returning an activation ID and phone number. Poll an activation for the incoming SMS code or its current status. Request another SMS on the same number, or cancel an activation before the SMS arrives to release the reserved amount.
When to use it
Useful when an assistant needs a temporary number to receive verification SMS codes for account signup, testing, or automation workflows, and you want it to handle the order, polling, retry and cancel steps through tool calls.
Requirements
A Platfone account with a funded balance and a Platfone API key supplied as the PLATFONE_API_KEY environment variable. Runs either as a remote endpoint or as a local npm package via npx, which needs Node.js and network access.
Before you install
The server spends real money: ordering a number reserves funds from your Platfone balance, and cancellation only refunds before the SMS arrives. It requires the PLATFONE_API_KEY secret, and the assistant can order, retry and cancel activations autonomously. Phone numbers and activation data are handled by Platfone's service.

Installation

In SourceWeft

  1. Open Platfone in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.platfone-com%2Fplatfone/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "platfone": {
      "type": "http",
      "url": "https://mcp.platfone.com/mcp"
    }
  }
}

README

Platfone MCP Server

[npm version] [npm downloads] [License: MIT] [Smithery]

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 — stdio and http from 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:

bash
PLATFONE_API_KEY=your_key npx @platfone/mcp

Agent Guidelines

  • Always call check_price first to verify cost and availability
  • Then call order_number to rent a number
  • Call check_sms until SMS is received or expired
  • Use retry_activation if no SMS arrives
  • Use cancel_activation to release funds if no longer needed

Tools

ToolDescription
get_balanceCheck account balance: total, reserved, and available funds.
check_priceCheck pricing and availability for a country + service pair before ordering.
order_numberOrder a virtual phone number. Accepts names ("Israel") or IDs ("il"). Returns activation_id + phone.
check_smsPoll activation state. Returns SMS code when received, or current status with polling instructions.
retry_activationRequest another SMS on the same number. Free of charge.
cancel_activationCancel 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 & availability2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone3. 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 testing tips.

Troubleshooting

ErrorSolution
UnauthorizedExceptionCheck your PLATFONE_API_KEY is valid
PaymentRequiredExceptionTop up your Platfone balance
NoNumbersAvailableExceptionTry a different country or service
TooManyRequestsExceptionRate limited — wait and retry
MaxPriceExceededExceptionRetry order_number with the suggested max_price and returned order_id
TooManyActivationsExceptionMax 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.

Source: README.md at commit ec043e2

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.1.8LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts