Satoshkin Aml MCP

Name: Satoshkin Aml MCP
Author: satoshkin-dev

作者：satoshkin-devバージョン 0.2.0i★ –iパソコンで動く

レジストリ名io.github.satoshkin-dev/satoshkin-aml-mcp

インストール

概要

作者による説明（英語の原文）

AML/KYT crypto wallet risk screening (BitOK data) for Claude, ChatGPT and any MCP client.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 暗号資産・ブロックチェーン
入力が必要なもの：SATOSHKIN_API_KEY

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： SATOSHKIN_API_KEY

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

claude mcp add satoshkin-aml --env SATOSHKIN_API_KEY=your-value -- npx -y satoshkin-aml-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "satoshkin-aml": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "satoshkin-aml-mcp"
      ],
      "env": {
        "SATOSHKIN_API_KEY": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

SATOSHKIN_API_KEY 秘密 env
API key (sk_live_…/sk_test_…) for real AML checks; omit for mock mode.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント satoshkin-dev で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

暗号資産・ブロックチェーンのほかのサーバーとの比較i

このカテゴリのほかの1614件のうち0%よりスターが多い
このカテゴリのほかの1614件のうち22%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの1614件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Satoshkin Aml MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：SATOSHKIN_API_KEY

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.2.0）がレジストリに届いたのは5 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Highwire, DeFi Quant Yield & Risk Engine, gasrescue

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Highwire

作者：HigherMaestro

Trade, launch and research higher.fun coins on Solana, from any AI agent. Unsigned or policy-signed.

パソコンでもクラウドでも今日更新

インストール

DeFi Quant Yield & Risk Engine

作者：Pyrochem

Quantitative DeFi carry ROE, borrow kink slippage & risk simulation across 6 protocols.

パソコンで動く今日更新

インストール

gasrescue

作者：gasrescue

Rescue USDC, USDT and USDG from wallets with no gas: send or swap them on EVM, Solana and Tron.

パソコンで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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 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.

Available Tool

`check_wallet_aml`

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 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_ (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

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

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:

"mcpServers": { "satoshkin-aml": { "command": "node", "args": ["/absolute/path/to/satoshkin-aml-mcp/dist/index.js"] } } }

Local Development

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

Check Scope

Shipped in v0.2:

Risk score 0-100 + risk level (low / medium / high)
Source-of-funds tags
First and last activity dates
Total volume in and out (USD)
Per-key rate limiting and billing through Satoshkin backend authentication

Planned next: counterparty and cluster analysis, allow/review/block decisions.

Monetization Model

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.

Related Satoshkin Products

P2P bot: https://satoshkin.com
AML/KYT Telegram bot: https://t.me/SatoshkinKYTbot
AML/KYT web app: planned

Use Cases

OTC desks: Screen counterparty wallets before settling P2P trades
Compliance officers: Quick wallet risk checks during AI-assisted workflows
Crypto fund managers: Vet wallet addresses for sanctions/mixer exposure via AI agent
Web3 builders: Add AML screening to Claude/ChatGPT-powered dApps
Crypto journalists: Investigate wallet history with AI assistance

Why MCP Instead of REST API?

Traditional AML APIs (Chainalysis, Elliptic, TRM Labs) require:

Custom integrations per AI client
Backend infrastructure to broker calls
Manual prompt engineering for context

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.

Roadmap

v0.1: Scaffold with mock checks
v0.2: Real BitOK integration via Satoshkin backend (per-check billing, free first check, mock mode without key)
v0.3: Self-service key dashboard + top-up
v0.4: Additional chains (Solana, BNB, Polygon)
v0.5: Richer tag taxonomy and sanctions-specific flags
v0.6: Cluster analysis and entity attribution

License

MIT

Satoshkin Aml MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

暗号資産・ブロックチェーンのほかのサーバーとの比較i

よくある質問

代わりの候補

Highwire

DeFi Quant Yield & Risk Engine

gasrescue

作者のREADME

Satoshkin AML/KYT MCP Server

Status

Available Tool

check_wallet_aml

Configuration

Claude Desktop / Claude Code

Local Development

Check Scope

Monetization Model

Related Satoshkin Products

Use Cases

Why MCP Instead of REST API?

Roadmap

License

`check_wallet_aml`