refundyoursol

MCP (Model Context Protocol) server for RefundYourSOL — the most widely used Solana wallet cleanup tool with 500K+ wallets processed.

Provides AI agents with tools for Solana wallet cleanup, token trading on 12+ DEXes, and token metadata/pricing.

Tools

Always Available (no private key needed)

Tool	Description
`scan_wallet`	Scan a wallet for reclaimable SOL locked in empty token accounts (~0.002 SOL each)
`detect_dex`	Detect which DEX a token trades on + price, market cap, liquidity
`get_token_info`	Get metadata and pricing for one or more tokens
`get_sol_price`	Get current SOL/USD price

Require Private Key

Tool	Description
`close_accounts`	Close empty token accounts and reclaim rent SOL
`burn_and_close`	Burn dust tokens and close accounts in one step
`trade_token`	Buy or sell tokens on 12+ DEXes (PumpSwap, Raydium, Meteora, Orca, etc.)

Quick Start

Claude Desktop / Cursor / Windsurf

Add to your MCP config (claude_desktop_config.json or equivalent):

{
  "mcpServers": {
    "refundyoursol": {
      "command": "npx",
      "args": ["-y", "refundyoursol"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your-base58-private-key",
        "SOLANA_RPC_URL": "https://your-rpc-endpoint.com"
      }
    }
  }
}

Claude Code CLI

claude mcp add refundyoursol \
  -e SOLANA_PRIVATE_KEY=your-base58-key \
  -e SOLANA_RPC_URL=https://your-rpc.com \
  -- npx -y @refundyoursol/mcp

Scan-Only Mode (no private key)

Omit SOLANA_PRIVATE_KEY to run in scan-only mode with 4 read-only tools:

{
  "mcpServers": {
    "refundyoursol": {
      "command": "npx",
      "args": ["-y", "refundyoursol"]
    }
  }
}

Configuration

Variable	Default	Description
`SOLANA_PRIVATE_KEY`	—	Base58 private key for signing (optional — scan-only mode if omitted)
`SOLANA_RPC_URL`	`https://api.mainnet-beta.solana.com`	Solana RPC endpoint
`RYS_API_URL`	`https://refundyoursol.com`	RefundYourSOL backend
`RYS_API_KEY`	—	API key for token metadata/pricing endpoints
`RYS_PRIORITY_FEE`	`50000`	Priority fee in microLamports

Usage Examples

Once connected, ask your AI assistant:

"Scan my wallet for reclaimable SOL"
"Close all empty token accounts in my wallet"
"What DEX does this token trade on? [mint address]"
"Buy 0.1 SOL of [token] on Solana"
"Sell 100% of [token] with Jito MEV protection"
"What's the current SOL price?"

Safety

Dry-run first: close_accounts and burn_and_close use a two-step pattern — first call shows a preview, second call with the execution token confirms
Safety Burns: Accidental burns can be reverted (unique to RefundYourSOL)
Non-custodial: Keys are used locally for signing only, never sent to any server
Execution tokens expire: 60-second TTL prevents stale operations

Features vs Competitors

Feature	RefundYourSOL MCP	UnclaimedSOL MCP
Wallet scan	Yes	Yes
Close accounts	Yes	Yes
Burn & close	Yes	Yes
Safety burns (revertible)	Yes	No
Token trading (12+ DEXes)	Yes	No
DEX detection	Yes	No
Token metadata/pricing	Yes	No
Fee matching (down to 2%)	Yes	No (fixed 5%)
Fee Payer mode (0 SOL)	Yes	No

License

MIT

RefundYourSOL