Solscan MCP Server

🚀 Solscan MCP Server

A Model Context Protocol (MCP) service implementation for interacting with the Solscan Pro API. This server enables AI agents to retrieve and analyze data on tokens, transactions, and DeFi activities from the Solana blockchain.

🚀 Quick Start

The Solscan MCP Server serves as a bridge between AI agents and the Solscan Pro API service. It adheres to the best practices proposed by Anthropic and supports seamless integration with any MCP-compatible client.

✨ Features

The server offers various tools for interacting with Solscan:

1. token_meta: Retrieve token metadata

   • Obtain comprehensive token information
   • Get details such as name, symbol, price, market capitalization, etc.

2. token_markets: Retrieve token market data and liquidity pools

   • View trading pairs and liquidity pools
   • Filter by program address
   • Sort and paginate results

3. token_holders: Retrieve token holder distribution

   • View the balance and distribution of holders
   • Filter by amount range
   • Paginate results

4. token_price: Retrieve token price information

   • Get historical price data
   • Filter by date range
   • Obtain price trends and statistical information

5. token_accounts: Retrieve the token holdings of a wallet

   • List token and NFT holdings
   • Filter out zero balances
   • Paginate results

6. defi_activities: Retrieve DeFi activity information

   • Get operation records related to DeFi
   • Filter by type
   • Sort and paginate results

7. transaction: Retrieve transaction information

   • Get transaction details related to a wallet
   • Filter by block height or time range
   • View transaction hashes and input/output details

Prerequisites

• Python 3.8 or higher needs to be installed.
• You must obtain an API key for Solscan Pro.
• It is recommended to use Docker to run the service.

📦 Installation

Using uv

uv pip install solscan-mcp-server

Using pip

pip install solscan-mcp-server

Configuration

The following are the configuration options for the server:

Running the Server

Using uv

uv solscan-mcp-server --api-key=your_api_key_here

Using Docker

docker run -it --rm -e SOLSCAN_API_KEY=your_api_key_here solscan/mcp-server

Integration

Claude Desktop Configuration

Add the following to ~/.config/claude/settings.json:

"context_servers": {
  "solscan": {
    "command": {
      "path": "uvx",
      "args": ["solscan-mcp-server"]
    }
  }
}

Zed Configuration

Add the following to ~/.config/zed/settings.json:

"inspector.servers": {
  "solscan": {
    "command": {
      "path": "uvx",
      "args": ["solscan-mcp-server"]
    }
  }
}

Development

Running Tests

uv pip install -e ".[dev]"
pytest

Code Quality Check

pyright
ruff check .

Debugging

Use the MCP monitor for debugging:

npx @modelcontextprotocol/inspector uvx solscan-mcp-server

Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is open-source under the MIT License. See the LICENSE file for details.