Server data from the Official MCP Registry
AML/KYT crypto wallet risk screening (BitOK data) for Claude, ChatGPT and any MCP client.
AML/KYT crypto wallet risk screening (BitOK data) for Claude, ChatGPT and any MCP client.
Well-engineered MCP server with strong security practices. Authentication is properly implemented via API keys with appropriate token handling, input validation is thorough, and error handling prevents credential leakage. Permissions are appropriate for the server's purpose (crypto wallet screening via external API). Minor code quality observations do not materially impact security. Supply chain analysis found 1 known vulnerability in dependencies (1 critical, 0 high severity). Package verification found 1 issue.
7 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: SATOSHKIN_API_KEY
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-satoshkin-dev-satoshkin-aml-mcp": {
"env": {
"SATOSHKIN_API_KEY": "your-satoshkin-api-key-here"
},
"args": [
"-y",
"satoshkin-aml-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
v0.2.0 performs real AML/KYT screening through the Satoshkin backend
(POST /api-accounts/aml-check, BitOK data) when SATOSHKIN_API_KEY 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.
check_wallet_amlChecks 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:
BTCETHTRONUSDT-ERC20USDT-TRC20Real output (with SATOSHKIN_API_KEY):
{
"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, insufficient_balance, rate_limited, validation_error,
bitok_upstream_error, bitok_timeout, upstream_unreachable,
invalid_response, internal_error, and http_<status> (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.
| Env var | Default | Purpose |
|---|---|---|
SATOSHKIN_API_KEY | (unset = mock mode) | API key sk_live_* / sk_test_* issued by Satoshkin |
SATOSHKIN_API_BASE_URL | https://satoshkin.com | Backend base URL (staging override) |
SATOSHKIN_TIMEOUT_MS | 30000 | Request timeout; first-time checks may take several seconds |
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:
{
"mcpServers": {
"satoshkin-aml": {
"command": "node",
"args": ["/absolute/path/to/satoshkin-aml-mcp/dist/index.js"]
}
}
}
git clone https://github.com/satoshkin-dev/satoshkin-aml-mcp.git
cd satoshkin-aml-mcp
npm install
npm run build
npm test
Run the server locally:
npm run dev
Run the built server:
npm run build
node dist/index.js
Shipped in v0.2:
0-100 + risk level (low / medium / high)Planned next: counterparty and cluster analysis, allow/review/block decisions.
The MCP server is a free open-source connector.
Real checks require a Satoshkin API key. Billing is per successful check ($0.55, debited from a prepaid key balance), the first real check per key is free, and cached repeat checks within 60 seconds are not charged. Keys are currently issued by Satoshkin support; a self-service dashboard is in development. Mock mode is free and unlimited.
Traditional AML APIs (Chainalysis, Elliptic, TRM Labs) require:
This MCP server lets any AI assistant call AML checks natively, with structured input/output that the LLM understands. Install once, use across all your AI tools.
MIT
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.