codasms-mcp

---

このサーバーを使うと、AI エージェント（Claude Desktop、Cursor、または MCP に対応するあらゆるクライアント）が、電話番号を購入し、プログラムから認証コードを読み取れます。公開されているCODASMS Reseller APIを薄くラップしたもので、独自のロジックは持ちません。すべての課金と返金は API 側で判断されます。

API キーはご自身で用意してください。無料で登録して取得できます：**https://codasms.com/reseller**。

ツール

ツール	機能
get_balance	現在の利用可能残高を取得します。
list_services	購入可能なサービスの、最新の価格と在庫を表示します（service／countryで絞り込み可能）。
list_countries	購入可能な番号がある国を表示します（serviceで絞り込み可能）。
get_number	サービスと国を指定して番号を購入します。残高から料金が差し引かれます（20 分以内にコードが届かない場合は自動返金されます）。
wait_for_otp	コードが届くまで（またはタイムアウト／返金まで）注文をポーリングします。
check_order	注文のステータスを一度だけ確認します。
release	注文をキャンセルして、ただちに返金します（コードがすでに届いている場合を除く）。

get_numberでは、オプションのmax_price_centsを指定する（またはCODASMS_MAX_PRICE_CENTSを設定する）ことで、自律型エージェントが上限を超える価格の番号を購入できないようにできます。

クイックスタート（ローカル／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は、Deno Deploy、Railway、Fly、任意のコンテナーで使用できるポータブルな Node サーバーです。Cloudflare Workers では、Node のhttpハンドラーをfetchハンドラーに置き換えてください。src/server.tsのサーバーファクトリーはトランスポートに依存しないため、変更せずに使えます。

設定

環境変数	用途	デフォルト
CODASMS_API_KEY	coda_live_形式の Reseller キー（stdio モード）。	—（必須）
CODASMS_API_BASE	API のベース URL。	https://api.codasms.com
CODASMS_MAX_PRICE_CENTS	get_numberの全体上限（米ドルのセント単位）。	未設定
PORT	HTTP モードのポート。	8080

注意事項

• レート制限： 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を参照してください。