Codasms Mcp

io.github.ajembaPublished by GitHub account ajembav0.1.1Updated Oct 24, 2026

Receive one-time SMS/OTP verification codes via the CODASMS API: get a number, wait, release.

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Lets an assistant buy a disposable phone number through CODASMS and read the incoming SMS/OTP verification code.

What you can do
  • Check account balance and browse buyable services and countries with live price and stock
  • Buy a number for a chosen service and country, which charges the reseller balance
  • Poll an order until the verification code arrives, or check its status once
  • Release an order to cancel it and get an immediate refund
When to use it
Useful when an assistant needs to complete a sign-up or login flow that requires an SMS one-time code, and you are willing to pay per delivered code from a CODASMS reseller account.
Requirements
Runs locally over stdio via npx (Node.js). Requires a CODASMS reseller API key supplied in the CODASMS_API_KEY environment variable, plus network access to the CODASMS API. Optional CODASMS_MAX_PRICE_CENTS caps the price of numbers bought.
Before you install
get_number spends real money from your CODASMS balance as soon as it is called; set CODASMS_MAX_PRICE_CENTS so an autonomous agent cannot overspend. The API key is a billing credential and should be kept out of shared configs. Orders, refunds and codes are handled by the third-party CODASMS service, and the API rate limit is 60 requests per minute per key.

Installation

In SourceWeft

  1. Open Codasms Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolWhat it does
get_balanceYour current spendable balance.
list_servicesBuyable services with live price + stock (filter by service / country).
list_countriesCountries with buyable numbers (optional service filter).
get_numberBuy a number for a service+country. Charges your balance (auto-refunds if no code in 20 min).
wait_for_otpPoll an order until the code arrives (or timeout / refund).
check_orderOne-shot status check for an order.
releaseCancel 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)

bash
export CODASMS_API_KEY=coda_live_xxxxxxxx   # from https://codasms.com/resellernpx codasms-mcp

Claude Desktop

Add to claude_desktop_config.json:

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):

bash
npm run build && npm run start:http     # listens on :8080, POST /mcp
POST /mcpAuthorization: Bearer coda_live_xxxxxxxxContent-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 varPurposeDefault
CODASMS_API_KEYYour coda_live_ reseller key (stdio mode).— (required)
CODASMS_API_BASEAPI base URL.https://api.codasms.com
CODASMS_MAX_PRICE_CENTSGlobal cap for get_number, in US cents.unset
PORTHTTP 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

bash
npm installnpm run build      # tsc -> dist/npm start          # stdio

License

MIT — see LICENSE.

Source: README.md at commit 6ec9d54

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts