RefundYourSOL
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 a wallet for reclaimable SOL locked in empty token accounts (~0.002 SOL each) |
| Detect which DEX a token trades on + price, market cap, liquidity |
| Get metadata and pricing for one or more tokens |
| Get current SOL/USD price |
Require Private Key
Tool | Description |
| Close empty token accounts and reclaim rent SOL |
| Burn dust tokens and close accounts in one step |
| 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/mcpScan-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 |
| — | Base58 private key for signing (optional — scan-only mode if omitted) |
|
| Solana RPC endpoint |
|
| RefundYourSOL backend |
| — | API key for token metadata/pricing endpoints |
|
| 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_accountsandburn_and_closeuse a two-step pattern — first call shows a preview, second call with the execution token confirmsSafety 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 |
Links
Website: refundyoursol.com
API Docs: refundyoursol.com/docs
Blog: refundyoursol.com/blog
Twitter/X: @refundyoursol
Telegram: t.me/refundyoursol
License
MIT
Available Tools
4 toolsdetect_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Run all your Solana wallets from your AI: send, swap, split, consolidate and clean up.
Non-custodial DeFi tools for AI agents on Solana: swaps, perps, lending, staking, equities.
Solana onchain intelligence for AI agents: wallet risk, due-diligence, perps funding, smart money.
Non-custodial Solana toolkit: rug-checks, swaps, token tools, multisig, DLMM pools, Arweave.
Related MCP Servers
AlicenseBqualityDmaintenanceNon-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.21259 npm3MIT- AlicenseAqualityDmaintenanceEnables 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.381MIT
- AlicenseBqualityDmaintenanceProvides 13 Solana DeFi intelligence tools for AI agents, paid per-call via micropayments (USDC). Enables pulling live DeFi data and automatic payment settlement.1381 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT