What authentication does it use?

It uses a Platfone API key provided through the PLATFONE_API_KEY environment variable.

Can I use names instead of country and service IDs?

Yes. Inputs such as "Israel" and "Telegram" are resolved to IDs by the server.

What transports are supported?

The server supports both stdio and HTTP transport.

How should an agent use the activation tools?

The recommended flow is to check price, order a number, poll with check_sms, and optionally retry or cancel the activation.

Platfone Com MCP

smsvirtual-phoneverificationautomation

MCP server for renting virtual phone numbers, receiving SMS codes, and managing activations through Platfone.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "platfone-com-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@platfone/mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Platfone MCP lets AI agents check balance and availability, order temporary numbers, receive SMS verification codes, and manage activation status. Use it for account verification, testing, or automation workflows that require temporary phone numbers across 200+ countries.

Use cases

Check number pricing and availability before ordering

Rent a temporary phone number for verification

Poll for incoming SMS codes

Retry an SMS request on an existing number

Cancel activations and release reserved funds

Key features

Virtual numbers across 200+ countries

Full activation lifecycle management

Human-readable country and service name resolution

SMS code polling

stdio and HTTP transport

ETag-cached country and service catalogs

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Platfone Com MCP.

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.

Documentation Overview

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:

bash

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

Code

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.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

147

Package downloads in the last 30 days.

Last commit

2d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Platfone Com MCP

It can check account balance, check price and availability, order numbers, poll for SMS codes, retry activations, and cancel active activations.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Platfone Com MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/platfone-com-mcp?style=directory)](https://allmcps.com/mcp/platfone-com-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/platfone-com-mcp"><img src="https://allmcps.com/api/badge/platfone-com-mcp?style=directory" alt="Platfone Com MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

PricingPaid

10/11 checks healthy over the last 32d

60Quality signal: Good · 60/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity7/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 22d ago via OSV.dev · @platfone/mcp (npm)

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to Platfone Com MCP →Install in Claude Desktop Install in Cursor Install in VS Code