Solana Forensics

FreeNot checked

On-chain investigation and analysis tools for Solana blockchain, enabling detection of wash trading, funding source tracing, holder concentration analysis, and

by glittercowboy

GitHub Embed

About

On-chain investigation and analysis tools for Solana blockchain, enabling detection of wash trading, funding source tracing, holder concentration analysis, and MEV/bundle activity identification.

README

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

2. Install

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

3. Configure Your Client

Claude Desktop

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.

Claude Code (CLI)

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__*.

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

from github.com/glittercowboy/solana-forensics-mcp

Installing Solana Forensics

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/glittercowboy/solana-forensics-mcp

FAQ

Is Solana Forensics MCP free?

Yes, Solana Forensics MCP is free — one-click install via Unyly at no cost.

Does Solana Forensics need an API key?

No, Solana Forensics runs without API keys or environment variables.

Is Solana Forensics hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Solana Forensics in Claude Desktop, Claude Code or Cursor?

Open Solana Forensics on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.