Satoshkin Aml MCP server

Satoshkin AML/KYT MCP Server

MCP server for AML/KYT crypto wallet screening. It is designed to connect AI clients such as Claude Desktop, Claude Code, ChatGPT MCP clients, and internal agent tools to Satoshkin wallet risk checks.

This MCP server provides AI assistants with crypto compliance tools for AML (Anti-Money Laundering) and KYT (Know Your Transaction) screening. Compatible with Claude Desktop, Claude Code, and any MCP-compatible client.

With an API key configured, checks return real BitOK-backed data: risk score 0-100, risk level, source-of-funds tags, activity dates, and volume totals. Without a key the server runs in clearly-labeled mock mode.

Status

v0.2.0 performs real AML/KYT screening through the Satoshkin backend (POST /api-accounts/aml-check, BitOK data) when SATOSHKINAPIKEY is set.

Without an API key the server runs in mock mode: deterministic, clearly-labeled placeholder responses that can never be mistaken for a real verdict.

This repository does not contain BitOK credentials, production AML/KYT business logic, user data, or paid-tier enforcement. Those belong in the private backend service.

Available Tool

checkwalletaml

Checks a crypto wallet address for AML/KYT risk. Addresses are validated against per-chain formats client-side before any quota is spent.

Input:

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "chain": "BTC"
}

Supported chain values:

• BTC
• ETH
• TRON
• USDT-ERC20
• USDT-TRC20

Real output (with SATOSHKINAPIKEY):

{
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "chain": "BTC",
  "checked_at": "2026-06-10T12:00:00.000Z",
  "risk_score": 17,
  "risk_level": "low",
  "tags": ["exchange"],
  "first_activity": "2021-01-01",
  "last_activity": "2026-06-01",
  "total_volume_in_usd": "1000.00",
  "total_volume_out_usd": "900.00",
  "source": "bitok",
  "cache_hit": false,
  "rate_limit": { "remaining": 999, "resets_at": "2026-06-10T13:00:00.000Z" },
  "balance": { "charged_usd": "0.55", "after_usd": "9.45" }
}

Errors come back as structured isError payloads with machine-readable codes: unauthorized, insufficientbalance, ratelimited, validationerror, bitokupstreamerror, bitoktimeout, upstreamunreachable, invalidresponse, internalerror, and http (fallback when a backend error body has no error field). Every error payload also carries an http_status field.

Results are informational risk indicators, not legal or compliance advice.

Configuration

Claude Desktop / Claude Code

This package is not published to npm yet. Use the public GitHub repository through npx.

Add this to your MCP settings:

{
  "mcpServers": {
    "satoshkin-aml": {
      "command": "npx",
      "args": ["-y", "github:satoshkin-dev/satoshkin-aml-mcp"],
      "env": {
        "SATOSHKIN_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Omit the env block to run in mock mode.

For local development, use the built entrypoint:

Shortened. The full README is on GitHub.