English Français العربية

io.github.ajemba/codasms-mcp

Registre officiel Sécurité

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package codasms-mcp
Claude Code 
claude mcp add codasms-mcp -e 'CODASMS_API_KEY=<your codasms_api_key>' -e 'CODASMS_MAX_PRICE_CENTS=<CODASMS_MAX_PRICE_CENTS>' -- npx -y codasms-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "codasms-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "codasms-mcp@0.1.1"
            ],
            "env": {
                "CODASMS_API_KEY": "<your codasms_api_key>",
                "CODASMS_MAX_PRICE_CENTS": "<CODASMS_MAX_PRICE_CENTS>"
            }
        }
    }
}

Variables d'environnement

  • CODASMS_API_KEY obligatoire secret Your coda_live_ reseller key from https://codasms.com/reseller
  • CODASMS_MAX_PRICE_CENTS Optional cap (US cents) — get_number refuses numbers priced above this.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. CODASMS MCP Server
  2. Tools
  3. Quick start (local / stdio)
  4. Remote (HTTP) mode
  5. Configuration
  6. Notes
  7. Develop
  8. License

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

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)

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

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

License

MIT — see LICENSE.

Questions fréquentes

Qu'est-ce que io.github.ajemba/codasms-mcp ?

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

Comment installer io.github.ajemba/codasms-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add codasms-mcp -e 'CODASMS_API_KEY=<your codasms_api_key>' -e 'CODASMS_MAX_PRICE_CENTS=<CODASMS_MAX_PRICE_CENTS>' -- npx -y codasms-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ajemba/codasms-mcp ?

Oui. Il attend CODASMS_API_KEY, à renseigner dans sa configuration.

io.github.ajemba/codasms-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ajemba/codasms-mcp ?

Il est publié par ajemba. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.