Unclaimed Sol Scanner

Unclaimed SOL MCP

初のVibe Claiming MCPサーバーです。AIエージェントでSolana上の休眠中のSOLをスキャンして回収できます。

Unclaimed SOL MCPは、初のVibe Claiming MCPサーバーです。1つのサーバーで6種類の回収に対応します。休眠中のトークンアカウント（Token-2022を含む）、スパムNFT、プログラムバッファー、非アクティブ化されたステーク、DeFi報酬、余剰lamportsが対象です。読み取り専用のスキャンは設定不要で、回収にはドライランプレビュー、60秒間有効な使い捨て実行トークン、ローカル署名を使用します。キーペアがマシンの外に出ることはありません。シードフレーズは一切不要です。

UnclaimedSOL向けのMCPサーバーです。AIエージェントやアシスタント（Claude、Cursor、Windsurf、Codex CLI、およびあらゆるModel Context Protocolクライアントで利用できます）。

こちらもご覧ください：

• セキュリティモデル
• 変更履歴
• npmパッケージ
• UnclaimedSOLのウェブサイト

エージェントに選ばれる理由

• 使うだけでなく、獲得する — Solanaのエージェントはネットワーク手数料を支払いますが、ウォレットには古いアカウント、バッファー、ステーク、報酬に回収可能なSOLが残っている場合もあります。
• 初期設定から安全 — 読み取り専用のスキャンモードは設定不要で利用できます。回収にはドライランと60秒間有効な使い捨て実行トークンが必要です。
• ローカル署名 — シードフレーズは不要です。トランザクションの署名前にプログラム許可リストの検証と手数料上限の確認を行います。
• エージェント対応 — Claude Desktop/Code、Cursor、Windsurf、Codex CLIなどのMCPクライアントで利用できます。

対応範囲

2026年7月時点の対応状況：

機能	一般的なトークンアカウントクリーナー	Unclaimed SOL MCP
休眠中のトークンアカウント	はい	はい。Token-2022を含む
スパムNFT	場合による	はい
プログラムバッファー	まれ	はい
非アクティブ化されたステーク	まれ	はい
DeFi報酬	まれ	はい
余剰lamports	まれ	はい
設定不要の読み取り専用スキャンモード	場合による	はい
キーペアファイルのオプション	場合による	はい。SOLANA_KEYPAIR_PATHで指定

できること

Solanaウォレットには、休眠中のトークンアカウント（Token-2022を含む）、スパムNFT、プログラムバッファーアカウント、非アクティブ化されたステーク、DeFi報酬、余剰lamportsに、賃料としてロックされたSOLが蓄積します。このMCPサーバーを使うと、AIエージェントやアシスタントで以下を実行できます。

• スキャン — 任意のウォレットを調べ、休眠中のトークンアカウントやプログラムバッファーに回収可能なSOLがあるか確認します。
• 回収（Vibe Claiming） — 価値のないトークン残高をバーンし、休眠中のアカウントを閉鎖して、賃料分のSOLを回収します。UnclaimedSOLのオンチェーンプログラムを介して、トランザクションにローカルで署名し、ブロードキャストします。トークンのクリーンアップでは、閉鎖したアカウントごとに最大0.002 SOLをユーザーが保持できます。バッファーには5%の手数料がかかります。
• 報酬を請求 — 未回収のDeFi報酬（キャッシュバック、クリエイター手数料など）を請求します。Pump/PumpSwapは3%で、上限は1 SOLまたは100 USDCです。その他の報酬は15%です。
• ステークを請求 — 非アクティブ化されたステークアカウントからSOLを請求します。手数料は3%です。

手数料

カテゴリー	手数料
スキャン	無料
トークンのクリーンアップ	閉鎖したアカウントごとに最大0.002 SOLをユーザーが保持
プログラムバッファー	5%
DeFi報酬	一般：15%
Pump/PumpSwapの報酬	3%。上限は1 SOL / 100 USDC
非アクティブ化されたステーク	3%

資金がMCPサーバーを経由することはありません。

ツール

scan_claimable_sol

アノテーションタイトル： ウォレットの請求可能な SOL をスキャン

