traql

traql MCP 服务

为 AI Agent 提供加密货币地址和交易的 AML 与合规风险评分，基于 Model Context Protocol 开放使用。

向你的 Agent 询问 “向这个地址转账安全吗？”，它便会返回一个 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、欧盟和联合国制裁 名单、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 每天提供 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

以以下两种模式之一对转账双方进行评分：

• 转账前 — 传入 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 表示计算结果时上游数据源出现降级——应将该分数视为下限，而非最终结论。

每次成功调用都会消耗配置账户的一次检查额度。可能的情况下，格式错误的输入会在本地拒绝，因此不会产生费用。

开发

npm install
npm run build
npm test

说明

评分是用于分流和自动化的参考信号。它们不是对不当行为的法律认定，也不能单独免除任何监管义务。

链接

• traql.io — 产品
• API 文档
• 控制面板

许可证

MIT