Skip to main content
Glama
ajemba

codasms-mcp

CODASMS MCP Server

Empfange einmalige SMS/OTP-Verifizierungscodes von deinem KI-Agenten. Ein MCP-Server über die CODASMS-Reseller-API – eine Nummer holen, auf den Code warten, freigeben – in über 700 Diensten und 180+ Ländern, zahle nur bei Zustellung.

License: MIT Transport: stdio + HTTP


Dieser Server ermöglicht es einem KI-Agenten (Claude Desktop, Cursor oder allem, was MCP spricht), eine Telefonnummer zu kaufen und den Verifizierungscode programmatisch auszulesen. Er ist ein dünner Wrapper um die öffentliche CODASMS-Reseller-API – er enthält keine eigene Logik; jede Belastung und Rückerstattung wird serverseitig von der API entschieden.

Du bringst deinen eigenen Schlüssel mit. Die Anmeldung ist kostenlos: https://codasms.com/reseller.

Tools

Tool

Funktion

get_balance

Dein aktuell verfügbares Guthaben.

list_services

Kaufbare Dienste mit Live-Preis + Bestand (Filter nach service / country).

list_countries

Länder mit kaufbaren Nummern (optionaler service-Filter).

get_number

Kaufe eine Nummer für einen Dienst+Land. Belastet dein Guthaben (automatische Rückerstattung, wenn in 20 Minuten kein Code eintrifft).

wait_for_otp

Pollt eine Bestellung, bis der Code eintrifft (oder Timeout / Rückerstattung).

check_order

Einmalige Statusprüfung für eine Bestellung.

release

Bestellung stornieren und sofort erstatten (sofern der Code nicht bereits eingetroffen ist).

get_number akzeptiert ein optionales max_price_cents (oder setze CODASMS_MAX_PRICE_CENTS), damit ein autonomer Agent keine Nummer kaufen kann, die über deinem Limit liegt.

Related MCP server: agentline-mcp

Schnellstart (lokal / stdio)

export CODASMS_API_KEY=coda_live_xxxxxxxx   # from https://codasms.com/reseller
npx codasms-mcp

Claude Desktop

Füge zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "codasms": {
      "command": "npx",
      "args": ["-y", "codasms-mcp"],
      "env": { "CODASMS_API_KEY": "coda_live_xxxxxxxx" }
    }
  }
}

Dann frag: „Hol mir eine Telegram-Nummer in Großbritannien und lies den Code."

Remote-Modus (HTTP)

Die gleichen Tools werden über Streamable HTTP bereitgestellt, sodass du eine Instanz für viele Benutzer hosten kannst – jeder sendet seinen eigenen Schlüssel als Bearer-Token (nichts wird serverseitig gespeichert):

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 ist ein portabler Node-Server (Deno Deploy, Railway, Fly, jeder Container). Für Cloudflare Workers tausche den Node-http-Handler gegen einen fetch-Handler – die Server-Factory in src/server.ts ist transportunabhängig und bleibt unverändert.

Konfiguration

Env var

Zweck

Standard

CODASMS_API_KEY

Dein coda_live_-Reseller-Schlüssel (stdio-Modus).

— (erforderlich)

CODASMS_API_BASE

API-Basis-URL.

https://api.codasms.com

CODASMS_MAX_PRICE_CENTS

Globales Limit für get_number, in US-Cent.

nicht gesetzt

PORT

Port für den HTTP-Modus.

8080

Hinweise

  • Ratenlimit: Die API erlaubt 60 Anfragen/Minute pro Schlüssel; wait_for_otp pollt standardmäßig nicht schneller als einmal alle 5 Sekunden, um deutlich darunter zu bleiben.

  • Geldsicherheit: get_number gibt echtes Guthaben aus, sobald es aufgerufen wird. Wenn kein Code eintrifft, wird die Bestellung nach 20 Minuten automatisch erstattet, oder rufe release auf, um sofort zu erstatten.

  • Codes: Dienste und Länder verwenden die Codes der API (z. B. tg, wa, Land 6) – nutze list_services / list_countries, um sie zu entdecken.

Entwicklung

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

Lizenz

MIT – siehe LICENSE.

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Real SIM-backed mobile numbers for AI agents to receive SMS and OTP codes.

  • Virtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.

  • Real physical SIMs for AI agents: SMS verification and rentals. 145+ countries, 2500+ services.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ajemba/codasms-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server