2025-03-17 · 5 min read · Developer

RefundYourSOL MCP: Solana Tools for AI Agents

Connect your AI assistant to Solana with RefundYourSOL's MCP server. Scan wallets, trade tokens on 12+ DEXes, and get market data from conversational AI.

We just released refundyoursol — a Model Context Protocol server that lets AI assistants like Claude, Cursor, and Windsurf interact with Solana directly. Scan wallets, recover locked SOL, trade tokens, and fetch market data through natural conversation.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI models call external tools. Instead of copy-pasting wallet addresses and switching between apps, you just tell your AI assistant what to do and it handles the rest.

What Can It Do?

7 tools in one package:

Free (no private key needed):

• scan_wallet — "Scan my wallet for reclaimable SOL" → instantly shows how many empty accounts and how much SOL is recoverable
• detect_dex — "What DEX does this token trade on?" → returns DEX, pool address, price, market cap, liquidity
• get_token_info — "Get me the price of these 5 tokens" → batch metadata and pricing
• get_sol_price — "What's SOL at right now?" → current USD price

With private key:

• close_accounts — "Close all empty token accounts" → reclaims rent SOL with dry-run safety
• burn_and_close — "Clean up dust tokens" → burns worthless tokens and closes in one step
• trade_token — "Buy 0.1 SOL of [token]" → executes trades on 12+ DEXes with optional Jito MEV protection

How It Compares

Quick Setup

Claude Desktop / Cursor

Add to your MCP config:

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

That's it. No API keys needed for scanning and market data. Add SOLANA_PRIVATE_KEY in the env block to enable trading and account closure.

Claude Code

claude mcp add refundyoursol -- npx -y @refundyoursol/mcp

Safety First

• Dry-run pattern: Close and burn operations show a preview first. You confirm with an execution token before anything happens.
• Safety Burns: Accidentally burn the wrong token? RefundYourSOL can reverse it.
• Non-custodial: Your private key stays local — used only for signing, never transmitted.
• 60-second tokens: Execution tokens expire after 60 seconds to prevent stale operations.

Use Cases

• Wallet maintenance bots: Automatically scan and clean wallets on a schedule
• Trading bots: Buy/sell tokens conversationally with automatic DEX routing
• Portfolio dashboards: Fetch token prices and metadata programmatically
• Multi-wallet management: Scan and clean multiple wallets through AI conversation

Get Started

npm install @refundyoursol/mcp

Or just use npx — no installation needed:

npx @refundyoursol/mcp

Related: Solana Trading API: Buy & Sell Tokens Programmatically | How to Recover SOL from Unused Token Accounts

Full documentation and source code at github.com/refundyoursol/refundyoursol-mcp.