MCP Server

The Unclaimed SOL MCP server connects AI clients that support the Model Context Protocol to the Unclaimed SOL scanning and claiming engine. Use it with Claude Desktop, Cursor, Windsurf, or any other MCP-compatible assistant.

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools in a controlled way. The Unclaimed SOL MCP server exposes wallet-scanning and claiming tools so your AI client can find and reclaim SOL on your behalf.

Install

npm i @unclaimed-sol/mcp

Or run it directly with npx: 

npx @unclaimed-sol/mcp
View the package on NPM.

Configuration

Add the server to your AI client's MCP configuration file. Below are examples for the most common clients.

Claude Desktop

Open claude_desktop_config.json and add the server: 

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "npx",
      "args": ["@unclaimed-sol/mcp"]
    }
  }
}

Cursor

Open your project's .cursor/mcp.json file (or create it) and add: 

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "npx",
      "args": ["@unclaimed-sol/mcp"]
    }
  }
}

Windsurf

Open ~/.codeium/windsurf/mcp_config.json and add the server: 

{
  "mcpServers": {
    "unclaimed-sol": {
      "command": "npx",
      "args": ["@unclaimed-sol/mcp"]
    }
  }
}

Available tools

The MCP server exposes two tools to the AI client:

  • scan – Scan a Solana wallet for reclaimable SOL. Returns a breakdown of token accounts and estimated recoverable amounts.
  • claim – Build and execute claim transactions. Requires opt-in with an execution token (see Safety below).

Safety architecture

The MCP server is scan-only by default. No transactions can be sent without explicit opt-in.

  • Scan mode (default) – Safe for discovery and explanation. No private keys are used, no transactions are built.
  • Opt-in claiming – Requires a short-lived execution token. Transactions are signed locally on your machine and support dry-run simulation before execution.

This separation ensures your AI assistant cannot accidentally fire transactions. Every claim requires a deliberate opt-in step.

Troubleshooting

Server not found

  • Make sure Node.js 18+ is installed.
  • Check that your MCP configuration path and command are correct.
  • Restart your AI client after editing the configuration file.

Scan returns no results

  • Verify the wallet address is a valid Solana public key.
  • The wallet may not have any reclaimable token accounts.

Still need help?

Reach out on Discord or open an issue on GitHub.