platfone-com avatar

Platfone

platfone-com/mcp

Connects Claude to Platfone's virtual phone number API for programmatic SMS verification. Exposes six tools: check pricing and availability by country and service, order numbers in 200+ countries, poll for incoming SMS codes, retry or cancel activations. The server handles name resolution server-side so you can pass "Israel" and "Telegram" instead of numeric IDs. Useful when you're building agents that need to verify accounts, test signup flows, or automate anything requiring disposable phone numbers. Supports both stdio and HTTP transports. Requires a Platfone API key and sufficient account balance to rent numbers.

tools
6
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Apr 13, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

get_balanceReturns the current Platfone account balance: total available funds and the amount reserved by active orders. All values are in USD cents. Use this after a 402 error to inform the user how much they need to top up.

Returns the current Platfone account balance: total available funds and the amount reserved by active orders. All values are in USD cents. Use this after a 402 error to inform the user how much they need to top up.

No parameter schema in public metadata yet.

check_priceCheck pricing for a country + service pair before ordering. Returns min, max, and suggested price, average quality score, and number of available phone numbers. Use this before order_number to verify cost and availability. Accepts country and service as human-readable names or...3 params

Check pricing for a country + service pair before ordering. Returns min, max, and suggested price, average quality score, and number of available phone numbers. Use this before order_number to verify cost and availability. Accepts country and service as human-readable names or...

Parameters* required
countrystring
Country name or ID (e.g. 'us', 'United Kingdom').
max_priceinteger
Optional budget limit in USD cents. A warning is shown if the suggested price exceeds this.
servicestring
Service category name or ID from the Platfone catalog.
order_numberRent a virtual phone number via the Platfone API for the given country and service category. Returns phone number, activation_id, resolved country & service names, price, expiry time, retriable flag, and whether/when the activation can be canceled. Accepts country and service...4 params

Rent a virtual phone number via the Platfone API for the given country and service category. Returns phone number, activation_id, resolved country & service names, price, expiry time, retriable flag, and whether/when the activation can be canceled. Accepts country and service...

Parameters* required
countrystring
Country name or ID (e.g. 'us', 'United Kingdom').
max_priceinteger
Maximum price in USD cents you're willing to pay. Protects against price changes.
quality_factorinteger
Quality vs price preference: 0 = cheapest, 50 = balanced (default), 100 = highest quality.
servicestring
Service category name or ID from the Platfone catalog.
check_smsRetrieve the current state of a Platfone activation: SMS text, parsed code, status, and expiration. Can be used to poll periodically or check once on demand.1 params

Retrieve the current state of a Platfone activation: SMS text, parsed code, status, and expiration. Can be used to poll periodically or check once on demand.

Parameters* required
activation_idstring
Activation ID returned by order_number.
cancel_activationCancel a Platfone activation and release the phone number. Allowed when activation_status is "active", sms_status is "smsRequested", and the cancelable_after timestamp has passed. If cancelable_after is null, cancellation is not supported.1 params

Cancel a Platfone activation and release the phone number. Allowed when activation_status is "active", sms_status is "smsRequested", and the cancelable_after timestamp has passed. If cancelable_after is null, cancellation is not supported.

Parameters* required
activation_idstring
Activation ID to cancel.
retry_activationRequest an additional SMS on the same Platfone number. Overwrites the previous SMS data with the next message. Free of charge. Only possible when sms_status is "smsReceived" or "retryReceived", activation_status is "active", and is_retriable is true. After calling, poll check_...1 params

Request an additional SMS on the same Platfone number. Overwrites the previous SMS data with the next message. Free of charge. Only possible when sms_status is "smsReceived" or "retryReceived", activation_status is "active", and is_retriable is true. After calling, poll check_...

Parameters* required
activation_idstring
Activation ID to retry.

Sponsors

Configuration

PLATFONE_API_KEY*secret

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

Readme

Platfone MCP Server

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


View the full README on GitHub

Details

Repository
github.com/platfone-com/mcp
Category
Communication & Messaging
Package
@platfone/mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1stonematt avatarMcp Obsidian Clistonematt/mcp-obsidian-cliSave chat notes from Claude Desktop to your vault — MCP on Obsidian CLI. Keep what matters.2stars
2adelaidasofia avatarMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, tokenadelaidasofia/google-workspace-mcpMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token-efficient, macOS…1stars
3adelaidasofia avatarmacOS-only MCP server that exposes iMessage chatadelaidasofia/imessage-mcpmacOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…1stars
4getcoherence avatarMcpgetcoherence/mcp-serverCoherence MCP — chat with your CRM's AI agent from Claude, Cursor, and Cline.0stars
5mclose avatarDNS MCP Servermclose/dns-mcpReal-time DNS security analysis — DNSSEC, email auth, and RDAP. Built for SOC investigations.1stars
6shashwatgtm avatarImpact Mcpshashwatgtm/impact-mcpIMPACT: 8 B2B positioning and messaging tools by Helix GTM Consulting1stars