unclaimed-sol — Claude Code MCP server: what it does, how to install
unclaimed-sol scans Solana wallets to reclaim rent-locked SOL from dormant accounts and uncollected DeFi fees directly via AI assistants.
MIT ★ 5 updated 2026-10-15
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/mcpWhat unclaimed-sol 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.
What it helps with
- 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 for the agent
- Check
<wallet_address>and report any claimable rent - Run a dry-run claim on my dormant token accounts
- Claim uncollected rewards for my wallet
How to install unclaimed-sol
Platform CLI
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/mcpReplace <…> with your own values
Platform CLI
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/mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about unclaimed-sol
How to install unclaimed-sol in Claude Code?
Run claude mcp add unclaimed-sol -e SOLANA_KEYPAIR_PATH=<SOLANA_KEYPAIR_PATH> -e SOLANA_PRIVATE_KEY=<SOLANA_PRIVATE_KEY> -- npx -y @unclaimed-sol/mcp in your terminal.
What does unclaimed-sol do?
It allows agents to scan Solana addresses and reclaim rent SOL locked in inactive token accounts, buffer programs, and stakes.
Are wallet private keys exposed?
No, transactions are validated and signed locally on your device without transmitting private keys over the network.