MCP SERVER · OFFICIAL PROJECTRent a virtual phone number in a chosen country, wait for the SMS code, and read it back — without leaving the agent that needed the code.
LABSCO SUMMARY
Every call costs real balance, so the ordering is deliberate: check the price and availability for a country and service, then order, then poll. Numbers and services are addressed by name rather than by catalog ID, and an activation that never receives its SMS can be cancelled to get the reserved funds back.
A server over the Platfone API for temporary phone numbers. It runs the full activation lifecycle: price a country and service, order a number, poll for the SMS, then retry or cancel.
A Platfone account with funds, and an API key from https://platfone.com/app/api. Two transports from the same build: stdio via npx @platfone/mcp with PLATFONE_API_KEY set, or the hosted streamable-http endpoint https://mcp.platfone.com/mcp, where the key can travel in an x-api-key header instead. The published npm package is @platfone/mcp, currently 1.1.8. PLATFONE_API_URL overrides the API base — it is what points the server at the sandbox. Building from source needs Node.js 18 or newer.
One command plus a key — PLATFONE_API_KEY=<YOUR_PLATFONE_API_KEY> npx @platfone/mcp
USE CASES
Order a number for that country and service, then poll until the code arrives.
Price the country and service pair and see how many numbers are actually available.
Cancel the activation to release the number and the funds it was holding.
Request another SMS on the same activation — it costs nothing — then poll for the new message.
Read the balance: it separates total funds from the amount already reserved by active orders.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
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.
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 IDs.
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.
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.
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 as human-readable names or IDs — names are auto-resolved from the cached catalog. Use check_price first to verify cost and availability. Use check_sms with the activation_id to poll for incoming SMS. Only received messages are billed. IMPORTANT: Only call this tool once per order. Never call it multiple times in parallel — duplicate orders will be rejected.
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_sms every 5 seconds until sms_status becomes "retryReceived" or the activation expires.
BEFORE YOU INSTALL
6 tools when we connected. There is no tool to list countries or services; pass names like "Israel" or "Telegram" and the server resolves them. A hosted endpoint is also available at https://mcp.platfone.com/mcp.
Of the 7 documented setups, 4 run the server on your machine and 3 connect to a hosted endpoint.
CONTEXT COST
Rated by the size of the 6 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
PLATFONE_API_KEY=<YOUR_PLATFONE_API_KEY> npx @platfone/mcphttps://mcp.platfone.com/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
{
"mcpServers": {
"platfone": {
"command": "npx",
"args": [
"-y",
"@platfone/mcp"
],
"env": {
"PLATFONE_API_KEY": "<YOUR_PLATFONE_API_KEY>"
}
}
}
}<YOUR_PLATFONE_API_KEY> is your Platfone API key from platfone.com/app/api.
{
"mcpServers": {
"platfone": {
"type": "http",
"url": "https://mcp.platfone.com/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}<YOUR_PLATFONE_API_KEY> is your Platfone API key from platfone.com/app/api. This connects to the hosted endpoint; nothing runs locally.
{
"servers": {
"platfone": {
"command": "npx",
"args": [
"-y",
"@platfone/mcp"
],
"env": {
"PLATFONE_API_KEY": "<YOUR_PLATFONE_API_KEY>"
}
}
}
}Create .vscode/mcp.json in your workspace. <YOUR_PLATFONE_API_KEY> is your Platfone API key from platfone.com/app/api.
{
"servers": {
"platfone": {
"type": "http",
"url": "https://mcp.platfone.com/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}Create .vscode/mcp.json in your workspace. <YOUR_PLATFONE_API_KEY> is your Platfone API key from platfone.com/app/api.
{
"mcpServers": {
"platfone": {
"command": "npx",
"args": [
"-y",
"@platfone/mcp"
],
"env": {
"PLATFONE_API_KEY": "<YOUR_PLATFONE_API_KEY>"
}
}
}
}Edit ~/.codeium/windsurf/mcp_config.json. <YOUR_PLATFONE_API_KEY> is your Platfone API key from platfone.com/app/api.
{
"mcpServers": {
"platfone": {
"serverUrl": "https://mcp.platfone.com/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}Edit ~/.codeium/windsurf/mcp_config.json. <YOUR_PLATFONE_API_KEY> is your Platfone API key from platfone.com/app/api.
MCP servers
virtualsms-io
agentsimdev
Wavix
quackr-mcp