How do I install Platfone?

Platfone supports both local and remote installation. For local use, install it via npm (npx) and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

What credentials does Platfone need?

Platfone requires the following credentials or environment variables: PLATFONE_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Platfone?

Platfone uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Platfone MCP Server

by Platfone Com

Developer ToolsLow Risk9.8MCP RegistryLocalRemote

Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://mcp.platfone.com/mcp

Security Report

9.8

Low Risk9.8Low Risk

Valid MCP server (7 strong, 2 medium validity signals). 1 known CVE in dependencies Package registry verified. Imported from the Official MCP Registry.

12 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your Platfone API key from https://platfone.com/app/apiRequired

Environment variable: PLATFONE_API_KEY

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub 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.
`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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Platfone MCP Server

About

Security Report