Provides AML and compliance risk scoring for cryptocurrency addresses and transactions across multiple blockchain networks.
Also known as traql/mcp-server, mcp-server, @traql/mcp
- Stars
- 0
- Tools
- 2
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Oct 27, 2026
- License
- MIT
What is traql MCP?
traql provides AML and compliance risk scoring for cryptocurrency addresses and transactions across multiple blockchain networks. It exposes 2 tools, such as check_address, screen_transaction.
Summary generated from the project's README
How to install traql MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall traql MCP in Claude Code
$ claude mcp add --env 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' mcp-server -- npx -y @traql/mcpInstall traql MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@traql/mcp"
],
"env": {
"TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
}
}
}
}Install traql MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@traql/mcp"
],
"env": {
"TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
}
}
}
}Install traql MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@traql/mcp"],"env":{"TRAQL_API_KEY":"<YOUR_TRAQL_API_KEY>"}}'Install traql MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@traql/mcp"
],
"env": {
"TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
}
}
}
}Install traql MCP in Codex
$ codex mcp add mcp-server --env 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' -- npx -y @traql/mcpInstall traql MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@traql/mcp"] [mcp_servers.mcp-server.env] TRAQL_API_KEY = "<YOUR_TRAQL_API_KEY>"
Install traql MCP in Gemini CLI
$ gemini mcp add -s user -e 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' mcp-server npx -- -y @traql/mcpInstall traql MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@traql/mcp"
],
"env": {
"TRAQL_API_KEY": "<YOUR_TRAQL_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @traql/mcp 0.1.2 in an isolated container with no network and no keys. It answered and listed 2 tools.
traql MCP tools 2
Read from the server with tools/listcheck_addressRead-onlyScore 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.
screen_transactionRead-onlyScreen 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.
Configuration
TRAQL_API_KEYSecretAPI 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_URLBase URL of the traql API. Override only when self-hosting.
TRAQL_TIMEOUT_MSPer-request timeout in milliseconds.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletraql/mcp-server is public and reachablegithub.com/traql/mcp-server ↗Pass
- Package names this repository as its source@traql/mcp names traql/mcp-server as sourcenpmjs.com/package/@traql/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @traql/mcpnpmjs.com/package/@traql/mcp/v/0.1.2#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-27github.com/traql/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @traql/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubtraql MCP server
AML and compliance risk scoring for crypto addresses and transactions, exposed to AI agents over the Model Context Protocol.
Ask your agent "is it safe to send to this address?" and it gets back a 0–100 risk score, a band, the risk categories behind it, and — with an API key — every individual signal with its source and confidence.
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.
Backed by traql: OFAC SDN, UK OFSI, EU and UN sanctions lists, Tether/Circle freeze events, curated hack and mixer attributions, and counterparty exposure analysis across Ethereum, BSC, TRON, TON and Bitcoin.
Quick start
Requires Node.js 18+.
npx -y @traql/mcp
The server speaks MCP over stdio, so you normally point a client at it rather than running it by hand.
Claude Code
claude mcp add traql --env TRAQL_API_KEY=your_key -- npx -y @traql/mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"traql": {
"command": "npx",
"args": ["-y", "@traql/mcp"],
"env": { "TRAQL_API_KEY": "your_key" }
}
}
}
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project) using the same
mcpServers block as above.
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"traql": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@traql/mcp"],
"env": { "TRAQL_API_KEY": "your_key" }
}
}
}
Getting an API key
Sign up at app.traql.io, confirm your email — free checks are included — and issue a key under API keys. The secret is shown once; it can be rotated or revoked at any time.
Without a key the server still runs, on the keyless tier: the hosted API serves 3 free checks per IP per day so you can try it immediately, then asks for per-call payment over x402. Keyless responses are also coarser — a single reason phrase instead of itemized signals — and rate limits are tighter. For anything beyond a first look, set a key.
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
TRAQL_API_KEY |
recommended | — | API key from the traql dashboard. Sent as X-API-Key. Unlocks itemized signals and higher limits. |
TRAQL_API_URL |
no | https://api.traql.io |
Base URL of the API. Point it at your own deployment if you self-host traql. |
TRAQL_TIMEOUT_MS |
no | 30000 |
Per-request timeout in milliseconds. |
Tools
check_address
Scores a single address.
| Argument | Type | Required | Description |
|---|---|---|---|
chain |
ethereum | bsc | tron | ton | bitcoin |
yes | Network the address belongs to. |
address |
string | yes | Address in the chain's native format. |
screen_transaction
Scores both sides of a transfer, in one of two modes:
- Pre-flight — pass
fromandto(optionallyamountandasset) to screen a transfer before broadcasting it. Works on every supported chain. - By hash — pass
tx_hashalone to look up a transaction that is already on-chain. Supported on Ethereum, BSC, TRON and TON.
| Argument | Type | Required | Description |
|---|---|---|---|
chain |
chain enum | yes | Network the transaction belongs to. |
from |
string | pre-flight | Sender address. |
to |
string | pre-flight | Recipient address. |
amount |
string | no | Integer amount in the asset's base units (e.g. 1000000 for 1 USDT). |
asset |
string | no | Asset or token symbol, e.g. USDT. |
tx_hash |
string | by-hash | Hash of a broadcast transaction. Mutually exclusive with from/to. |
Response
Both tools return human-readable text plus 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
}
]
}
}
Score bands: clean 0–9, low 10–39, elevated 40–69, high 70–89,
critical 90–100.
partial: true means an upstream data source was degraded while computing the
result — read the score as a lower bound, not a final verdict.
Each successful call consumes one check from the configured account. Malformed input is rejected locally where possible, so it costs nothing.
Development
npm install
npm run build
npm test
Notes
Scores are advisory signals for triage and automation. They are not a legal determination of wrongdoing, and they do not by themselves discharge any regulatory obligation.
Links
- traql.io — product
- API documentation
- Dashboard
License
MIT
traql MCP questions
How do I add traql MCP to Claude Code?
Run claude mcp add --env 'TRAQL_API_KEY=<YOUR_TRAQL_API_KEY>' mcp-server -- npx -y @traql/mcp in your terminal. Add --scope user to make it available in every project.
How do I add traql MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does traql MCP provide?
It exposes 2 tools, including check_address, screen_transaction.
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.