mcp-server

BlockchainAnalysis is an MCP server that gives AI agents the ability to run compliance checks on cryptocurrency wallets and tokens. MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools during a conversation; once connected, an AI agent can ask this server whether a wallet is flagged, whether a token is a honeypot, or what risk level a particular address carries, and receive structured answers it can use in its replies.

The server is hosted remotely and reached over an HTTP endpoint. Connecting it to an AI assistant takes a single configuration line in Cursor, Claude Code, or the Claude desktop app. No local installation is needed.

The tools split into two tiers. The free tools read publicly available on-chain data: whether a wallet is blacklisted by Tether or Circle (the companies behind USDT and USDC stablecoins), the history of freeze and unfreeze events for a wallet, a buy-and-sell simulation that flags honeypot tokens or unusually high transaction taxes, and a list of active spending permissions a wallet has granted to other contracts.

The paid tools do more involved analysis. A wallet screening call costs $1.50 and searches a database of over one billion labelled addresses for matches against sanctions lists from OFAC, the EU, the UN, the UK, and Switzerland, as well as known scam accounts, mixers, and exchanges. A KYT (Know Your Transaction) check costs $2.00 and returns a risk verdict combining sanctions status, entity classification, and a financial institution score. A consumer-protection check costs $1.00 and returns a safety rating and a score from 0 to 100.

Payment for the paid calls is settled per call in USDC on the Base blockchain through a protocol called x402. No account signup and no API key are needed: the agent's own wallet sends the payment automatically when a paid tool is called. The repository includes a tutorial for building a compliance agent in five minutes.