Unclaimed Sol logo

Unclaimed Sol

Scan and reclaim dormant SOL, DeFi rewards, and deactivated stakes from Solana wallets through MCP tools.

Install Unclaimed Sol

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "npx",
      "args": [
        "-y",
        "@unclaimed-sol/mcp"
      ],
      "env": {
        "SOLANA_KEYPAIR_PATH": "YOUR_VALUE_HERE",
        "SOLANA_RPC_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The unclaimed-sol MCP server scans Solana wallets for reclaimable SOL in dormant token accounts and program buffers, then supports claims for rewards and deactivated stakes. It runs as a Node.js stdio process through npm or a local build, using a configured RPC endpoint and optional local keypair. Scanning is read-only and can run without wallet credentials; claim operations require local signing, a dry run, and a short-lived execution token. Reach for it when an AI assistant needs to inspect or reclaim rent-locked SOL without sending private keys to a remote service.

Use cases

  • Scan a Solana wallet for reclaimable rent
  • Preview dormant-account cleanup before signing
  • Claim eligible DeFi rewards
  • Recover SOL from deactivated stake accounts

Key features

  • Read-only wallet scanning
  • Dormant token and Token-2022 account cleanup
  • DeFi reward claims
  • Deactivated stake claims
  • Dry-run previews with expiring execution tokens
  • Local keypair signing

Tools4

What Unclaimed Sol lets your agent do. Expand a tool for its parameters.

Self-reported~61 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · @unclaimed-sol/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads277Package downloads in the last 30 days.
Last commit9d agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.

How Unclaimed Sol works

What unclaimed-sol does

The unclaimed-sol MCP server connects AI assistants to UnclaimedSOL and the Solana network. It can inspect a wallet for SOL held in dormant token accounts, including Token-2022 accounts, and program buffers. Claim workflows also cover uncollected DeFi rewards and SOL held in deactivated stake accounts.

Scanning is free and read-only. Claiming can close dormant accounts, burn worthless token balances, or submit transactions for rewards and stakes. Closing an account is irreversible, so review the dry-run output before execution. The MCP process does not hold funds; transactions are signed locally and sent to Solana.

Fees depend on the claim type. Token cleanup lets the user keep up to 0.002 SOL per closed account, program buffers have a 5% fee, general DeFi rewards have a 15% fee, and Pump or PumpSwap rewards have a 3% fee capped at 1 SOL or 100 USDC. Deactivated stake claims have a 3% fee.

How it works

The unclaimed-sol MCP server exposes four tools:

  • scan_claimable_sol checks a supplied base58 wallet address, or the configured keypair wallet in claim-enabled mode. It reports dormant token accounts and program buffers without signing or broadcasting transactions.
  • claim_sol handles dormant-account cleanup. Its default dry run reports candidate accounts, estimated proceeds, fees, and transaction count, then returns a one-time execution token valid for 60 seconds. A second call with execution enabled submits the claim.
  • claim_rewards uses the same dry-run and execution-token sequence for eligible DeFi rewards.
  • claim_stakes uses that sequence for deactivated stake accounts and can optionally receive specific stake addresses.

Claim tools require a configured keypair. The keypair remains on the local machine, and no seed phrase is used by the server. The max_transactions option limits the number of transactions for claim_sol, while exclude can omit selected token symbols or names during execution.

Setup and configuration

Use Node.js 18 or newer and npm. The recommended installation runs the published package directly:

Terminal
npx -y @unclaimed-sol/mcp

You can also clone the repository, install dependencies, build it, and start dist/index.js with Node. Configure the server as a stdio MCP process in a compatible client. Claim-enabled configuration supplies SOLANA_KEYPAIR_PATH and SOLANA_RPC_URL, for example a path to a Solana keypair JSON file and an RPC provider URL.

For scan-only operation, omit the environment configuration. In that mode, only scan_claimable_sol is exposed, and the process cannot sign or send transactions. The README provides setup commands or JSON examples for Claude Desktop, Cursor, Windsurf, Claude Code, and Codex CLI.

Limitations and notes

Wallet addresses must be base58 Solana public keys. DeFi rewards and deactivated stakes are discovered through their respective dry runs rather than the general scan tool. Execution tokens expire after 60 seconds and are single-use. Claiming changes on-chain account state and cannot recover accounts that have been closed. Review fees, account selections, and transaction counts before confirming execution.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Unclaimed Sol

unclaimed-sol is an MCP server that connects AI assistants to UnclaimedSOL and Solana wallets. Its main tools scan for reclaimable SOL, claim dormant token-account balances, claim DeFi rewards, and claim deactivated stakes. Scanning is read-only, while claims use local signing, dry-run previews, and short-lived execution tokens.

Install it with `npx -y @unclaimed-sol/mcp`, then register that command as a stdio MCP server in your client. You can alternatively clone the repository, run `npm install` and `npm run build`, and start the generated `dist/index.js` file with Node.js 18 or newer.

Yes, unclaimed-sol works with Cursor through its stdio MCP configuration. Add the npm command or local Node.js entry point, and provide `SOLANA_KEYPAIR_PATH` and `SOLANA_RPC_URL` when enabling claim operations. Scan-only mode can run without those environment variables.

Yes, scan-only mode runs without a keypair and exposes only `scan_claimable_sol`. Pass a base58 wallet address to inspect dormant token accounts and program buffers. No transactions are signed or sent in this mode; claiming requires a configured local keypair.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewUnclaimed Sol AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/unclaimed-sol?style=directory)](https://allmcps.com/mcp/unclaimed-sol)
HTML Embed
<a href="https://allmcps.com/mcp/unclaimed-sol"><img src="https://allmcps.com/api/badge/unclaimed-sol?style=directory" alt="Unclaimed Sol on AllMCPs" /></a>