1. Conduid
  2. Science
  3. platfone-com/mcp
MCP server · Science

platfone-com/mcp

· github.com/platfone-com/mcp

rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle. Supports stdio and HTTP transport.

Unclaimed ai-agentclaudecursormcpmcp-servermodel-context-protocolotpphone-verificationreceive-smssmssms-activatesms-verificationtemp-numbertypescriptvirtual-number
InstallView source
34Low

Scored 6 months ago · breakdown

About platfone-com/mcp

platfone-com/mcp is an MCP server in the Science category: rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle. Supports stdio and HTTP transport.

Install

From source
git clone https://github.com/platfone-com/mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

cancel_activationCancel an active activation before SMS is received. Refunds reserved amount.

Parameters not published.

check_priceCheck pricing and availability for a country + service pair before ordering.

Parameters not published.

check_smsPoll activation state. Returns SMS code when received, or current status with polling instructions.

Parameters not published.

get_balanceCheck account balance: total, reserved, and available funds.

Parameters not published.

order_numberOrder a virtual phone number. Accepts names ("Israel") or IDs ("il"). Returns `activation_id` + `phone`.

Parameters not published.

retry_activationRequest another SMS on the same number. Free of charge.

Parameters not published.

Ask AI

✦

Ask AI about platfone-com/mcp

Powered by Claude · Grounded in docs

I know everything about platfone-com/mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

Platfone MCP Server

npm version npm downloads 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:

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.
retry_activation Request another SMS on the same number. Free of charge.
cancel_activation Cancel 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 & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. 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

Error Solution
UnauthorizedException Check your PLATFONE_API_KEY is valid
PaymentRequiredException Top up your Platfone balance
NoNumbersAvailableException Try a different country or service
TooManyRequestsException Rate limited — wait and retry
MaxPriceExceededException Retry order_number with the suggested max_price and returned order_id
TooManyActivationsException Max 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 copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About platfone-com/mcp

How do I install platfone-com/mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is platfone-com/mcp safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is platfone-com/mcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.