traql

traql MCP サーバー

Model Context Protocolを通じてAIエージェントに提供される、暗号資産アドレスおよびトランザクションのAML・コンプライアンスリスクスコアリングです。

エージェントに 「このアドレスに送金しても安全ですか？」 と尋ねると、0〜100のリスクスコア、リスクレベル、スコアの根拠となるリスクカテゴリが返されます。また、APIキーがあれば、各シグナルの情報源と信頼度も確認できます。

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.

traqlを基盤とし、OFAC SDN、英国OFSI、EUおよび国連の制裁リスト、Tether／Circleの凍結イベント、精選されたハッキングおよびミキサーの関連情報、さらにEthereum、BSC、TRON、TON、Bitcoinにまたがる取引相手のエクスポージャー分析を提供します。

クイックスタート

Node.js 18以降が必要です。

npx -y @traql/mcp

このサーバーはstdio経由でMCPを使用するため、通常は手動で起動するのではなく、クライアントから接続します。

Claude Code

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

Claude Desktop

claude_desktop_config.jsonに追加します。

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

Cursor

上記と同じmcpServersブロックを使用して、~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）に追加します。

VS Code

.vscode/mcp.jsonに追加します。

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

APIキーの取得

app.traql.ioで登録し、メールアドレスを確認します。無料チェックが含まれています。続いて、API keysからキーを発行します。シークレットが表示されるのは一度だけですが、いつでもローテーションまたは失効させることができます。

キーがなくても、キーレスプランでサーバーを利用できます。ホストされたAPIでは、まずIPアドレスごとに1日3回まで無料でチェックでき、その後はx402経由でリクエストごとの支払いを求められます。キーレスの応答は情報も簡略化され、項目別シグナルの代わりに単一の理由フレーズが返され、レート制限も厳しくなります。最初の確認以上の用途には、キーを設定してください。

設定

変数	必須	デフォルト	説明
TRAQL_API_KEY	推奨	—	traqlダッシュボードで取得したAPIキーです。X-API-Keyとして送信されます。項目別シグナルとより高い上限が利用可能になります。
TRAQL_API_URL	いいえ	https://api.traql.io	APIのベースURLです。traqlをセルフホストする場合は、独自のデプロイ先を指定してください。
TRAQL_TIMEOUT_MS	いいえ	30000	リクエストごとのタイムアウト時間（ミリ秒）です。

ツール

check_address

単一のアドレスをスコアリングします。

引数	型	必須	説明
chain	ethereum | bsc | tron | ton | bitcoin	はい	アドレスが属するネットワークです。
address	string	はい	チェーン固有の形式のアドレスです。

screen_transaction

次の2つのモードのいずれかで、送金の両側をスコアリングします。

• 事前チェック — fromとto（任意でamountとasset）を渡し、ブロードキャスト前に送金をチェックします。サポート対象のすべてのチェーンで利用できます。
• ハッシュによる検索 — tx_hashのみを渡し、すでにオンチェーンにあるトランザクションを検索します。Ethereum、BSC、TRON、TONで利用できます。

引数	型	必須	説明
chain	chain enum	はい	トランザクションが属するネットワークです。
from	string	事前チェック	送信者のアドレスです。
to	string	事前チェック	受信者のアドレスです。
amount	string	いいえ	アセットの基本単位での整数の金額です（例：1 USDTの場合は1000000）。
asset	string	いいえ	アセットまたはトークンのシンボルです（例：USDT）。
tx_hash	string	ハッシュによる検索	ブロードキャスト済みトランザクションのハッシュです。from／toとは併用できません。

応答

どちらのツールも、人が読めるテキストと structuredContent を返します。

{
  "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
      }
    ]
  }
}

スコア帯：clean 0～9、low 10～39、elevated 40～69、high 70～89、 critical 90～100。

partial: true は、結果の計算中に上流のデータソースが劣化していたことを意味します。スコアは最終判断ではなく、下限値として読み取ってください。

呼び出しが成功するたびに、設定済みアカウントのチェックを1回消費します。不正な入力は可能な限りローカルで拒否されるため、チェックを消費しません。

開発

npm install
npm run build
npm test

注記

スコアは、トリアージと自動化のための参考情報です。不正行為に関する法的判断ではなく、それだけで規制上の義務を履行したことにはなりません。

リンク

• traql.io — 製品
• API ドキュメント
• ダッシュボード

ライセンス

MIT