# traql MCP server

> Provides AML and compliance risk scoring for cryptocurrency addresses and transactions across multiple blockchain networks.

- Repository: https://github.com/traql/mcp-server
- Page: https://hostedmcp.org/servers/traql/mcp-server
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.2

## Install

### Claude Code

```sh
claude mcp add --env 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' mcp-server -- npx -y @traql/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@traql/mcp"
      ],
      "env": {
        "TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@traql/mcp"
      ],
      "env": {
        "TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@traql/mcp"],"env":{"TRAQL_API_KEY":"<YOUR_TRAQL_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@traql/mcp"
      ],
      "env": {
        "TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp-server --env 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' -- npx -y @traql/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
command = "npx"
args = ["-y", "@traql/mcp"]

[mcp_servers.mcp-server.env]
TRAQL_API_KEY = "<YOUR_TRAQL_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' mcp-server npx -- -y @traql/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@traql/mcp"
      ],
      "env": {
        "TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `TRAQL_API_KEY` | no | yes | API key from https://app.traql.io. Without it the server runs on the keyless tier: a coarse verdict, 3 free checks per IP per day, then payment-gated on the hosted API. |
| `TRAQL_API_URL` | no | no | Base URL of the traql API. Override only when self-hosting. |
| `TRAQL_TIMEOUT_MS` | no | no | Per-request timeout in milliseconds. |

## Tools (2)

- `check_address`: Score a single crypto address for AML and compliance risk. Returns a risk score from 0 (clean) to 100 (critical), the band it falls into, and the risk categories that drove it — sanctions, mixer, scam, darknet, stolen_funds, ransomware, high_risk_exchange and others. With an API key configured, the response also itemizes every contributing signal with its data source, severity and confidence, so the verdict can be explained rather than just asserted. Use it before sending funds to an unfamiliar address, to triage an address a user pasted, to check a counterparty in an investigation, or to vet a deposit address. Covers Ethereum, BSC, TRON, TON and Bitcoin. Each call consumes one check from the configured traql account. (read-only)
- `screen_transaction`: Screen a transaction for AML and compliance risk by scoring both sides of the transfer. Two modes, chosen by which arguments are given: - Pre-flight — pass `from` and `to` (optionally `amount` and `asset`) to screen a transfer before it is broadcast. Works on every supported chain. - By hash — pass only `tx_hash` to look up a transaction that is already on-chain. Supported on ethereum, bsc, tron and ton. Returns the same score, band, flags and itemized signals as an address check, with each signal marked as applying to the sending or receiving side. Use it as a pre-send safety gate, or to review a payment that already went out. Each call consumes one check from the configured traql account. (read-only)

## FAQ

### Do I need an API key to use the server?

No, the server runs on a keyless tier that allows 3 free checks per IP per day, though responses are coarser and rate limits are tighter.

### What information is provided with an API key?

An API key unlocks itemized signals, including every individual signal with its source and confidence level.

### Are the risk scores legal determinations?

No, the scores are advisory signals for triage and automation and do not constitute a legal determination of wrongdoing.
