Platfone - Receive SMS & Virtual Numbers MCP

公式

AIエージェント向け仮想電話番号プラットフォーム — 200以上の国で番号をレンタルし、SMSを受信し、アクティベーションのライフサイクル全体を管理できます

GitHub
3

Platfone Receive SMS & Virtual Numbers MCPで何ができますか？

  • Check account balance — AIにget_balanceを使用して、合計残高、予約済み残高、利用可能残高を取得するよう依頼します。
  • Verify cost and availability — 注文前にcheck_priceを使用して、国とサービスの組み合わせに対する料金と番号の空き状況を確認します。
  • Order a virtual number — order_numberを使用して国とサービス名で一時的な電話番号をレンタルし、アクティベーションIDと電話番号を取得します。
  • Poll for received SMS — check_smsを使用してアクティベーションにSMSコードが届いたか確認します。ステータスとポーリングのガイダンスが返されます。
  • Request a new SMS — retry_activationを使用して、同じ番号で別のSMSを受信するための無料再試行をトリガーします。
  • Cancel and refund — SMSを受信する前にcancel_activationを使用してアクティブなアクティベーションを解放し、予約済み残高を取り戻します。

ドキュメント

Platfone MCP サーバー

npm version npm downloads License: MIT Smithery

Platfone は、アカウント認証、テスト、自動化ワークフロー向けに仮想電話番号を提供します。Platfone MCP サーバーにより、AI エージェントは Claude、VS Code Copilot、Codex などの MCP 互換クライアントから一時的な番号を取得し、SMS メッセージを受信できます。

📖 ドキュメント · 🔧 セットアップガイド · 🔑 API キーを取得 · 📦 npm

なぜ MCP なのか？

API を手動で統合する代わりに、AI エージェントは次のことを行えます：

  • 国とサービス名で自律的に番号を注文
  • SMS コードを待機
  • アクティベーションを再試行またはキャンセル

すべて構造化されたツール呼び出しで実現 — カスタムバックエンドは不要です。

機能

  • 完全なアクティベーションライフサイクル — 番号の注文から SMS 受信まで
  • ETag キャッシュカタログ — 国とサービスはメモリ内にキャッシュされ、5 分の TTL と ETag ベースの条件付きリフレッシュが行われ、エージェントには送信されません
  • 人間にわかりやすい入力 — ID の代わりに "Israel" や "Telegram" を使用。名前はサーバー側で自動解決されます
  • デュアルトランスポート — 単一のコードベースから stdio と http を提供
  • API キー認証 — 既存の Platfone API キーで動作します

インストール

詳細な手順については、インストールガイド をご覧ください。

クイックスタート

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

エージェントガイドライン

  • 最初に必ず check_price を呼び出して、コストと利用可能性を確認してください
  • 次に order_number を呼び出して番号をレンタルします
  • SMS が受信されるか期限切れになるまで check_sms を呼び出します
  • SMS が届かない場合は retry_activation を使用します
  • 不要になった場合は cancel_activation を使用して資金を解放します

ツール

ツール説明
get_balanceアカウント残高を確認：合計、予約済み、利用可能な資金。
check_price注文前に国とサービスのペアの価格と利用可能性を確認。
order_number仮想電話番号を注文。名前（"Israel"）または ID（"il"）を受け付けます。activation_id + phone を返します。
check_smsアクティベーション状態をポーリング。SMS コード受信時、または現在の状態とポーリング手順を返します。
retry_activation同じ番号で別の SMS をリクエスト。無料です。
cancel_activationSMS 受信前にアクティブなアクティベーションをキャンセル。予約金額を返金します。

注記: 国とサービスのカタログはサーバー側でキャッシュされ、人間が読める名前から自動解決されます。 エージェントが完全なカタログを受け取ることはありません — 解決された 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 — 同じ番号で別の SMS をリクエスト（無料）
  • cancel_activation — SMS が届く前にキャンセル（残高に返金）

開発

セットアップ手順とテストのヒントについては、開発ガイド をお読みください。

トラブルシューティング

エラー解決策
UnauthorizedExceptionPLATFONE_API_KEY が有効か確認してください
PaymentRequiredExceptionPlatfone 残高をチャージしてください
NoNumbersAvailableException別の国またはサービスを試してください
TooManyRequestsExceptionレート制限中 — 待ってから再試行してください
MaxPriceExceededException提案された max_price と返された order_id を使用して order_number を再試行してください
TooManyActivationsException同時アクティブアクティベーションの最大数に達しました — キャンセルするか、期限切れを待ってください

ライセンス

LICENSE.md を参照してください。MIT ライセンスの下で提供されています。

Platfone API の使用には、利用規約 および プライバシーポリシー が適用されます。