休眠中のトークンアカウント（Token-2022 を含む）とプログラムのバッファアカウントにロックされている SOL をスキャンします。読み取り専用のため、トランザクションもキーペアも必要ありません。DeFi 報酬と無効化されたステークは、claim_rewards と claim_stakes のドライランで検出されます。

入力： wallet_address（base58 公開鍵。請求機能を有効にしたモードでは省略可能で、設定済みのキーペアのウォレットがデフォルトになります）

claim_sol

アノテーションタイトル： 休眠中の SOL を請求（Vibe Claiming）

回収可能な SOL を請求します。設定済みのキーペアが必要です。次の 2 ステップのフローを使用します。

1. ドライラン（デフォルト）— 回収可能なアカウント、推定 SOL 数、手数料、トランザクション数の内訳を表示します。有効期間が 60 秒の使い捨て execution_token を返します。
2. 実行 — dry_run: false と execution_token を指定して再度呼び出し、署名してブロードキャストします。

入力： wallet_address（請求機能を有効にしたモードでは省略可能で、設定済みのキーペアのウォレットがデフォルトになります）、dry_run（デフォルトは true）、execution_token、max_transactions（デフォルトは 10）、exclude（実行時にスキップするトークンシンボルまたは名前。省略可能）

この操作は取り消せません。閉鎖されたアカウントは復元できません。

claim_rewards

アノテーションタイトル： DeFi 報酬を請求

未収の DeFi 報酬（キャッシュバック、クリエイター手数料など）を請求します。設定済みのキーペアが必要です。claim_sol と同じ 2 ステップのドライラン／実行フローを使用します。Pump／PumpSwap は 3％で、上限は 1 SOL または 100 USDC です。その他の報酬は 15％です。

入力： wallet_address（請求機能を有効にしたモードでは省略可能で、設定済みのキーペアのウォレットがデフォルトになります）、dry_run（デフォルトは true）、execution_token

claim_stakes

アノテーションタイトル： 無効化されたステークを請求

無効化されたステークアカウントから SOL を請求します。設定済みのキーペアが必要です。同じ 2 ステップのドライラン／実行フローを使用します。請求する特定のステークアカウントのアドレスを指定することもできます。

入力： wallet_address（請求機能を有効にしたモードでは省略可能で、設定済みのキーペアのウォレットがデフォルトになります）、dry_run（デフォルトは true）、execution_token、stake_accounts（省略可能な配列）

プロンプトの例

• 「回収可能な SOL があるかウォレットをスキャンして」
• 「回収できる SOL はどれくらいある？」
• 「請求できるものを確認するためにドライランして」
• 「休眠中のトークンアカウントを請求して」
• 「ウォレットの報酬を請求して」
• 「無効化されたステークを請求して」
• 「<wallet_address> から回収できる SOL はどれくらいある？」
• 「<wallet_address> をスキャンして、回収可能な SOL を確認して」
• 「毎朝ウォレットをスキャンして、回収できる SOL が 0.05 SOL を超えていたら教えて」
• 「請求全体のドライランを実行して、実行前に手数料の内訳を表示して」
• 「BONK アカウント以外をすべて請求して」

セットアップ

前提条件

• Node.js 18+
• npm

クイックインストール（推奨）

MCP クライアントがパッケージコマンドに対応している場合、クローンやビルドは不要です。

npx -y @unclaimed-sol/mcp

インストールとビルド（別の方法）

git clone https://github.com/unclaimed-sol/unclaimed-sol-mcp.git && cd unclaimed-sol-mcp
npm install
npm run build

設定

Vibe Claiming モード（推奨）

すべてのツール（scan_claimable_sol、claim_sol、claim_rewards、claim_stakes）が公開されます。トランザクションはキーペアを使ってローカルで署名され、Solana ネットワークにブロードキャストされます。

Claude Desktop ／ Cursor ／ Windsurf の場合

npm パッケージを使用（推奨）：

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "npx",
      "args": ["-y", "@unclaimed-sol/mcp"],
      "env": {
        "SOLANA_KEYPAIR_PATH": "~/.config/solana/id.json",
        "SOLANA_RPC_URL": "https://your-rpc-provider.com"
      }
    }
  }
}

ローカルビルドを使用：

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "node",
      "args": ["/absolute/path/to/unclaimed-sol-mcp/dist/index.js"],
      "env": {
        "SOLANA_KEYPAIR_PATH": "~/.config/solana/id.json",
        "SOLANA_RPC_URL": "https://your-rpc-provider.com"
      }
    }
  }
}

