Is Platfone — Virtual Numbers MCP free?

Yes, Platfone — Virtual Numbers MCP is free to use.

How do I install Platfone — Virtual Numbers MCP?

Platfone — Virtual Numbers MCP 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 — Virtual Numbers MCP need?

Platfone — Virtual Numbers MCP 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 — Virtual Numbers MCP?

Platfone — Virtual Numbers MCP 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 — Virtual Numbers MCP MCP Server

by TempDev123

Developer ToolsLow Risk9.8LocalRemoteNew

Free

Rent virtual phone numbers and receive SMS through your AI agent.

About

Platfone MCP connects AI agents (Claude, Cursor, VS Code Copilot) to Platfone's virtual phone number platform. Agents can check pricing, rent a virtual number from 200+ countries, poll for incoming SMS, and cancel activations with auto-refund — all through 6 MCP tools.

Built for QA automation, developer workflows, and SMS verification testing. Supports both stdio (local) and Streamable HTTP (remote) transports. Open-source under MIT, the underlying API is pay-per-use with no subscription.

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. Sign up and generate one.Required

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.

Getting Started

Once installed, try these example prompts and explore these capabilities:

1"Rent a US virtual number for Telegram and give me the SMS code when it arrives"
2"Check the price for receiving SMS from WhatsApp in Germany"
3"What is my Platfone account balance?"
4Tool: get_balance — Returns available and reserved funds in USD cents
5Tool: check_price — Get min/max/suggested price and number availability for a country + service pair
6Tool: order_number — Rent a virtual number; returns phone, activation_id, expiry, retriable flag
7Tool: check_sms — Poll an activation for incoming SMS text and parsed verification code
8Tool: cancel_activation — Cancel an activation and trigger an auto-refund
9Tool: retry_activation — Request an additional SMS on the same rented number

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 — Virtual Numbers MCP MCP Server

About

Security Report

Findings (2)

Permissions Required

What You'll Need

How to Install & Connect

Getting Started

Documentation

Platfone MCP Server

Why MCP?

Features

Installation

Quick Start

Agent Guidelines

Tools

Typical AI Agent Flow

Development

Troubleshooting

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

Google Workspace MCP