CODASMS MCP Server

AIエージェントでワンタイムSMS/OTP認証コードを受信します。 CODASMSリセラーAPIを利用したMCPサーバーです。番号を取得し、コードを待ち、解放するまでを700以上のサービス・180以上の国で対応。配信時のみ課金されます。

このサーバーを使用すると、AIエージェント（Claude Desktop、Cursor、またはMCPに対応した任意のツール）が電話番号を購入し、認証コードをプログラムで読み取ることができます。これは公開されているCODASMS Reseller APIの薄いラッパーであり、独自のロジックは一切持ちません。すべての請求と返金は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で提供されるため、1つのインスタンスを複数ユーザー向けにホストできます。各ユーザーは自身のキーを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秒に1回より速くポーリングしないため、制限を十分に下回ります。

• 料金の安全策: get_number は呼び出した瞬間に実際の残高を消費します。コードが届かない場合は、20分後に自動返金されるか、release を呼び出すと即座に返金されます。

• コード: サービスと国はAPIのコードを使用します（例: tg、wa、国コード 6）。それらを見つけるには list_services / list_countries を使用してください。

開発

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

ライセンス

MIT — LICENSE を参照してください。