# unclaimed-sol

unclaimed-sol scans Solana wallets to reclaim rent-locked SOL from dormant accounts and uncollected DeFi fees directly via AI assistants.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: unclaimed-sol
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/unclaimed-sol/unclaimed-sol-mcp
- Updated: 2026-10-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/unclaimed-sol

## What it does

The server supplies four tools: `scan_claimable_sol`, `claim_sol`, `claim_rewards`, and `claim_stakes`. Scanning runs in read-only mode without broadcasting transactions or loading wallet keypairs. It inspects public wallet addresses to detect dormant token accounts, program buffers, and inactive stakes holding locked rent.

Claiming operates through a two-step safeguard. The initial dry run reports expected fees and returns an `execution_token`. This authorization token expires after 60 seconds. A second call with the token executes the on-chain instructions, preventing unconfirmed actions.

Transactions are signed locally on the machine. Private keys never leave the local environment, and seed phrases are not accepted. Closing token accounts cannot be undone. Running the server requires Node.js 18 or higher.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SOLANA_KEYPAIR_PATH`, `SOLANA_PRIVATE_KEY`, `SOLANA_RPC_URL`, `UNCLAIMED_SOL_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SOLANA_KEYPAIR_PATH=<SOLANA_KEYPAIR_PATH> --env SOLANA_PRIVATE_KEY=<SOLANA_PRIVATE_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env UNCLAIMED_SOL_API_URL=<UNCLAIMED_SOL_API_URL> --transport stdio unclaimed-sol -- npx -y @unclaimed-sol/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add unclaimed-sol --env SOLANA_KEYPAIR_PATH=<SOLANA_KEYPAIR_PATH> --env SOLANA_PRIVATE_KEY=<SOLANA_PRIVATE_KEY> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env UNCLAIMED_SOL_API_URL=<UNCLAIMED_SOL_API_URL> -- npx -y @unclaimed-sol/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "unclaimed-sol": {
            "command": "npx",
            "args": [
                "-y",
                "@unclaimed-sol/mcp"
            ],
            "env": {
                "SOLANA_KEYPAIR_PATH": "<SOLANA_KEYPAIR_PATH>",
                "SOLANA_PRIVATE_KEY": "<SOLANA_PRIVATE_KEY>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "UNCLAIMED_SOL_API_URL": "<UNCLAIMED_SOL_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "unclaimed-sol": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@unclaimed-sol/mcp"
            ],
            "env": {
                "SOLANA_KEYPAIR_PATH": "<SOLANA_KEYPAIR_PATH>",
                "SOLANA_PRIVATE_KEY": "<SOLANA_PRIVATE_KEY>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "UNCLAIMED_SOL_API_URL": "<UNCLAIMED_SOL_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SOLANA_KEYPAIR_PATH=<SOLANA_KEYPAIR_PATH> -e SOLANA_PRIVATE_KEY=<SOLANA_PRIVATE_KEY> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e UNCLAIMED_SOL_API_URL=<UNCLAIMED_SOL_API_URL> unclaimed-sol npx -y @unclaimed-sol/mcp
```
Replace <…> with your own values

## When to use it
- scan Solana wallets for rent-locked lamports
- preview fees before terminating abandoned token accounts
- withdraw SOL from deactivated stake positions
- collect pending DeFi rewards from automated agents

## Example prompts
- Check `<wallet_address>` and report any claimable rent
- Run a dry-run claim on my dormant token accounts
- Claim uncollected rewards for my wallet

## Similar
- [finance-district-mcp](https://affpapa.org/en/nevibecode/skills/finance-district-mcp.md) — skill · ★ 797 repo stars
- [SolEnrich](https://affpapa.org/en/nevibecode/mcp/solenrich.md) — MCP server · 140 installs
- [binance-agentic-wallet](https://affpapa.org/en/nevibecode/skills/binance-agentic-wallet.md) — skill · 53500 installs
- [Sato Hub: Onchain Agents](https://affpapa.org/en/nevibecode/mcp/sato-hub-onchain-agents.md) — MCP server · 922 installs
- [ChainRay](https://affpapa.org/en/nevibecode/mcp/chainray.md) — MCP server · 210 installs
- [gmgn-portfolio](https://affpapa.org/en/nevibecode/skills/gmgn-portfolio.md) — skill · 20100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