Claude Code の場合

npm パッケージを使用（推奨）：

claude mcp add unclaimed-sol \
  -e SOLANA_KEYPAIR_PATH=~/.config/solana/id.json \
  -e SOLANA_RPC_URL=https://your-rpc-provider.com \
  -- npx -y @unclaimed-sol/mcp

ローカルビルドを使用：

claude mcp add unclaimed-sol \
  -e SOLANA_KEYPAIR_PATH=~/.config/solana/id.json \
  -e SOLANA_RPC_URL=https://your-rpc-provider.com \
  -- node /absolute/path/to/unclaimed-sol-mcp/dist/index.js

Codex CLI の場合

npm パッケージを使用（推奨）：

codex mcp add unclaimed-sol \
  --env SOLANA_KEYPAIR_PATH=~/.config/solana/id.json \
  --env SOLANA_RPC_URL=https://your-rpc-provider.com \
  -- npx -y @unclaimed-sol/mcp

ローカルビルドを使用：

codex mcp add unclaimed-sol \
  --env SOLANA_KEYPAIR_PATH=~/.config/solana/id.json \
  --env SOLANA_RPC_URL=https://your-rpc-provider.com \
  -- node /absolute/path/to/unclaimed-sol-mcp/dist/index.js

スキャン専用モード（キーペアなし。省略可能）

scan_claimable_sol ツールのみが公開されます。トランザクションへの署名や送信は行われません。

npm パッケージを使用：

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "npx",
      "args": ["-y", "@unclaimed-sol/mcp"]
    }
  }
}

ローカルビルドを使用：

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "node",
      "args": ["/absolute/path/to/unclaimed-sol-mcp/dist/index.js"]
    }
  }
}

インストールの確認

• Claude Code：claude mcp list を実行し、unclaimed-sol が表示されることを確認します。
• Codex CLI：codex mcp list を実行し、unclaimed-sol が表示されることを確認します。
• スモークテスト：アシスタントに scan wallet <your_wallet> の実行を依頼し、scan_claimable_sol が実行されることを確認します。

トラブルシューティング

• ツールが表示されない場合は、設定の変更後にMCPクライアントを再起動してください。
• ローカルビルドを使用する場合は、dist/index.js が存在すること（npm run build）と、パスが絶対パスであることを確認してください。
• claimツールが見つからない場合は、SOLANA_KEYPAIR_PATH（または SOLANA_PRIVATE_KEY）が設定されていることを確認してください。

環境変数

変数	必須	説明
UNCLAIMED_SOL_API_URL	いいえ	バックエンドAPIのURLです。デフォルトは https://unclaimedsol.com です。
UNCLAIMED_SOL_API_KEY	いいえ	Authorization: Bearer ヘッダーとして送信するAPIキーです。
SOLANA_KEYPAIR_PATH	いいえ	SolanaキーペアJSONファイルへのパスです。Vibe Claimingが有効になります。
SOLANA_PRIVATE_KEY	いいえ	base58文字列またはJSONバイト配列形式の秘密鍵です。可能な場合は、代わりに SOLANA_KEYPAIR_PATH を使用してください。
SOLANA_RPC_URL	いいえ	Solana RPCエンドポイントです。デフォルトは https://api.mainnet-beta.solana.com です。claimには専用のRPCを推奨します。
SOLANA_PRIORITY_FEE	いいえ	コンピュートユニットあたりのマイクロラムポート単位の優先手数料です。デフォルト：1,000。最大：200,000。

セキュリティ

• HTTPSを強制 — claimモードではAPI URLにHTTPSが必要です（localhostに限りHTTPを使用できます）。
• API URLの許可リスト — claimモードでは、unclaimedsol.com、localhost、または 127.0.0.1 にのみ接続します。
• 署名前の検証 — すべてのトランザクションは署名前に検証されます。これには、プログラムの許可リスト、ローカルで導出したPDAに固定された正確な命令アカウントレイアウト、手数料上限の適用、トランザクションごとのclaim要件が含まれます。ステークの場合、手数料上限はオンチェーンで確認済みの引き出し額から導出されます。報酬の場合、手数料上限は独立したスキャンと照合されます（以下の信頼モデルを参照）。
• 実行トークン — claimを実行するには、まずドライランが必要です。トークンは1回限りで、1つのウォレットにのみ使用でき、有効期限は60秒です。
• キーペアはローカルに保持 — 秘密鍵がマシンの外部に送信されることはありません。トランザクションはローカルで署名されます。
• 安全性フィルタリング — 貴重なトークンやNFTを除外するため、トークンアカウントはサーバー側でフィルタリングされます（maxClaimMode: false）。凍結されたアカウントはスキップされます。
• リクエストのタイムアウト — すべてのAPI呼び出しには15秒のタイムアウトが設定されています。

