Allows an AI agent to purchase phone numbers and programmatically receive one-time SMS or OTP verification codes.
Also known as ajemba/codasms-mcp
- Stars
- 0
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Oct 24, 2026
- License
- MIT
What is CODASMS MCP?
CODASMS allows an AI agent to purchase phone numbers and programmatically receive one-time SMS or OTP verification codes. It exposes 7 tools, such as get_balance, list_services, list_countries.
Summary generated from the project's README
About CODASMS MCP server
Automating the acquisition of phone numbers and reading verification codes is what this server enables for AI agents using Claude Desktop or Cursor. It acts as a thin wrapper for the CODASMS Reseller API, allowing users to purchase numbers across 180 countries and 700 services. Developers can run this locally via stdio or host it remotely using HTTP mode to serve multiple users who provide their own API keys as bearer tokens.
Users manage their spending through specific tools like get_balance and list_services, which shows live pricing and stock. To prevent unexpected costs, you can set a CODASMS_MAX_PRICE_CENTS environment variable to cap what an autonomous agent can spend. The system handles financial safety by automatically refunding the balance if a code does not arrive within 20 minutes, or you can manually trigger a refund using the release tool. The server supports polling for incoming messages with wait_for_otp while staying within the API rate limit of 60 requests per minute.
What you can do with it
- 1Automated service registrationAn AI agent can purchase a specific phone number and retrieve the required SMS verification code for a new account.
- 2Remote agent integrationYou can host a single instance of the server to provide SMS capabilities to many different users via HTTP.
Written from the project's README. Every use case is checked against a quote from it.
How to install CODASMS MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall CODASMS MCP in Claude Code
$ claude mcp add --env 'CODASMS_API_KEY=<YOUR_CODASMS_API_KEY>' codasms-mcp -- npx -y codasms-mcpInstall CODASMS MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codasms-mcp": {
"command": "npx",
"args": [
"-y",
"codasms-mcp"
],
"env": {
"CODASMS_API_KEY": "<YOUR_CODASMS_API_KEY>"
}
}
}
}Install CODASMS MCP in VS Code
.vscode/mcp.json
{
"servers": {
"codasms-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codasms-mcp"
],
"env": {
"CODASMS_API_KEY": "<YOUR_CODASMS_API_KEY>"
}
}
}
}Install CODASMS MCP in VS Code CLI
$ code --add-mcp '{"name":"codasms-mcp","type":"stdio","command":"npx","args":["-y","codasms-mcp"],"env":{"CODASMS_API_KEY":"<YOUR_CODASMS_API_KEY>"}}'Install CODASMS MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codasms-mcp": {
"command": "npx",
"args": [
"-y",
"codasms-mcp"
],
"env": {
"CODASMS_API_KEY": "<YOUR_CODASMS_API_KEY>"
}
}
}
}Install CODASMS MCP in Codex
$ codex mcp add codasms-mcp --env 'CODASMS_API_KEY=<YOUR_CODASMS_API_KEY>' -- npx -y codasms-mcpInstall CODASMS MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.codasms-mcp] command = "npx" args = ["-y", "codasms-mcp"] [mcp_servers.codasms-mcp.env] CODASMS_API_KEY = "<YOUR_CODASMS_API_KEY>"
Install CODASMS MCP in Gemini CLI
$ gemini mcp add -s user -e 'CODASMS_API_KEY=<YOUR_CODASMS_API_KEY>' codasms-mcp npx -- -y codasms-mcpInstall CODASMS MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codasms-mcp": {
"command": "npx",
"args": [
"-y",
"codasms-mcp"
],
"env": {
"CODASMS_API_KEY": "<YOUR_CODASMS_API_KEY>"
}
}
}
}CODASMS MCP tools 7
Detected from the READMEget_balancelist_serviceslist_countriesget_numberwait_for_otpcheck_orderrelease
| get_balance | — | |
| list_services | — | |
| list_countries | — | |
| get_number | — | |
| wait_for_otp | — | |
| check_order | — | |
| release | — |
Configuration
CODASMS_API_KEYRequiredSecretYour coda_live_ reseller key from https://codasms.com/reseller
CODASMS_MAX_PRICE_CENTSOptional cap (US cents) — get_number refuses numbers priced above this.
| Name | Description | |
|---|---|---|
| CODASMS_API_KEY | Your coda_live_ reseller key from https://codasms.com/reseller | RequiredSecret |
| CODASMS_MAX_PRICE_CENTS | Optional cap (US cents) — get_number refuses numbers priced above this. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubCODASMS 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 |
|---|---|
get_balance |
Your current spendable balance. |
list_services |
Buyable services with live price + stock (filter by service / country). |
list_countries |
Countries with buyable numbers (optional service filter). |
get_number |
Buy a number for a service+country. Charges your balance (auto-refunds if no code in 20 min). |
wait_for_otp |
Poll an order until the code arrives (or timeout / refund). |
check_order |
One-shot status check for an order. |
release |
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.
Quick start (local / stdio)
export CODASMS_API_KEY=coda_live_xxxxxxxx # from https://codasms.com/reseller
npx codasms-mcp
Claude 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 /mcp
POST /mcp
Authorization: Bearer coda_live_xxxxxxxx
Content-Type: application/json
src/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 |
|---|---|---|
CODASMS_API_KEY |
Your coda_live_ reseller key (stdio mode). |
— (required) |
CODASMS_API_BASE |
API base URL. | https://api.codasms.com |
CODASMS_MAX_PRICE_CENTS |
Global cap for get_number, in US cents. |
unset |
PORT |
HTTP mode port. | 8080 |
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 # stdio
License
MIT — see LICENSE.
CODASMS MCP questions
How do I add CODASMS MCP to Claude Code?
Run claude mcp add --env 'CODASMS_API_KEY=<YOUR_CODASMS_API_KEY>' codasms-mcp -- npx -y codasms-mcp in your terminal. Add --scope user to make it available in every project.
How do I add CODASMS MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does CODASMS MCP provide?
It exposes 7 tools, including get_balance, list_services, list_countries, get_number, wait_for_otp.