refundyoursol-mcp

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.

| 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 |

| 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.) |

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 mcp add refundyoursol \
  -e SOLANA_PRIVATE_KEY=your-base58-key \
  -e SOLANA_RPC_URL=https://your-rpc.com \
  -- npx -y @refundyoursol/mcp

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

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

| Variable | Default | Description | |----------|---------|-------------| | `