SOL Claimer Server

npm version License: MIT Node.js Version CI

A Model Context Protocol (MCP) server that provides seamless integration between LLM applications (ChatGPT, Claude, etc.) and the SOL Claimer API. This server enables AI assistants to analyze Solana token accounts and help users recover rent from empty and low-value token accounts.

Features

• ✅ Four Powerful Tools:
  1. analyze_empty_accounts - Find and recover rent from empty token accounts
  2. analyze_burnable_accounts - Identify low-value tokens (<$1) to burn and close
  3. analyze_swappable_accounts - Find tokens with amount > 0 that can be swapped and closed
  4. get_how_it_works - Learn about SOL Claimer functionality

SOL Claimer Features (Page Copy)

SOL Claimer is a Solana SPL token manager focused on cleaning token accounts and recovering locked rent.

• Claim Rent Fee - Close empty token accounts and reclaim SOL rent back to your wallet.
• Create SPL / SPL22 Tokens - Launch standard or Token-2022 assets.
• Mint New Coins - Mint additional supply for your token when needed.
• Bulk Send Tokens - Send tokens to many wallets in one flow.
• Burn Scam / Worthless Coins - Remove unwanted low-value tokens and recover account rent.
• Swap Tiny Amounts and Get Rent Fee - Convert dust balances and close token accounts to unlock SOL.

How rent claiming works

On Solana, token accounts hold a rent-exempt SOL reserve. When an account is no longer needed, closing it returns that SOL to your wallet. SOL Claimer helps you find eligible accounts (empty or low-value), then guides you to burn/clear balances and close accounts so you can recover the rent safely.

• 🔄 Real-time API Integration - Direct connection to SOL Claimer API
• 🛡️ Error Handling - Graceful error management and user-friendly messages
• 📊 Rich Response Formatting - Detailed, readable analysis results

Prerequisites

• Node.js 18+ (tested on v20+)
• npm 10+
• SOL Claimer API accessible at https://api.solclaimer.app
• Environment variable SOLCLAIMER_API_URL (optional, defaults to https://api.solclaimer.app)

Installation

Option 1: Install from npm (Recommended)

# Install globally
npm install -g @solclaimer/mcp

# Or install locally in your project
npm install @solclaimer/mcp

Option 2: Install from source

# Clone the repository
git clone https://github.com/solclaimer/mcp.git
cd mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Configuration

Environment Variables

Optionally set the SOL Claimer API URL:

export SOLCLAIMER_API_URL=https://api.solclaimer.app

If not set, defaults to https://api.solclaimer.app.

Development

# Watch TypeScript changes and run
npm run dev

# Format code
npm run format

# Lint code
npm run lint

Tools

1. analyze_empty_accounts

Analyzes a Solana wallet for empty token accounts that can be closed to recover rent.

Parameters:

• wallet_address (string, required): The Solana wallet address to analyze

Response:

• accountsToClose - Number of empty accounts found
• totalSol - Total SOL available for recovery

2. analyze_burnable_accounts

Analyzes a wallet for token accounts with balances worth less than $1 USD that can be burned and closed.

Parameters:

• wallet_address (string, required): The Solana wallet address to analyze

Response:

• accountsToBurn - Number of burnable accounts found
• totalSol - Total SOL available for recovery
• totalUsdValue - Combined USD value of all burnable tokens
• accountDetails - Array of detailed account information including:
  • Token name and symbol
  • Amount and USD value
  • Rent (in lamports)
  • Contract verification status

3. analyze_swappable_accounts

Analyzes a wallet for token accounts with amount > 0 that can be swapped and then closed.

Parameters:

• wallet_address (string, required): The Solana wallet address to analyze

Response:

• accountsToSwap - Number of swappable accounts found
• totalSol - Total SOL available for recovery after swap and close
• totalUsdValue - Combined USD value of all swappable tokens
• accountDetails - Array of detailed account information including token name and symbol

4. get_how_it_works

Returns documentation about SOL Claimer features and capabilities.

Parameters: None

Response:

• Information about SOL Claimer features
• Description of how it works
• Website link

Example Usage with Claude

User: "Can you analyze my Solana wallet at 7cvkjYAkUYs4W8XcXsca7cBrEGFeSUjeZmKoNBvEwyri?"

Claude: [Uses analyze_empty_accounts, analyze_burnable_accounts, and analyze_swappable_accounts tools]
"Based on the analysis, I found:
- 5 empty token accounts: 0.0101964 SOL can be recovered
- 12 burnable accounts: 0.0244713 SOL can be recovered (worth $0.52)
..."

Integration with LLM Platforms

Claude (via claude.ai or Claude API)

1. Create a Claude project with this MCP server
2. Configure the MCP server in your Claude settings
3. Claude will automatically use the available tools when analyzing Solana wallets

ChatGPT / OpenAI

1. Set up a custom integration pointing to this MCP server
2. Configure as a tool/action in your OpenAI integration
3. Use natural language to analyze wallets

Generic MCP Client Integration

Any MCP-compatible client can connect to this server using:

{
  "mcpServers": {
    "solclaimer": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": {
        "SOLCLAIMER_API_URL": "https://api.solclaimer.app"
      }
    }
  }
}

Architecture

Project Structure

src/
├── index.ts          # Main MCP server implementation
tsconfig.json         # TypeScript configuration
package.json          # Dependencies and scripts

Key Components

1. SolClaimerApiClient - Handles communication with the SOL Claimer API
2. MCP Server - Exposes four tools via the Model Context Protocol
3. Response Formatters - Transform API responses into readable text

Troubleshooting

Connection refused error

• Ensure SOL Claimer API is reachable at the configured SOLCLAIMER_API_URL
• Default: https://api.solclaimer.app
• Check firewall and port accessibility

Invalid wallet address

• Verify the Solana wallet address format (44-character base58 string)
• Examples: 7cvkjYAkUYs4W8XcXsca7cBrEGFeSUjeZmKoNBvEwyri

API timeout

• Check network connectivity to the SOL Claimer API
• Increase timeout if API is slow (edit timeout in SolClaimerApiClient)
• Check if Solana RPC endpoint is accessible

Performance

• Requests include 30-second timeout to prevent hanging
• No caching at MCP layer (respects API caching)
• Suitable for real-time analysis

License

UNLICENSED

Links

• SOL Claimer Website: https://solclaimer.app/
• Model Context Protocol: https://modelcontextprotocol.io/
• TypeScript SDK: https://github.com/modelcontextprotocol/typescript-sdk