Solscan MCP Server

by bobtista

166 downloads
Not rated
GitHub

Description

# Solscan MCP Server A Model Context Protocol (MCP) server implementation for interacting with the Solscan Pro API. This server allows AI agents to fetch and analyze token, transaction, and DeFi activity data from the Solana blockchain. ## Overview This MCP server provides a…

About

# Solscan MCP Server A Model Context Protocol (MCP) server implementation for interacting with the Solscan Pro API. This server allows AI agents to fetch and analyze token, transaction, and DeFi activity data from the Solana blockchain. ## Overview This MCP server provides a bridge between AI agents and the Solscan…

Details

Author
bobtista
Downloads
166
Categories
Other

- Fetch token metadata, markets, and holder distribution
- Retrieve token price history and trends
- List wallet token and NFT holdings
- Query DeFi activities and balance changes
- Get detailed transaction info and parsed instructions

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Solscan MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via uvx (recommended) or pip. Set the SOLSCAN_API_KEY environment variable or use the --api-key CLI argument. Run with uvx solscan-mcp-server, python -m solscan_mcp_server, or Docker. Configure transport (sse or stdio), host, port, and log level. Integrate with MCP clients like Claude Desktop or Zed by adding the server to their configuration files.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "solscan mcp server": {
            "solscan_mcp_server": {
                "command": "uvx",
                "args": [
                    "solscan-mcp-server"
                ],
                "env": {
                    "SOLSCAN_API_KEY": "your-key"
                }
            }
        }
    }
}

McpServers

{
    "solscan_mcp_server": {
        "command": "uvx",
        "args": [
            "solscan-mcp-server"
        ],
        "env": {
            "SOLSCAN_API_KEY": "your-key"
        }
    }
}

Solscan MCP Server

A Model Context Protocol (MCP) server implementation for interacting with the Solscan Pro API. This server allows AI agents to fetch and analyze token, transaction, and DeFi activity data from the Solana blockchain.

Overview

This MCP server provides a bridge between AI agents and the Solscan Pro API service. It follows the best practices laid out by Anthropic for building MCP servers, allowing seamless integration with any MCP-compatible client.

Features

The server provides several essential tools for interacting with Solscan:

1. token_meta: Get token metadata

- Fetch comprehensive token information
- Get name, symbol, price, market cap, etc.

2. token_markets: Get token market data and liquidity pools

- View market pairs and liquidity pools
- Filter by program addresses
- Sort and paginate results

3. token_holders: Get token holder distribution

- View holder balances and distribution
- Filter by amount ranges
- Paginate through results

4. token_price: Get token price information

- Historical price data
- Filter by date range
- Price trends and statistics

5. token_accounts: Get token holdings for a wallet

- List token and NFT holdings
- Filter zero balances
- Paginate results

6. defi_activities: Get DeFi activities for a wallet

- Filter by activity type and platform
- Sort by time or other metrics
- Comprehensive activity details

7. balance_change: Get balance change activities

- Track token balance changes
- Filter by token and amount
- Remove spam transactions

8. account_transactions: Get wallet transactions

- List wallet transactions
- Paginate through transaction history
- Configurable result limits

9. transaction_detail: Get transaction information

- Detailed transaction data
- Parsed instructions
- Fee information

10. transaction_actions: Get transaction actions

- List token transfers
- View program interactions
- Decoded instruction data

Prerequisites

- Python 3.10+
- Solscan Pro API key (obtain from Solscan APIs)
- Docker if running the MCP server as a container (recommended)

Installation

Using uv (Recommended)

When using uv, no specific installation is needed. We use uvx to directly run _solscan-mcp-server_.

Using pip

Alternatively, install via pip:

pip install solscan-mcp-server

Configuration

You can configure the server using either environment variables or command-line arguments:

| Option | Env Variable | CLI Argument | Default | Description |
| --------- | --------------- | ------------ | --------- | ------------------------------------------ |
| API Key | SOLSCAN_API_KEY | --api-key | Required | Your Solscan Pro API key |
| Transport | TRANSPORT | --transport | sse | Transport protocol (sse or stdio) |
| Host | HOST | --host | 127.0.0.1 | Host to bind to when using SSE transport |
| Port | PORT | --port | 8050 | Port to listen on when using SSE transport |
| Log Level | LOG_LEVEL | --verbose | INFO | Logging level (use -v or -vv for detail) |

Running the Server

Using uvx (Recommended)

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.