verdict-mcp

MCP server for Algo Verdict API — the blockchain intelligence layer for AI agents, paid per call in USDC on Algorand via the x402 protocol.

Give your agent the ability to check whether a token is a rug, whether a wallet is trustworthy, what a transaction actually did, what is moving on-chain right now, and whether a transaction would fail before it signs it — and to pay for those answers itself. No API keys, no accounts, no subscriptions. Just a wallet.

Tools

| Tool | Cost | What it does | |---|---|---| | analyze_token | $0.05 | Liquidity + lock status, holder concentration, deployer history, rug_probability with the signals behind it, verdict | | analyze_wallet | $0.08 | Funding ancestry, behavioral labels, risk score with confidence, verdict | | analyze_wallet (depth: "deep") | $0.50 | Adds multi-hop funding ancestry and co-funded wallet clusters | | explain_transaction | $0.02 | What a committed Algorand transaction did: net flows, protocol, fees, realised vs pre-trade rate, safety flags | | simulate_transaction | $0.02 | Whether a transaction group would succeed, and the exact failure — before signing | | discover | $0.03 | New launches, trending, volume growth, liquidity moves, fresh LPs, protocol volume | | get_portfolio | $0.04 | Holdings, valuation, allocation, LP positions, 30-day trade flows | | smart_money | $0.10 | The wallets moving an asset, with the methodology stated alongside | | analyze_contract | $0.05 | Creator, privileged addresses, TEAL analysis, application TVL | | get_reputation | $0.02 | Standing score with every weighted component named | | ask | $0.12 | A plain-language question routed across every capability above | | watch_poll | $0.01 | Everything that changed across watched wallets/tokens since your cursor | | check_payment_wallet | free | Wallet address, balances, opt-in status, approximate calls remaining | | get_funding_instructions | free | How to get a wallet that can pay | | get_service_info | free | Endpoints, prices, supported chains |

Chains: tokens on Ethereum, Base, BSC, Solana and Algorand; wallets on Ethereum, Base and Algorand. The transaction, discovery, portfolio, smart-money, contract and reputation tools are Algorand-only. Payment always settles in USDC on Algorand.

Every field a data source cannot provide comes back null, never a guess — so your agent can tell "we looked and it is clean" apart from "we could not see".

Install

{
  "mcpServers": {
    "verdict": {
      "command": "npx",
      "args": ["-y", "verdict-mcp"],
      "env": { "ALGORAND_PRIVATE_KEY": "your 25 word mnemonic here" }
    }
  }
}

Add that to your MCP client's config (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json), then restart the client. Nothing to clone or build.

No wallet yet? Install it without the env block first — the free tools work immediately, and any paid tool will tell you exactly how to get funded. Or jump straight to the funding rail:

git clone https://github.com/AlgoIntel01/Algo-Verdict
cd Algo-Verdict && npm install
npm run fund-agent

That generates a wallet locally, waits for you to send native ALGO from any exchange, opts into USDC and swaps into USDC. Keys never leave your machine. Set the printed mnemonic as ALGORAND_PRIVATE_KEY and you're paying.

Configuration

| Variable | Default | Purpose | |---|---|---| | ALGORAND_PRIVATE_KEY | — | 25-word mnemonic or base64 secret key. Without it, paid tools explain how to fund a wallet. | | VERDICT_API_URL | the hosted API | Point at your own deployment | | VERDICT_NETWORK | mainnet | testnet for testing |

How payment works

Each paid tool call hits an endpoint that answers HTTP 402 Payment Required with payment terms. This server signs a USDC payment locally, retries, and returns the result — usually in under two seconds. Your key never leaves the process.

Payments are gasless: the GoPlausible facilitator covers Algorand transaction fees. Your wallet needs USDC to spend, plus a small one-time ALGO reserve for the USDC opt-in.

Security

• Your private key is read from the environment and used only to sign payment transactions locally. It is never transmitted.
• The server only ever pays the exact amount quoted in the 402 challenge, to the address in that challenge.
• Use a dedicated agent wallet funded with what you're willing to spend — not your main wallet.

License

MIT. The funding rail is free to use with any x402 service on Algorand, not just this one.