codasms-mcp
You can use this MCP server to buy virtual phone numbers and retrieve SMS/OTP verification codes programmatically via the CODASMS API.
Check your reseller account balance.
List available services and countries, optionally filtered, with live price and stock.
Purchase a number for a service and country, with optional price caps and priority delivery tier.
Wait for an incoming OTP code by polling an order.
Check an order's status once, including whether a code has arrived.
Release/cancel an order to refund immediately when eligible, or rely on automatic refund if no code arrives within 20 minutes.
Allows AI agents to purchase a temporary phone number for Telegram, wait for and receive one-time SMS/OTP verification codes, and release or refund the number through the CODASMS API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@codasms-mcp Get me a Telegram number in the UK and read the code."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CODASMS MCP Server
Receive one-time SMS/OTP verification codes from your AI agent. An MCP server over the CODASMS Reseller API — get a number, wait for the code, release it — across 700+ services and 180+ countries, pay only on delivery.
This server lets an AI agent (Claude Desktop, Cursor, or anything that speaks MCP) buy a phone number and read the verification code programmatically. It's a thin wrapper over the public CODASMS Reseller API — it holds no logic of its own; every charge and refund is decided server-side by the API.
You bring your own key. Getting one is free to sign up: https://codasms.com/reseller.
Tools
Tool | What it does |
| Your current spendable balance. |
| Buyable services with live price + stock (filter by |
| Countries with buyable numbers (optional |
| Buy a number for a service+country. Charges your balance (auto-refunds if no code in 20 min). |
| Poll an order until the code arrives (or timeout / refund). |
| One-shot status check for an order. |
| Cancel an order and refund now (unless the code already arrived). |
get_number accepts an optional max_price_cents (or set CODASMS_MAX_PRICE_CENTS) so an
autonomous agent can't buy a number priced above your cap.
Related MCP server: botcall-mcp
Quick start (local / stdio)
export CODASMS_API_KEY=coda_live_xxxxxxxx # from https://codasms.com/reseller
npx codasms-mcpClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"codasms": {
"command": "npx",
"args": ["-y", "codasms-mcp"],
"env": { "CODASMS_API_KEY": "coda_live_xxxxxxxx" }
}
}
}Then ask: "Get me a Telegram number in the UK and read the code."
Remote (HTTP) mode
The same tools are served over Streamable HTTP, so you can host one instance for many users — each sends their own key as a Bearer token (nothing is stored server-side):
npm run build && npm run start:http # listens on :8080, POST /mcpPOST /mcp
Authorization: Bearer coda_live_xxxxxxxx
Content-Type: application/jsonsrc/http.ts is a portable Node server (Deno Deploy, Railway, Fly, any container). For
Cloudflare Workers, swap the Node http handler for a fetch handler — the server factory in
src/server.ts is transport-agnostic and stays unchanged.
Configuration
Env var | Purpose | Default |
| Your | — (required) |
| API base URL. |
|
| Global cap for | unset |
| HTTP mode port. |
|
Notes
Rate limit: the API allows 60 requests/min per key;
wait_for_otppolls no faster than once every 5s by default to stay well under it.Money safety:
get_numberspends real balance the moment it's called. If no code arrives, the order auto-refunds after 20 minutes, or callreleaseto refund immediately.Codes: services and countries use the API's codes (e.g.
tg,wa, country6) — uselist_services/list_countriesto discover them.
Develop
npm install
npm run build # tsc -> dist/
npm start # stdioLicense
MIT — see LICENSE.
Available Tools
7 toolscheck_orderCheck an orderARead-only
One-shot status check for an order (no waiting). Returns the current status and the code if it has arrived.
Inputs: order_id (required).
get_balanceGet balanceARead-only
Return the reseller account's current balance (what you can spend on numbers).
Inputs: no named parameters.
get_numberGet a numberA
Buy a phone number for a service in a country and return it. THIS CHARGES the reseller balance immediately (pay-per-code). If no code arrives within 20 minutes the order auto-refunds; you can also release() it early to refund now. Poll for the code with wait_for_otp using the returned order_id.
Inputs: country (required), service (required), band, max_price_cents.
list_countriesList countriesARead-only
List countries that currently have buyable numbers. Optionally filter to a single service.
Inputs: limit, service.
list_servicesList servicesARead-only
List buyable services with live price and stock. STRONGLY prefer filtering by service and/or country — the unfiltered catalog is very large. service is a code like "tg" (Telegram); country is a country code like "6".
Inputs: limit, country, service.
releaseRelease (cancel & refund) a numberADestructiveIdempotent
Cancel an order and refund its cost immediately — unless the code already arrived, in which case there is nothing to refund and the code is returned.
Inputs: order_id (required).
wait_for_otpWait for the OTP codeARead-only
Poll an order until its verification code arrives, it expires, or the timeout is hit. Returns the code when delivered. On timeout the number is still active — call again, or release() to refund now.
Inputs: order_id (required), timeout_seconds, poll_interval_seconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct operation: account balance, catalog lookup, country lookup, purchasing a number, waiting for an OTP, checking an order, and releasing/refunding. The only similar pair is wait_for_otp and check_order, but their descriptions clearly separate polling from one-shot checks.
Tool names follow a consistent lowercase verb-first pattern: get_balance, list_services, list_countries, get_number, wait_for_otp, check_order, release. All use snake_case and clear action-oriented verbs, with release being the only slightly less descriptive name.
Seven tools cover the core SMS activation workflow without unnecessary additions. The scope is well-matched to the server's purpose: balance, catalog, purchase, OTP retrieval, status checks, and refunds.
The server covers the essential lifecycle: check balance, browse services/countries, buy a number, wait for or check the code, and release/refund. A minor gap is the lack of a way to list all active orders or recover an order without its ID, but agents can work around this with check_order and wait_for_otp using the returned order_id.
Maintenance
Related MCP Connectors
Virtual phone numbers and SMS verification codes for AI agents: 800+ services, 200+ countries.
Rent real and virtual phone numbers in 14 countries and read their SMS from your AI agent.
SMS verification for AI agents: buy a number, get the code, cancel with refund. Free sandbox.
Phone numbers for AI agents: SMS verification codes and rented numbers that receive SMS.
Related MCP Servers
- AlicenseAqualityBmaintenanceVirtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle.662 npm4MIT
- AlicenseAqualityDmaintenanceGives AI agents real phone numbers to receive SMS and extract verification codes through tool calls.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to purchase virtual phone numbers, retrieve SMS verification codes, and manage activations through natural language by wrapping the VirtualSMS Consumer API.6 npmMIT

VoidMob MCPofficial
AlicenseAqualityBmaintenancePhone numbers, mobile IPs and eSIMs for your AI agent.28181 npm22MIT