Skip to main content
Glama
deenesjakoruzh
traql

traql MCP server

Official
by traql
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

traql MCP server

npm CI License: MIT

为加密货币地址和交易提供 AML 与合规风险评分，并通过 Model Context Protocol 开放给 AI 智能体使用。

向你的智能体询问 “发送到这个地址安全吗？”，它会返回一个 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、UK 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

添加到 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json），使用与上面相同的 mcpServers 配置块即可。

VS Code

添加到 .vscode/mcp.json：

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

Related MCP server: zarq-risk-intelligence

获取 API 密钥

在 app.traql.io 注册，确认你的邮箱（包含免费检查次数），然后在 API keys 下签发一个密钥。密钥只显示一次；你可以随时轮换或撤销它。

如果没有密钥，服务器仍然可以运行，但会处于无密钥模式：只返回一个粗略的原因短语，而非逐项信号；速率限制很严格；若使用托管 API，还需为每次调用满足 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

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

  • Pre-flight（发送前） — 在广播转账前，传入 from 和 to（可选 amount 和 asset）进行筛查。适用于所有受支持的链。

  • By hash（按哈希） — 仅传入 tx_hash，即可查询已在链上的交易。适用于 Ethereum、BSC、TRON 和 TON。

参数

类型

是否必需

说明

chain

链枚举

是

交易所属的网络。

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

说明

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

链接

License

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • BICScan MCP Server

    ahnlabio
    A
    license
    B
    quality
    C
    maintenance
    Provides blockchain address risk scoring and asset information through the BICScan API, allowing users to assess risks for crypto addresses, domains, and dApps on a scale of 0-100.
    2
    17
    MIT

  • BlackSwan MCP Server

    blackswanwtf
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to access real-time crypto risk intelligence with two tools: Flare for precursor detection and Core for overall risk environment assessment.
    4

View all related MCP servers

Related MCP Connectors

  • Didit MCP Server

    KYC, KYB, AML, wallet screening, transaction monitoring, and fraud workflows for AI agents.

  • SanctionsAI

    OFAC sanctions screening for AI agents: screen names, wallets, entities against the SDN list.

  • blockscout-mcp-server

    Provide AI agents and automation tools with contextual access to blockchain data including balance…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/traql/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server