Skip to main content
Glama
codasms-mcp

codasms-mcp

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.

License: MIT  Transport: stdio + HTTP  ajemba/codasms-mcp MCP server  CODASMS MCP on mcprush


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.

Related MCP server: botcall-mcp

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_otp polls no faster than once every 5s by default to stay well under it.

  • Money safety: get_number spends real balance the moment it's called. If no code arrives, the order auto-refunds after 20 minutes, or call release to refund immediately.

  • Codes: services and countries use the API's codes (e.g. tg, wa, country 6) — use list_services / list_countries to discover them.

Develop

npm install
npm run build      # tsc -> dist/
npm start          # stdio

License

MIT — see LICENSE.

Available Tools

7 tools
check_orderCheck an orderA
Read-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 balanceA
Read-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 countriesA
Read-only

List countries that currently have buyable numbers. Optionally filter to a single service.

Inputs: limit, service.

list_servicesList servicesA
Read-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 numberA
DestructiveIdempotent

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 codeA
Read-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

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers