Skip to main content
Glama
solana-forensics

solana-forensics

Solana Forensics MCP

On-chain investigation and analysis tools for Solana blockchain. Detects wash trading, traces funding sources, analyzes holder concentration, and identifies MEV/bundle activity.

Quick Start

1. Get a Helius API Key

Sign up at dashboard.helius.dev and create an API key.

2. Install

cd solana-forensics-mcp
uv venv && source .venv/bin/activate
uv pip install -e .

3. Configure Your Client

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "solana-forensics": {
      "command": "uv",
      "args": ["--directory", "/path/to/solana-forensics-mcp", "run", "python", "-m", "src.server"],
      "env": {
        "HELIUS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. The server will appear as solana-forensics with 4 tools.

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "solana-forensics": {
      "command": "uv",
      "args": ["--directory", "/path/to/solana-forensics-mcp", "run", "python", "-m", "src.server"],
      "env": {
        "HELIUS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or add to your project's .mcp.json for project-specific access:

{
  "mcpServers": {
    "solana-forensics": {
      "command": "uv",
      "args": ["--directory", "/path/to/solana-forensics-mcp", "run", "python", "-m", "src.server"],
      "env": {
        "HELIUS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Code. Tools will be available as mcp__solana-forensics__*.

Related MCP server: Solana DeFi Analytics MCP Server

Forensics Operations

Operation

Description

forensics.trace_sol_funding

BFS traversal of SOL transfer history to trace funding sources

forensics.find_common_funding

Identify shared funding sources across multiple wallets

forensics.detect_wash_trading

DFS cycle detection in token trade graphs

forensics.analyze_holder_distribution

Gini coefficient, top-10 concentration, tier breakdown

forensics.detect_bundle_activity

Find transaction clusters in same slot (MEV/bundle detection)

forensics.get_token_creation_info

Trace back to token mint creation transaction

Supporting Operations

Category

Operations

wallets

get_wallet_token_holdings, get_wallet_sol_transfers

trading

get_token_trades, get_wallet_swaps

tokens

get_token_largest_accounts, get_token_supply, get_signatures_for_address

transactions

get_parsed_transactions, get_transaction_history

balances

get_sol_balance, get_token_accounts

accounts

get_account_info, get_multiple_accounts

assets

get_asset, get_assets_by_owner, search_assets, get_asset_proof

fees

get_priority_fee

webhooks

create_webhook, list_webhooks, delete_webhook

programs

get_program_accounts

Usage

The server exposes 4 meta-tools:

solana_forensics_discover()      # Browse all operations
solana_forensics_get_schema(op)  # Get parameter details
solana_forensics_execute(op, {}) # Execute operation
solana_forensics_continue()      # Continue paginated results

Example: Trace Funding Sources

solana_forensics_execute("forensics.trace_sol_funding", {
    "address": "TARGET_WALLET",
    "max_hops": 3
})

Example: Detect Wash Trading

solana_forensics_execute("forensics.detect_wash_trading", {
    "mint": "TOKEN_MINT_ADDRESS",
    "limit": 100
})

Example: Find Common Funding Across Wallets

solana_forensics_execute("forensics.find_common_funding", {
    "addresses": ["WALLET_1", "WALLET_2", "WALLET_3"],
    "max_hops": 2
})

Example: Analyze Token Holder Distribution

solana_forensics_execute("forensics.analyze_holder_distribution", {
    "mint": "TOKEN_MINT_ADDRESS"
})

Requirements

  • Python 3.10+

  • uv package manager

  • Helius API key (free tier works)

Data Provider

Powered by Helius API for Solana blockchain data access.

Available Tools

4 tools
solana_forensics_continueA

Continue retrieving paginated results from a previous operation.

Args: session_id: Session ID from the paginated response. If not provided, uses the last paginated operation.

Inputs: session_id. Returns: result

solana_forensics_discoverA

Browse all available Solana forensics operations organized by category.

Returns a tree of operations with descriptions. Use this to explore what operations are available before executing them.

Inputs: no named parameters. Returns: result

solana_forensics_executeA

Execute a Solana forensics operation with the specified parameters.

Use solana_forensics_get_schema first to understand required parameters.

Args: operation: Operation identifier (e.g., 'forensics.trace_sol_funding') params: Operation parameters as defined in the schema

Returns the operation result. Large results are automatically paginated - use solana_forensics_continue to get next pages.

Inputs: operation (required), params. Returns: result

solana_forensics_get_schemaA

Get detailed parameter schema for a specific operation.

Args: operation: Operation identifier in format 'category.action' (e.g., 'forensics.trace_sol_funding', 'forensics.detect_wash_trading')

Returns parameter requirements, types, and descriptions.

Inputs: operation (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a distinct, non-overlapping purpose: discover lists operations, get_schema returns parameter details, execute runs an operation, and continue handles pagination. There is no ambiguity about which tool to use for a given step.

    Naming Consistency5/5

    All tools follow a consistent 'solana_forensics_<verb>' pattern (discover, get_schema, execute, continue). The naming convention is uniform and predictable, making the API easy to navigate.

    Tool Count5/5

    Four tools is well-scoped for a meta-interface. Each tool is necessary for the operation lifecycle (explore, inspect, execute, paginate), and there is no bloat or redundancy.

    Completeness5/5

    The tool set covers the full workflow: discovering available operations, fetching schemas, executing them, and continuing through paginated results. No obvious gaps exist for the stated purpose of a forensics operation interface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive analytics and insights for Solana wallets and their DeFi activities, including transaction tracking, DeFi position monitoring, risk profiling, and strategy recommendations.
      45 npm
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables blockchain forensics across multiple chains (Base, Ethereum, Arbitrum, Optimism, Polygon) with tools to trace transactions, cluster addresses, detect anomalies, and identify mixer usage.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Rug pull risk scores and on-chain forensics for memecoins on Solana, Ethereum, Base and Robinhood Chain - launch-bundle detection, funding-origin tracing, deployer history, insider networks and whale flow. 15 read-only tools.
      15
      34 npm
      MIT