Does the server work without an API key?

Yes, in mock mode: without a key, check_wallet_aml returns test data so you can verify the integration. Real AML checks require an sk_live_... key with balance.

How does billing work?

Each successful check deducts $0.55 from your key balance — always, from the very first check, no subscriptions, no tiers. The balance is shared across web, API and MCP. Top-ups start at $10 and credit exactly what you pay.

Is this financial or legal advice?

No. risk_score and tags are an informational assessment based on BitOK blockchain analytics. Transfer decisions and compliance conclusions remain yours.

What are the rate limits?

The rate limit is 1000 requests per hour per key. Contact support if you need more throughput.

Will I be charged for re-checking the same address?

Repeat requests for the same address within 60 seconds are served from cache and are not billed.

AML wallet screening inside Claude & ChatGPT

The Satoshkin MCP server plugs AML wallet screening into your AI agent: BitOK data, $0.55 per check, always.

BitOK data
$0.55 per check, always
5 networks
One balance: web + API + MCP

Set up in a minute

Add this block to your MCP client config (Claude Desktop, Cursor, etc.) and paste your API key:

{
  "mcpServers": {
    "satoshkin-aml": {
      "command": "npx",
      "args": ["-y", "satoshkin-aml-mcp"],
      "env": {
        "SATOSHKIN_API_KEY": "sk_live_..."
      }
    }
  }
}

For Claude Code — a single command:

claude mcp add satoshkin-aml -e SATOSHKIN_API_KEY=sk_live_... -- npx -y satoshkin-aml-mcp

What the server does

The server exposes a check_wallet_aml tool to your AI agent: the agent passes a wallet address and a network, and gets back a structured AML assessment powered by BitOK data.

5 networks: BTC, ETH, TRON, USDT-ERC20, USDT-TRC20.
risk_score — numeric risk score 0–100.
risk_level — risk level (low / medium / high).
tags — risk categories: sanctions, darknet, mixers, scam and more.

Your agent decides when to screen an address: before a transfer, during counterparty onboarding, or as part of a larger workflow.

Install

Claude Desktop

{
  "mcpServers": {
    "satoshkin-aml": {
      "command": "npx",
      "args": ["-y", "satoshkin-aml-mcp"],
      "env": {
        "SATOSHKIN_API_KEY": "sk_live_..."
      }
    }
  }
}

Add the block to claude_desktop_config.json (Settings → Developer → Edit Config).

Claude Code

claude mcp add satoshkin-aml -e SATOSHKIN_API_KEY=sk_live_... -- npx -y satoshkin-aml-mcp

One terminal command — the server shows up in your MCP list.

Cursor

{
  "mcpServers": {
    "satoshkin-aml": {
      "command": "npx",
      "args": ["-y", "satoshkin-aml-mcp"],
      "env": {
        "SATOSHKIN_API_KEY": "sk_live_..."
      }
    }
  }
}

Add the same block to ~/.cursor/mcp.json (or via Cursor settings → MCP).

How to get an API key

Keys (sk_live_...) are currently issued via support: message us on Telegram and say you need an AML API/MCP key — we will issue one and help with the first top-up.

A self-service dashboard with key management and usage history is under development.

Get a key on Telegram

Pricing

$0.55 per check — always. Only successful checks are billed.

One balance for web, API and MCP. $0.55 per check — always, no subscriptions, no tiers; top-ups credit exactly what you pay:

Top-up	Credited	Checks	Effective price
$10 (minimum)	$10	18	$0.55
$25	$25	45	$0.55
$100	$100	181	$0.55
$500	$500	909	$0.55

Need more than $500? Contact us for custom terms.

Try without installing

You can screen a wallet right in the browser — no key, no MCP client.

Check a wallet online

FAQ

Does the server work without an API key?: Yes, in mock mode: without a key, check_wallet_aml returns test data so you can verify the integration. Real AML checks require an sk_live_... key with balance.
How does billing work?: Each successful check deducts $0.55 from your key balance — always, from the very first check, no subscriptions, no tiers. The balance is shared across web, API and MCP. Top-ups start at $10 and credit exactly what you pay.
Is this financial or legal advice?: No. risk_score and tags are an informational assessment based on BitOK blockchain analytics. Transfer decisions and compliance conclusions remain yours.
What are the rate limits?: The rate limit is 1000 requests per hour per key. Contact support if you need more throughput.
Will I be charged for re-checking the same address?: Repeat requests for the same address within 60 seconds are served from cache and are not billed.