CODASMS MCP Server

Получайте одноразовые SMS/OTP-коды подтверждения от вашего ИИ-агента. Сервер MCP поверх CODASMS Reseller API — получите номер, дождитесь кода, освободите его — 700+ сервисов и 180+ стран, оплата только за доставку.

Этот сервер позволяет ИИ-агенту (Claude Desktop, Cursor или любому инструменту, говорящему на MCP) купить номер телефона и программно прочитать код подтверждения. Это тонкая обёртка над публичным CODASMS Reseller API — в нём нет собственной логики; каждое списание и возврат решаются на стороне API.

Вы используете свой собственный ключ. Получить его можно бесплатно — достаточно зарегистрироваться: https://codasms.com/reseller.

Инструменты

get_number принимает необязательный max_price_cents (или установите CODASMS_MAX_PRICE_CENTS), чтобы автономный агент не мог купить номер дороже вашего лимита.

Related MCP server: agentline-mcp

Быстрый старт (локально / stdio)

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

Claude Desktop

Добавьте в claude_desktop_config.json:

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

Затем попросите: «Получи мне номер Telegram в Великобритании и прочитай код».

Удалённый режим (HTTP)

Те же инструменты доступны через Streamable HTTP, поэтому вы можете развернуть один экземпляр для многих пользователей — каждый отправляет свой собственный ключ в виде Bearer-токена (ничего не хранится на стороне сервера):

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 — это портативный Node-сервер (Deno Deploy, Railway, Fly, любой контейнер). Для Cloudflare Workers замените Node-обработчик http на обработчик fetch — фабрика сервера в src/server.ts не зависит от транспорта и остаётся без изменений.

Конфигурация

Примечания

• Ограничение частоты запросов: API допускает 60 запросов/мин на ключ; wait_for_otp по умолчанию опрашивает не чаще одного раза в 5 секунд, чтобы оставаться значительно ниже лимита.

• Безопасность средств: get_number списывает реальные средства с баланса в момент вызова. Если код не приходит, заказ автоматически возвращается через 20 минут, или вызовите release, чтобы вернуть средства немедленно.

• Коды: сервисы и страны используют коды API (например, tg, wa, страна 6) — используйте list_services / list_countries, чтобы узнать их.

Разработка

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

Лицензия

MIT — см. LICENSE.