Skip to main content
Glama

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

Related MCP server: Solana MCP Server

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

Available Tools

4 tools
detect_dexA

Detect which DEX/AMM a Solana token trades on. Returns DEX name, pool address, token name/symbol, price, market cap, and liquidity. Supports PumpSwap, Raydium, Meteora, Orca, and more.

Inputs: mint (required).

get_sol_priceA

Get the current SOL/USD price.

Inputs: no named parameters.

get_token_infoA

Get metadata and pricing for one or more Solana tokens. Returns name, symbol, image, USD price, DEX, market cap, and liquidity. Pass a single mint or array of up to 10.

Inputs: mints (required).

scan_walletA

Scan a Solana wallet for reclaimable SOL locked in empty token accounts. Returns count of closeable accounts and estimated SOL recoverable. Free, read-only — no private key needed.

Inputs: wallet (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: detect_dex identifies trading platforms for tokens, get_sol_price provides SOL/USD pricing, get_token_info retrieves metadata for specific tokens, and scan_wallet finds reclaimable SOL in wallets. There is no overlap or ambiguity in their functions.

    Naming Consistency4/5

    Three tools follow a consistent verb_noun pattern (detect_dex, get_sol_price, get_token_info), while scan_wallet uses a verb_noun format but deviates slightly with 'scan' instead of 'get' or 'detect'. This minor inconsistency does not hinder readability.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose of Solana token and wallet utilities. Each tool earns its place by covering distinct aspects like DEX detection, pricing, token metadata, and wallet scanning, without being overly sparse or bloated.

    Completeness4/5

    The tools cover key operations for Solana token analysis and wallet management, including detection, pricing, metadata retrieval, and recovery. A minor gap exists in lacking direct transaction or refund execution tools, but the provided set supports core workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Non-custodial Solana swap & limit order engine for AI agents. 21 tools - swap, limit, trailing, TWAP, DCA, combo orders - across Raydium, PumpSwap, Orca, Meteora. Jito MEV-protected execution. Ed25519-verified server messages. Private key never leaves the process.
      21
      259 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to read chain data, execute transactions, swap tokens, and manage wallets on Solana through 38 tools across 7 modules. Supports write operations with a private key and includes built-in prompts for common workflows.
      38
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides 13 Solana DeFi intelligence tools for AI agents, paid per-call via micropayments (USDC). Enables pulling live DeFi data and automatic payment settlement.
      13
      81 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query live Solana wallet token holdings, native SOL balances, transaction history, transaction details, and SPL token mint top holders through keyless public endpoints.
      152 npm
      MIT