traql — MCP-сервер для Claude Code: проверка адресов на AML-риск
Оценивает AML-риск криптоадресов и транзакций по шкале от 0 до 100 и отдаёт результат агенту. Пригодится, когда нужно проверить контрагента до перевода.
claude mcp add --env TRAQL_API_KEY=<TRAQL_API_KEY> --env TRAQL_API_URL=<TRAQL_API_URL> --env TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> --transport stdio traql -- npx -y @traql/mcpЧто делает traql
Сервер отдаёт агенту две операции. check_address берёт сеть и адрес и возвращает оценку риска числом, полосу (clean до critical), флаги вроде санкций или миксера и разбор причин с источником каждой. screen_transaction проверяет обе стороны перевода: до отправки по паре from и to, либо по tx_hash для уже прошедшей транзакции.
Данные — санкционные списки, сведения о заморозках и атрибуции взломов и миксеров; поддерживаются Ethereum, BSC, TRON, TON и Bitcoin. Ответ приходит текстом и полем structuredContent, так что агент может разобрать его программно. Поле partial: true означает, что один из источников в момент расчёта был недоступен, и тогда оценку стоит читать как нижнюю границу.
Нужен Node.js 18 или новее. Ключ TRAQL_API_KEY формально необязателен: без него работает бесключевой режим с жёсткими лимитами, платной оплатой за вызов и укрупнённым ответом — одна формулировка причины вместо списка сигналов. Каждый успешный вызов списывает проверку с аккаунта, а заведомо некорректный ввод отсекается на месте и не стоит ничего. Оценки носят справочный характер и не заменяют юридического заключения.
Какие задачи решает
- проверить адрес получателя перед отправкой средств
- разобрать, из-за чего у адреса высокий риск
- прогнать уже отправленную транзакцию по хешу
- сверить контрагента с санкционными списками
- встроить проверку адресов в автоматический пайплайн
Примеры запросов агенту
- Проверь адрес
0x8589427373d6d84e98730d7795d8f6f8731fda16в сети ethereum: можно ли на него отправлять? - Прежде чем переводить 1 USDT, проверь пару отправитель-получатель в сети tron
- Посмотри транзакцию
tx_hashв сети bsc и скажи, есть ли там санкционные контакты
Как установить traql
Командой платформы
claude mcp add --env TRAQL_API_KEY=<TRAQL_API_KEY> --env TRAQL_API_URL=<TRAQL_API_URL> --env TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> --transport stdio traql -- npx -y @traql/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add traql --env TRAQL_API_KEY=<TRAQL_API_KEY> --env TRAQL_API_URL=<TRAQL_API_URL> --env TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> -- npx -y @traql/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"traql": {
"command": "npx",
"args": [
"-y",
"@traql/mcp"
],
"env": {
"TRAQL_API_KEY": "<TRAQL_API_KEY>",
"TRAQL_API_URL": "<TRAQL_API_URL>",
"TRAQL_TIMEOUT_MS": "<TRAQL_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"traql": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@traql/mcp"
],
"env": {
"TRAQL_API_KEY": "<TRAQL_API_KEY>",
"TRAQL_API_URL": "<TRAQL_API_URL>",
"TRAQL_TIMEOUT_MS": "<TRAQL_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e TRAQL_API_KEY=<TRAQL_API_KEY> -e TRAQL_API_URL=<TRAQL_API_URL> -e TRAQL_TIMEOUT_MS=<TRAQL_TIMEOUT_MS> traql npx -y @traql/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о traql
Как установить traql в Claude Code?
Выполните claude mcp add traql --env TRAQL_API_KEY=your_key -- npx -y @traql/mcp. Если нужны свои адрес API и таймаут, добавьте их флагами --env TRAQL_API_URL=... --env TRAQL_TIMEOUT_MS=... и укажите транспорт --transport stdio.
Что делает traql?
Считает AML-риск криптоадреса или транзакции и возвращает агенту число от 0 до 100, полосу риска, флаги и причины. С ключом API причины приходят отдельными сигналами с указанием источника и уверенности.
Можно ли пользоваться без API-ключа?
Да, но с ограничениями: число бесплатных проверок на IP в сутки невелико, дальше запрос требует оплаты за вызов, лимиты строже, а ответ грубее — вместо сигналов одна причина. Для постоянной работы ключ нужен.
