Which integrations are available for this server?

Provides tools for Solana wallet management and cleanup, including scanning for reclaimable SOL, closing empty token accounts, burning dust tokens, and trading tokens across 12+ decentralized exchanges (DEXes).

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