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)

Require Private Key

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

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

Links

• Website: refundyoursol.com

• API Docs: refundyoursol.com/docs

• Blog: refundyoursol.com/blog

• Twitter/X: @refundyoursol

• Telegram: t.me/refundyoursol

License

MIT