Platfone - Receive SMS & Virtual Numbers MCP
官方專為AI代理設計的虛擬電話號碼平台 — 可在200多個國家租用號碼、接收簡訊，並管理完整的啟用生命週期
你可以用 Platfone Receive SMS & Virtual Numbers MCP 做什麼？
- 檢查帳戶餘額 — 透過
get_balance讓 AI 查詢您的總資金、保留資金及可用資金。 - 驗證費用與可用性 — 在訂購前，使用
check_price檢查特定國家與服務組合的價格及號碼數量。 - 訂購虛擬號碼 — 透過
order_number依國家與服務名稱租用臨時電話號碼，以取得啟用 ID 與電話號碼。 - 輪詢已接收的簡訊 — 使用
check_sms檢查啟用項目是否已收到簡訊驗證碼，並回傳狀態與輪詢指引。 - 要求重新發送簡訊 — 使用
retry_activation觸發免費重試，在同一個號碼上再次接收簡訊。 - 取消並退款 — 在收到簡訊前，使用
cancel_activation釋放啟用中的號碼並收回保留資金。
文件
Platfone MCP 伺服器
Platfone 提供用於帳號驗證、測試和自動化工作流程的虛擬電話號碼。Platfone MCP 伺服器讓 AI 代理能夠從 Claude、VS Code Copilot、Codex 等相容 MCP 的客戶端取得臨時號碼並接收簡訊。
📖 文件 · 🔧 設定指南 · 🔑 取得 API 金鑰 · 📦 npm
為什麼選擇 MCP？
AI 代理無需手動整合 API，即可：
- 根據國家和服務名稱自主訂購號碼
- 等待簡訊驗證碼
- 重試或取消啟用
全部透過結構化工具呼叫完成 — 無需自訂後端。
功能特色
- 完整的啟用生命週期 — 從訂購號碼到接收簡訊
- ETag 快取目錄 — 國家和服務目錄在記憶體中快取，TTL 為 5 分鐘，並採用基於 ETag 的條件式重新整理 — 絕不會傳送給代理
- 人性化輸入 — 使用「Israel」或「Telegram」而非 ID；名稱會在伺服器端自動解析
- 雙重傳輸 — 單一程式碼庫同時支援
stdio和http - API 金鑰驗證 — 與您現有的 Platfone API 金鑰相容
安裝
請參閱完整的安裝指南以取得詳細說明。
快速入門
NPM：
PLATFONE_API_KEY=your_key npx @platfone/mcp
代理指南
- 務必先呼叫
check_price以確認費用和可用性 - 然後呼叫
order_number來租用號碼 - 呼叫
check_sms直到收到簡訊或過期 - 如果沒有收到簡訊，請使用
retry_activation - 如果不再需要，請使用
cancel_activation釋放資金
工具
| 工具 | 說明 |
|---|---|
get_balance | 檢查帳戶餘額：總額、已保留和可用資金。 |
check_price | 在訂購前檢查特定國家與服務組合的定價和可用性。 |
order_number | 訂購虛擬電話號碼。接受名稱（"Israel"）或 ID（"il"）。回傳 activation_id 和 phone。 |
check_sms | 輪詢啟用狀態。收到簡訊時回傳驗證碼，或回傳包含輪詢指示的目前狀態。 |
retry_activation | 在同一號碼上要求另一則簡訊。免費。 |
cancel_activation | 在收到簡訊前取消進行中的啟用。退還已保留的金額。 |
注意： 國家和服務目錄在伺服器端快取，並從人類可讀的名稱自動解析。 代理永遠不會收到完整的目錄 — 只會收到已解析的 ID 或消歧義提示。
典型的 AI 代理流程
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
選用步驟：
retry_activation— 在同一號碼上要求另一則簡訊（免費）cancel_activation— 在收到簡訊前取消（退還餘額）
開發
請閱讀完整的開發指南以取得設定說明和測試技巧。
疑難排解
| 錯誤 | 解決方案 |
|---|---|
UnauthorizedException | 檢查您的 PLATFONE_API_KEY 是否有效 |
PaymentRequiredException | 儲值您的 Platfone 餘額 |
NoNumbersAvailableException | 嘗試不同的國家或服務 |
TooManyRequestsException | 受到速率限制 — 請等待並重試 |
MaxPriceExceededException | 使用建議的 max_price 和回傳的 order_id 重試 order_number |
TooManyActivationsException | 已達最大同時進行中的啟用數量 — 請取消或等待過期 |
授權
請參閱 LICENSE.md。採用 MIT 授權條款。