Skip to main content
Glama
glittercowboy

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: NoesisAPI

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.

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/glittercowboy/solana-forensics-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server