English Français العربية

io.github.saloprj/publicaml

Official registry Finance and payments

Free crypto AML/KYT screening for BTC/ETH/BSC/TRON — risk score, sanctions, source of funds.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http publicaml 'https://mcp.publicaml.org/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "publicaml": {
            "type": "http",
            "url": "https://mcp.publicaml.org/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PublicAML — code examples
  2. The request
  3. Examples
  4. AI agents & frameworks
  5. Pre-transaction gate
  6. Notes
  7. License

PublicAML — code examples

Copy-paste examples for screening a crypto wallet address or transaction for AML / KYT risk — sanctions, mixers, scam and hack exposure — using PublicAML.

Free. No API key. No signup. PublicAML is a non-profit; the public enrich endpoint takes requests with no authentication. An optional key only raises the rate limit.

The request

POST https://intelapi.publicaml.org/v1/enrich
Content-Type: application/json

{ "addresses": [{ "wallet_address": "0x...", "chain": "ETH" }],
  "include": ["aml_score", "category"] }

Response (abridged):

{ "entities": [{ "wallet_address": "0x...", "chain": "ETH",
  "aml_score": 87, "category": "hack", "sanctioned": false }] }
  • aml_score — 0–100 (higher = riskier)
  • category — entity type (exchange, mixer, hack, scam, sanction…)
  • sanctioned — treat true as an override regardless of score

Chains: BTC, ETH, BNB Chain (BSC), TRON. An ERC20 and a BEP20 address look identical — send the correct chain for the network you are on.

Examples

LanguageFile
cURLcurl/enrich.sh
Pythonpython/aml_check.py
JavaScriptjavascript/amlCheck.mjs
TypeScripttypescript/amlCheck.ts
Gogo/aml_check.go

AI agents & frameworks

Drop-in tools so an AI agent can screen an address itself — LangChain, CrewAI, and a zero-code MCP server for Claude Desktop / Cursor: frameworks/.

Pre-transaction gate

The point of a pre-send check is to decline rather than unwind. Screen the recipient before you sign or accept funds and reject anything sanctioned or above your risk threshold (75 is a common cut-off). See the language examples — each returns the entity so you can gate on sanctioned / aml_score.

Notes

  • It is a risk signal, not a legal compliance guarantee — keep your own KYC/AML process alongside it.
  • Do not invent API keys; none are required for the public enrich path.
  • sanctioned: true should override softer category labels.

License

MIT — use these snippets freely.

Frequently asked questions

What is io.github.saloprj/publicaml?

Free crypto AML/KYT screening for BTC/ETH/BSC/TRON — risk score, sanctions, source of funds.

How do I install io.github.saloprj/publicaml?

It runs as a remote server. In Claude Code: claude mcp add --transport http publicaml 'https://mcp.publicaml.org/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.saloprj/publicaml need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.saloprj/publicaml open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.saloprj/publicaml?

It is published by saloprj. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.