traql MCP server

AML- und Compliance-Risikobewertung für Krypto-Adressen und Transaktionen, die KI-Agenten über das Model Context Protocol bereitgestellt wird.

Frag deinen Agenten „Ist es sicher, an diese Adresse zu senden?" – und du erhältst eine Risikobewertung von 0–100, eine Risikostufe, die zugrunde liegenden Risikokategorien und – mit einem API-Schlüssel – jedes einzelne Signal mit Quelle und Konfidenz.

ethereum address 0x8589427373d6d84e98730d7795d8f6f8731fda16
RISK 100/100 — CRITICAL
Flags: sanctions, mixer, scam

Signals (21):
  +80  [sanctions/eth_labels] direct.sanctions — sanctions label "Tornado.Cash: Donate" [entity Tornado.Cash: Donate, confidence 0.80]
  +68  [mixer/eth_labels] direct.mixer — mixer label "Tornado.Cash: Donate" [entity Tornado.Cash: Donate, confidence 0.80]
  +10  [mixer] behavior.mixer_contact — direct contact with mixer 0xdd4c48c0b24039969fc16d1cdf626eab821d3384
  +9   [sanctions/ofac_sdn] indirect.sanctions — sent to Semenov Roman (sanctions, 18% of USDC volume) [entity Semenov Roman, confidence 1.00]
  ... and 17 more

Computed at 2026-08-23T11:42:49Z.

Basierend auf traql: OFAC-SDN-, UK-OFSI-, EU- und UN-Sanktionslisten, Tether/Circle-Freeze-Ereignisse, kuratierte Attributionen von Hacks und Mixern und eine Kontrahenten-Exposure-Analyse über Ethereum, BSC, TRON, TON und Bitcoin.

Schnellstart

Erfordert Node.js 18+.

npx -y @traql/mcp

Der Server spricht MCP über stdio, du richtest also normalerweise einen Client auf ihn aus, statt ihn manuell auszuführen.

Claude Code

claude mcp add traql --env TRAQL_API_KEY=your_key -- npx -y @traql/mcp

Claude Desktop

Füge Folgendes in claude_desktop_config.json ein:

{
  "mcpServers": {
    "traql": {
      "command": "npx",
      "args": ["-y", "@traql/mcp"],
      "env": { "TRAQL_API_KEY": "your_key" }
    }
  }
}

Cursor

Füge Folgendes in ~/.cursor/mcp.json ein (oder in .cursor/mcp.json in einem Projekt), mit demselben mcpServers-Block wie oben.

VS Code

Füge Folgendes in .vscode/mcp.json ein:

{
  "servers": {
    "traql": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@traql/mcp"],
      "env": { "TRAQL_API_KEY": "your_key" }
    }
  }
}

Related MCP server: zarq-risk-intelligence

Einen API-Schlüssel erhalten

Registriere dich bei app.traql.io, bestätige deine E-Mail – kostenlose Checks sind enthalten – und erstelle einen Schlüssel unter API keys. Das Secret wird nur einmal angezeigt und kann jederzeit rotiert oder widerrufen werden.

Ohne Schlüssel läuft der Server weiterhin, aber auf der schlüssellosen Stufe: eine einzige grobe Begründung statt einzeln aufgeführter Signale, enge Rate-Limits und bei der gehosteten API eine x402-Zahlungspflicht pro Aufruf. Für die Agenten-Nutzung setze einen Schlüssel.

Konfiguration

Tools

check_address

Bewertet eine einzelne Adresse.

screen_transaction

Bewertet beide Seiten einer Überweisung, in einem der beiden Modi:

• Pre-flight – Echt alles from und to angeben (optional amount und asset), um eine Überweisung vor dem Absenden zu prüfen. Funktioniert auf jeder unterstützten Chain.

• By hash – nur tx_hash angeben, um eine bereits on-chain vorhandene Überweisung nachzuschlagen. Unterstützt auf Ethereum, BSC, TRON und TON.

Antwort

Beide Tools geben einen für Menschen lesbaren Text plus structuredContent zurück:

{
  "subject": { "type": "address", "chain": "ethereum", "address": "0x…" },
  "result": {
    "score": 100,
    "band": "critical",
    "flags": ["sanctions", "mixer", "scam"],
    "partial": false,
    "computed_at": "2026-08-23T11:42:49Z",
    "reasons": [
      {
        "code": "direct.sanctions",
        "message": "sanctions label \"Tornado.Cash: Donate\" from eth_labels (severity 100 × confidence 0.80 = 80.0)",
        "contribution": 80,
        "category": "sanctions",
        "source": "eth_labels",
        "entity": "Tornado.Cash: Donate",
        "severity": 100,
        "confidence": 0.8,
        "eff": 80.0
      }
    ]
  }
}

Score-Stufen: clean 0–9, low 10–39, elevated 40–69, high 70–89, critical 90–100.

partial: true bedeutet, dass eine vorgelagerte Datenquelle während der Berechnung eingeschränkt war – lies den Score als untere Grenze, nicht als endgültiges Urteil.

Jeder erfolgreiche Aufruf verbraucht einen Check aus dem konfigurierten Konto. Fehlerhafte Eingaben werden, soweit möglich, lokal abgelehnt und kosten daher nichts.

Entwicklung

npm install
npm run build
npm test

Anmerkungen

Die Scores sind Hinweissignale für Triage und Automatisierung. Sie sind keine rechtliche Feststellung von Fehlverhalten und erfüllen für sich allein keine regulatorische Verpflichtung.

Links

• traql.io – Produkt

• API-Dokumentation

• Dashboard

Lizenz

MIT