Codasms Mcp

io.github.ajemba由 GitHub 帳號 ajemba 發布v0.1.1更新於 Oct 24, 2026

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

已驗證STDIO僅桌面溝通與協作商業與電商

概覽

AI 產生的概覽

讓助理透過 CODASMS 購買一次性手機號碼並讀取收到的簡訊/OTP 驗證碼。

可以做什麼
  • 查詢帳戶餘額，瀏覽可購買的服務與國家及即時價格和庫存
  • 依服務與國家購買號碼，會從經銷商餘額扣款
  • 輪詢訂單直到驗證碼送達，或單次查詢訂單狀態
  • 釋放訂單以取消並立即退款
適用情境
當助理需要完成要求簡訊一次性驗證碼的註冊或登入流程，且你願意透過 CODASMS 經銷商帳戶依成功送達的驗證碼付費時使用。
執行需求
透過 npx 以 stdio 在本機執行（需要 Node.js）。需要 CODASMS 經銷商 API 金鑰，以環境變數 CODASMS_API_KEY 提供，並需要連線至 CODASMS API 的網路。可選 CODASMS_MAX_PRICE_CENTS 用來限制購號價格上限。
安裝前請注意
呼叫 get_number 會立即從 CODASMS 餘額扣除真實費用；建議設定 CODASMS_MAX_PRICE_CENTS，避免自主運作的助理超支。API 金鑰屬於計費憑證，不應寫入共用設定。訂單、退款與驗證碼皆由第三方 CODASMS 服務處理，每個金鑰的 API 限速為每分鐘 60 次請求。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Codasms Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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.

來源：README.md，提交 6ec9d54

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分