traql MCP server

Puntuación de riesgo AML y de cumplimiento para direcciones y transacciones de criptomonedas, expuesta a agentes de IA a través del Model Context Protocol.

Pregunta a tu agente "¿es seguro enviar a esta dirección?" y obtendrás una puntuación de riesgo de 0–100, una banda, las categorías de riesgo asociadas y, con una clave de API, cada señal individual con su fuente y nivel de confianza.

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.

Con el respaldo de traql: listas de sanciones de OFAC SDN, OFSI del Reino Unido, la UE y la ONU, eventos de congelación de Tether/Circle, atribuciones seleccionadas de hacks y mezcladores, y análisis de exposición de contrapartes en Ethereum, BSC, TRON, TON y Bitcoin.

Inicio rápido

Requiere Node.js 18+.

npx -y @traql/mcp

El servidor habla MCP sobre stdio, así que normalmente apuntarás un cliente hacia él en lugar de ejecutarlo manualmente.

Claude Code

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

Claude Desktop

Añade a claude_desktop_config.json:

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

Cursor

Añade a ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto) usando el mismo bloque mcpServers de arriba.

VS Code

Añade a .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

Cómo obtener una clave de API

Regístrate en app.traql.io, confirma tu correo electrónico — se incluyen comprobaciones gratuitas — y emite una clave en API keys. El secreto se muestra una sola vez; se puede rotar o revocar en cualquier momento.

Sin clave, el servidor sigue funcionando, pero en el modo sin clave: una única frase de motivo general en lugar de señales detalladas, límites de solicitud estrictos y, en la API alojada, un requisito de pago por llamada x402. Para uso con agentes, configura una clave.

Configuración

Herramientas

check_address

Puntúa una sola dirección.

screen_transaction

Puntúa ambos lados de una transferencia, en uno de dos modos:

• Pre-flight — pasa from y to (opcionalmente amount y asset) para evaluar una transferencia antes de emitirla. Funciona en todas las cadenas compatibles.

• Por hash — pasa únicamente tx_hash para consultar una transacción que ya está en cadena. Compatible con Ethereum, BSC, TRON y TON.

Respuesta

Ambas herramientas devuelven texto legible por humanos y 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
      }
    ]
  }
}

Bandas de puntuación: clean 0–9, low 10–39, elevated 40–69, high 70–89, critical 90–100.

partial: true significa que una fuente de datos anterior estaba degradada al calcular el resultado; interpreta la puntuación como un límite inferior, no como un veredicto final.

Cada llamada correcta consume una verificación de la cuenta configurada. La entrada malformada se rechaza localmente cuando es posible, por lo que no cuesta nada.

Desarrollo

npm install
npm run build
npm test

Notas

Las puntuaciones son señales orientativas para la priorización y la automatización. No constituyen una determinación legal de irregularidad y, por sí mismas, no eximen de ninguna obligación regulatoria.

Enlaces

• traql.io — producto

• Documentación de la API

• Panel de control

Licencia

MIT