# On-chain Forensics

> On-chain Forensics is a freemium MCP server for finance and payments. Letter-grade token due diligence for agents, from mint checks to settle-safe screens. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://onchainforensics.dev
- **Repository:** https://github.com/leohoudinisanders-byte/forensics-mcp
- **MCP Registry name:** dev.onchainforensics/forensics-mcp
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

Grades are computed by fixed rules over live chain reads. The README stresses that no LLM is in the decision path, so a token should grade the same way twice and a paid result can be re-run and checked. The operator's site covers any ERC-20 on Base, Ethereum and Robinhood Chain.

The composed Due Diligence Memo, priced at $0.25, joins a verdict, 24-hour supply forensics, wallet flows and a settle-safe screen into one report with a red-flag table and a bottom-line settlement recommendation. Smaller reads include a deployer lookup with an OFAC screen, a one-word trust answer, supply and holder views and a verified-registry check. Unresolved deployers are reported as null, never guessed.

Access is pay-per-call with USDC over x402, with a free daily allowance first and a free developer key for 10,000 calls a month. The README ships a stdio package, onchain-forensics-mcp, while the registry lists a hosted endpoint.

## Features

- **Token verdict:** An A-F grade, verdict tier, activity score and concentration flags.
- **Mint check:** Mint events, minted amount and mint authority over an exact window.
- **Settle-safe check:** Registry canonicality, ERC-20 readability and pause state.
- **Deployer lookup:** Deploying address, creation transaction and an OFAC screen.
- **Due diligence memo:** One reproducible report with a red-flag table.
- **Deterministic output:** No LLM in the pipeline; same inputs give the same result.

## Good for

- Grade a token before an agent buys
- Check whether a token is being printed
- Confirm a token can actually settle
- Screen who deployed a contract

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http forensics-mcp https://solene-fa2010da.base44.app/functions/forensicsMcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://solene-fa2010da.base44.app/functions/forensicsMcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "forensics-mcp": {
      "url": "https://solene-fa2010da.base44.app/functions/forensicsMcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "forensics-mcp": {
      "type": "http",
      "url": "https://solene-fa2010da.base44.app/functions/forensicsMcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "forensics-mcp": {
      "serverUrl": "https://solene-fa2010da.base44.app/functions/forensicsMcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "forensics-mcp": {
      "type": "http",
      "url": "https://solene-fa2010da.base44.app/functions/forensicsMcp"
    }
  }
}
```

## Tools

- `forensics_info`: FREE. Service directory for the On-chain Forensics MCP server: endpoint catalog, chains supported (Base, Ethereum, XRPL), pricing, tokenized-equity aliases (btsla, bcspx, rlusd, bitstamp-usd, ...) and usage examples.
- `token_verdict`: $0.02. Token verdict card for any ERC-20 on Base or Ethereum (address+chain), any registered alias (token=btsla|ondo|edel|...), or any XRPL issued currency (chain=xrp + issuer + currency): activity score 0-100, verdict tier (RED_HOT/HEAVY_FIRE/ACTIVE/THIN/SUSPICIOUS_THIN/DORMANT), transfers, unique wallets, mints/burns, concentration, whale flags, plain-English take.
- `settle_safe`: $0.02. FLAGSHIP pre-trade settle-safe screen for AI agents trading tokenized equities/RWAs: canonical-asset check against the verified registry (EVM: btsla/bcspx/bnvda/aapl/nvda/usdy/ousg/...; XRPL issuers: rlusd, gatehub-usd, bitstamp-usd/eur), freeze/clawback flags, trustline breadth, optional counterparty wallet trust tier.
- `wallet_screen`: $0.05. Wallet trust screen for any wallet on Base, Ethereum or XRPL (chain=xrp): balance, tx count, flows, top counterparties, contract-interaction risk, trust tier. For XRPL also trustlines and issuer screens.
- `token_profile`: $0.05. Full ERC-20 forensics profile on Base or Ethereum: exact 24h net supply change, recent mint/burn events, holder concentration, top transfers, whale moves.
- `diligence_memo`: $0.25 composed Token Due-Diligence Memo (decision-grade, reproducible, no LLM calls): verdict + supply/flow forensics + settle-safe screen + narrative risk assessment. $0.35 when counterparty is provided (adds the settlement counterparty trust screen). EVM or XRPL.

## FAQ

### What does it cost?

Per-call prices run from $0.001 for a verdict after the free trial up to $0.25 for a memo, paid in USDC over x402.

### Is there a free tier?

Yes: a daily free allowance per route and a free developer key with 10,000 calls a month.

### Which chains are covered?

Base, Ethereum and Robinhood Chain, per the site.

### Is any AI used for grading?

No. The README says no LLM sits in the decision path.

### Is On-chain Forensics free?

On-chain Forensics has a free plan, with paid plans for more usage or features.

### How do I add On-chain Forensics to Claude Code?

Run this command in your terminal: claude mcp add --transport http forensics-mcp https://solene-fa2010da.base44.app/functions/forensicsMcp

### What are the best alternatives to On-chain Forensics?

The closest alternatives to On-chain Forensics are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/on-chain-forensics
