MMCPMarkets
PC

platfone-com/mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

4 stars 1 forks 质量 68 趋势 26MIT
Repository Install

MCP server for virtual phone number verification - SMS activations for AI agents via Claude, Cursor, VS Code Copilot and more...

概览

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. 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. - — from ordering a number to receiving SMS - — countries and services are cached in-memory with 5-minute TTL and ETag-based conditional refresh — never sent to the agent - — use "Israel" or "Telegram" instead of IDs; names are auto-resolved server-side - — stdio and http from a single codebase - — works with your existing Platfone API key See the full Installation Guide for detailed instructions.

README

以下为原文 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 — 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:

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

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.
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →