# On-Chain Forensics MCP Server 🔍⚡

> **Follow the money. Trace the flow. Find the truth on-chain.**

Blockchain forensics toolkit exposed as a Model Context Protocol (MCP) server. Trace transactions, cluster addresses, detect anomalies, and identify mixer usage across Base, Ethereum, Arbitrum, Optimism, and Polygon.

## What It Does

| Tool | What It Finds |
|------|---------------|
| `forensics_trace` | Transaction flow paths, fund sources and destinations |
| `forensics_cluster` | Address clusters by common input, temporal, amount heuristics |
| `forensics_anomaly` | Volume spikes, rapid transfers, unusual destination patterns |
| `forensics_mixer` | Tornado Cash and other mixer/tumbler usage |
| `forensics_report` | Structured investigation reports (standard, LE, exchange templates) |

## Install

```bash
pip install mcp-server-onchain-forensics
# OR
git clone https://github.com/manteclaw/mcp-server-onchain-forensics.git
```

## Connect

```json
{
  "mcpServers": {
    "onchain-forensics": {
      "command": "python",
      "args": ["/path/to/server.py"]
    }
  }
}
```

## Usage Examples

> "Trace this transaction 3 hops deep on Base"

> "Cluster these addresses and identify common ownership"

> "Detect mixer usage for this address"

## Pricing

| Tier | Price | Limits |
|------|-------|--------|
| Community | Free | 15 calls/day |
| Pro | $49/month | Unlimited + Dune integration |
| Enterprise | $349/month | Custom chains + real-time alerts |

## License

MIT

---

*Built by Manteclaw | Base L2 native | Follow the chain*