# traql

Scores crypto addresses and transfers for AML risk on a 0–100 scale and hands the verdict to your agent. Useful when you need a look at a counterparty before sending funds.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: traql
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/traql/mcp-server
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/traql

## What it does

Two tools come with it. `check_address` takes a chain plus an address and returns a numeric score, a band running from `clean` to `critical`, flags such as sanctions or mixer contact, and the reasons behind them. `screen_transaction` rates both ends of a transfer — either ahead of broadcast via `from` and `to`, or after the fact by `tx_hash`.

Behind the scores sit sanctions lists, freeze records and attributions for hacks and mixers. Ethereum, BSC, TRON, TON and Bitcoin are covered. Each reply carries readable text and a `structuredContent` object, so an agent can parse it. When an upstream feed was degraded at compute time the reply sets `partial: true`; treat the number as a floor in that case.

Node.js 18+ is the only prerequisite. `TRAQL_API_KEY` is recommended rather than mandatory: a keyless mode runs with tighter limits, per-call payment and a coarser answer that gives one reason instead of itemized signals. Every successful inquiry draws one check from the account. Badly formed input is caught locally and costs nothing. Scores are advisory — they do not settle legal questions on their own.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TRAQL_API_KEY`, `TRAQL_API_URL`, `TRAQL_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TRAQL_API_KEY=<TRAQL_API_KEY> --env TRAQL_API_URL=<TRAQL_API_URL> --env TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> --transport stdio traql -- npx -y @traql/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add traql --env TRAQL_API_KEY=<TRAQL_API_KEY> --env TRAQL_API_URL=<TRAQL_API_URL> --env TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> -- npx -y @traql/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "traql": {
            "command": "npx",
            "args": [
                "-y",
                "@traql/mcp"
            ],
            "env": {
                "TRAQL_API_KEY": "<TRAQL_API_KEY>",
                "TRAQL_API_URL": "<TRAQL_API_URL>",
                "TRAQL_TIMEOUT_MS": "<TRAQL_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "traql": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@traql/mcp"
            ],
            "env": {
                "TRAQL_API_KEY": "<TRAQL_API_KEY>",
                "TRAQL_API_URL": "<TRAQL_API_URL>",
                "TRAQL_TIMEOUT_MS": "<TRAQL_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TRAQL_API_KEY=<TRAQL_API_KEY> -e TRAQL_API_URL=<TRAQL_API_URL> -e TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> traql npx -y @traql/mcp
```
Replace <…> with your own values

## When to use it
- vet a recipient address before you send funds
- see which categories pushed an address into a high band
- look up an on-chain transfer by its hash
- cross-check a counterparty against sanctions lists
- wire address screening into an automated pipeline

## Example prompts
- Check `0x8589427373d6d84e98730d7795d8f6f8731fda16` on ethereum — is it safe to send there?
- Screen both sides of a 1 USDT transfer on tron before I broadcast it
- Look up transaction `tx_hash` on bsc and tell me whether it touches sanctioned entities

## Similar
- [follow-the-crypto](https://affpapa.org/en/nevibecode/skills/follow-the-crypto.md) — skill · 1800 installs
- [sumsub-create-transaction](https://affpapa.org/en/nevibecode/skills/sumsub-create-transaction.md) — skill · 1200 installs
- [Hive Intelligence MCP](https://affpapa.org/en/nevibecode/mcp/hive-intelligence-mcp.md) — MCP server · ★ 20
- [emblem-ai-agent-wallet](https://affpapa.org/en/nevibecode/skills/emblemcompany-emblem-ai-agent-wallet.md) — skill · 8700 installs
- [gas-war-sniper-teneo](https://affpapa.org/en/nevibecode/skills/gas-war-sniper-teneo.md) — skill · 522 installs
- [cryptoquant-pro-2-10-teneo](https://affpapa.org/en/nevibecode/skills/cryptoquant-pro-2-10-teneo.md) — skill · 510 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md