# Unclaimed SOL

## scan_claimable_sol  (free, read-only)

Returns reclaimable SOL + account count for a wallet.

This scan sends the user's public Solana wallet address to
https://unclaimedsol.com. No private keys, seed phrases, or signing
capabilities are transmitted. Ask the user for confirmation before scanning.

Input:

```json
{ "wallet": "So11111111111111111111111111111111111111112" }
```

The A2A endpoint also accepts `publicKey` and `wallet_address` aliases.

Output:

```json
{
  "totalClaimableSol": 0.1234,
  "reclaimableSol": 0.1234,
  "accountCount": 3,
  "tokenAccountCount": 2,
  "bufferAccountCount": 1
}
```

Show exact SOL values returned by the API; do not round to two decimals.

## Claiming

To reclaim, run the UnclaimedSOL MCP locally with your own keypair. It builds,
signs locally, and broadcasts; keys never leave your machine, fee is on-chain:

```bash
npx -y @unclaimed-sol/mcp
# env: SOLANA_KEYPAIR_PATH (or SOLANA_PRIVATE_KEY), SOLANA_RPC_URL
```

MCP tools use `wallet_address` for the wallet parameter.

Tools:

- `scan_claimable_sol` — read-only scan; available without a keypair.
- `claim_sol` — claim dormant token and buffer accounts. Supports `dry_run`,
  `execution_token`, `max_transactions`, and `exclude`.
- `claim_rewards` — claim uncollected DeFi rewards.
- `claim_stakes` — claim SOL from deactivated stake accounts.

Claiming tools use a two-step dry-run -> execute flow.

Claiming tools are available only when `SOLANA_KEYPAIR_PATH` or
`SOLANA_PRIVATE_KEY` is configured. In scan-only mode, only
`scan_claimable_sol` is exposed.

Never ask for a seed phrase, private key, or mnemonic. Closed accounts cannot be
recovered, so review dry-run output before executing claims.