Platfone

io.github.platfone-com由 GitHub 账号 platfone-com 发布v1.1.8更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行沟通与协作商业与电商

概览

AI 生成的概览

Platfone 让 AI 助手租用多国虚拟电话号码并接收短信验证码，需使用付费的 Platfone 账户。

可以做什么
查询账户余额（总额、预留与可用资金），并在下单前查询某国家与服务组合的价格和可用性。按国家与服务名称订购虚拟电话号码，返回激活 ID 和电话号码。轮询激活状态以获取收到的短信验证码或当前状态。在同一号码上请求重发短信，或在收到短信前取消激活以释放预留金额。
适用场景
当助手需要临时号码接收注册、测试或自动化流程中的短信验证码，并希望它通过工具调用完成下单、轮询、重试和取消等步骤时适用。
运行要求
需要 Platfone 账户、已充值的余额，以及通过 PLATFONE_API_KEY 环境变量提供的 Platfone API 密钥。可作为远程端点运行，也可通过 npx 作为本地 npm 包运行，后者需要 Node.js 和网络访问。
安装前请注意
该服务器会花费真实资金：订购号码会从 Platfone 余额中预留金额，且仅在收到短信前取消才会退款。它需要 PLATFONE_API_KEY 密钥，助手可自主下单、重试和取消激活。电话号码与激活数据由 Platfone 服务处理。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Platfone，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.platfone-com%2Fplatfone/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "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.

来源：README.md，提交 ec043e2

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

1
  1. v1.1.8最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分