traql MCP server

Скоринг AML- и комплаенс-рисков для криптовалютных адресов и транзакций, предоставляемый ИИ-агентам через Model Context Protocol.

Спросите своего агента: «безопасно ли отправлять на этот адрес?» — и он вернёт оценку риска от 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, EU и UN, инциденты заморозок Tether/Circle, выверенные атрибуции взломов и миксеров, а также анализ контрагентских рисков в Ethereum, BSC, TRON, TON и Bitcoin.

Быстрый старт

Требуется Node.js 18+.

npx -y @traql/mcp

Сервер общается с MCP через stdio, поэтому обычно вы подключаете к нему клиент, а не запускаете его вручную.

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. Секрет показывается один раз; его можно перевыпустить или отозвать в любое время.

Без ключа сервер всё равно работает, но в тарифе без ключа: одна укрупнённая формулировка причины вместо детализированных сигналов, жёсткие лимиты запросов, а на облачном API — требование оплаты за каждый вызов x402. Для использования с агентами установите ключ.

Конфигурация

Инструменты

check_address

Оценивает один адрес.

screen_transaction

Оценивает обе стороны перевода в одном из двух режимов:

• Pre-flight — передайте from и to (по желанию amount и asset), чтобы проверить перевод перед его отправкой в сеть. Работает во всех поддерживаемых сетях.

• By hash — передайте только tx_hash, чтобы найти транзакцию, уже находящуюся в блокчейне. Поддерживается на Ethereum, BSC, TRON и TON.

Ответ

Оба инструмента возвращают читаемый текст и 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 documentation — документация API

• Dashboard — панель управления

Лицензия

MIT