CODASMS MCP Server

Recibe códigos de verificación SMS/OTP de un solo uso desde tu agente de IA. Un servidor MCP sobre la API CODASMS Reseller: consigue un número, espera el código, libéralo, en más de 700 servicios y 180+ países, paga solo al recibirlo.

Este servidor permite que un agente de IA (Claude Desktop, Cursor o cualquier cosa que hable MCP) compre un número de teléfono y lea el código de verificación mediante programación. Es una capa fina sobre la API pública de CODASMS Reseller: no contiene lógica propia; cada cargo y reembolso lo decide la API en el servidor.

Tú aportas tu propia clave. Obtener una es gratis al registrarte: https://codasms.com/reseller.

Herramientas

get_number acepta un max_price_cents opcional (o define CODASMS_MAX_PRICE_CENTS) para que un agente autónomo no pueda comprar un número con un precio superior a tu límite.

Related MCP server: agentline-mcp

Inicio rápido (local / stdio)

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

Claude Desktop

Añade a claude_desktop_config.json:

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

Luego pide: "Consígueme un número de Telegram en el Reino Unido y lee el código."

Modo remoto (HTTP)

Las mismas herramientas se sirven a través de Streamable HTTP, por lo que puedes alojar una instancia para muchos usuarios: cada uno envía su propia clave como token Bearer (no se almacena nada en el servidor):

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 es un servidor Node portátil (Deno Deploy, Railway, Fly, cualquier contenedor). Para Cloudflare Workers, sustituye el manejador http de Node por un manejador fetch: la fábrica de servidores en src/server.ts es independiente del transporte y permanece sin cambios.

Configuración

Notas

• Límite de peticiones: la API permite 60 solicitudes/min por clave; wait_for_otp no consulta más de una vez cada 5 s por defecto para mantenerse muy por debajo de ese límite.

• Seguridad del dinero: get_number gasta saldo real en el momento en que se llama. Si no llega ningún código, el pedido se reembolsa automáticamente después de 20 minutos, o llama a release para reembolsar de inmediato.

• Códigos: los servicios y países usan los códigos de la API (p. ej. tg, wa, país 6) — usa list_services / list_countries para descubrirlos.

Desarrollo

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

Licencia

MIT — consulta LICENSE.