# On-chain Forensics

> On-chain Forensics is a freemium MCP server for finance and payments. Pay-per-call token due-diligence MCP: letter grades, mint checks and 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:** io.github.leohoudinisanders-byte/forensics-mcp
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

Every answer is built from deterministic rules over live chain reads, and the site stresses that no language model sits in the decision path, so the same token grades the same way twice. It covers ERC-20 tokens on Base and Ethereum, plus Robinhood Chain Stock Tokens.

The hosted API charges per call in USDC over x402 with no keys or subscriptions: a verdict card is listed at $0.02, a deployer lookup at $0.05 and a composed due-diligence memo at $0.25. The npm stdio server lists lower per-tool prices after a free trial. Visitors get a few free reads a day without a wallet.

The site quotes a third-party audit by paidfor.dev showing no failed deliveries in six paid calls, and publishes a ledger of 500 graded tokens.

## Features

- **Token verdict:** Letter grade A to F, verdict tier and activity score.
- **Mint tracking:** Mint events, minted amount and authority for a window.
- **Settle-safe screen:** Checks registry canonicality, readability and pause state.
- **Wallet profiles:** Shows what a wallet holds and whether it looks real.
- **Free trial calls:** A few reads a day need no wallet.

## Good for

- Grade a token before an agent buys it
- Check whether a token is being minted
- Screen a token before settling a payment
- Profile a deployer wallet

## 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

### How do I pay?

In USDC over x402 on Base, per call, with no API key.

### Is any of it free?

Yes, a daily free tier lets visitors try calls without a wallet.

### Does it use an LLM to grade?

No. The site says grades come from deterministic rules.

### 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-2