claimの仕組み

トークン／バッファのclaim（claim_sol）

1. MCPサーバーがUnclaimedSOLバックエンドを呼び出し、回収可能なトークンアカウントとバッファアカウントを取得します。
2. @unclaimedsol/spl-burn-close-sdkを使用して命令が構築されます。トークン残高はバーンされ、アカウントはUnclaimedSOLオンチェーンプログラムを介して閉鎖されます。
3. トランザクションはキーペアを使ってローカルで署名され、Solanaネットワークにブロードキャストされます。
4. オンチェーンプログラムは、正常に閉鎖されたアカウントごとに0.002 SOLを超える回収済みトークンアカウントのレンタル料と、バッファに対する5％を徴収します。資金がMCPサーバーを経由することはありません。

報酬のclaim（claim_rewards）

1. バックエンドが、DeFi報酬のclaim命令と手数料送金を含む未署名のトランザクションを構築します。
2. MCPはすべての命令を検証します。検証対象には、正確なアカウントレイアウト、識別子、ローカルで導出したPDAが含まれます。手数料は、独立してスキャンした報酬合計の15％を上限としますが、Pump／PumpSwapの価格設定ではこれより低くなる見込みです。
3. トランザクションはローカルで署名され、ブロードキャストされます。

ステークのclaim（claim_stakes）

1. バックエンドが、Stake Withdraw命令と手数料送金を含む未署名のトランザクションを構築します。
2. MCPはすべての命令を検証します。検証対象には、引き出しのみであること、正確なアカウント数、命令データから抽出した確認済み引き出し額の3％を上限とする手数料が含まれます。
3. トランザクションはローカルで署名され、ブロードキャストされます。

バリデーターの信頼モデル

署名前のバリデーター（validateTransactionPrograms）が提供する保護レベルは、クレームの種類によって異なります。

• claim_sol — SDK を使用して、命令をローカルで構築します。バリデーターは、プログラム ID と手数料保管先の有無を確認します。
• claim_stakes — 値レベルで完全に安全です。 出金額は、Stake 命令のデータから証明されます。手数料上限はローカルで算出され、バックエンドが報告する値に依存しません。
• claim_rewards — 構造上の安全性を確保します。 DeFi の報酬クレーム額は実行時にオンチェーンで決定され、命令データにはエンコードされません。手数料上限は独立した /scan 呼び出しと照合されるため、バックエンドのエンドポイント間で意図せず値がずれることは防げますが、バックエンドが完全に侵害された場合は防げません。

いずれの場合も、命令の形式は厳密に固定されています（各アカウントの位置をローカルで導出した PDA と照合し、アカウント数が正確であることを確認し、既知のディスクリミネーターのみを許可します）。

プロジェクト構成

src/
  index.ts              MCP server entry point (stdio transport)
  constants.ts          Program IDs, fee vault, fee caps, batching limits
  config.ts             Environment variable loading and validation
  validation.ts         Wallet address validation
  formatter.ts          SOL display formatting
  cache.ts              In-memory scan cache (60s TTL)
  execution-token-store.ts  Generic two-step dry-run/execute token management
  tools/
    scan.ts             scan_claimable_sol tool handler
    claim.ts            claim_sol tool handler (tokens + buffers)
    claim-rewards.ts    claim_rewards tool handler (DeFi rewards)
    claim-stakes.ts     claim_stakes tool handler (deactivated stakes)
  services/
    scanner.ts          Backend API client (scan, tokens, buffers, rewards, stakes)
    transaction.ts      Transaction building + pre-sign validation
    signer.ts           Batch sign, send, confirm with retry

ライセンス

MIT