mcp · walletbureau — Claude Code MCP server: what it does, how to install
mcp scores Base wallet risk from 0 to 100 before your agent sends USDC, providing a verdict and clear explanation flags.
Apache-2.0 updated 2026-08-14
claude mcp add --env WALLETBUREAU_API_KEY=<WALLETBUREAU_API_KEY> --env X402_PRIVATE_KEY=<X402_PRIVATE_KEY> --env X402_MAX_PRICE_USD=<X402_MAX_PRICE_USD> --transport stdio walletbureau-mcp -- npx -y @walletbureau/mcpWhat mcp does
The server exposes the check_counterparty tool so autonomous agents can inspect a counterparty on Base before initiating a payment. It reviews the transaction track record of x402 and EIP-3009 USDC transfers, looking at address lifespan, sender diversity, inflow concentration, and volume spikes. The tool returns a risk score from 0 to 100, a recommendation (ok, caution, or avoid), and individual flag details explaining the rationale. A secondary tool, get_service_stats, reports public index counters at no charge.
This package functions as a direct client for walletbureau.com without keeping an offline database or custom heuristic engine locally. Unconfigured runs fall back to a public demo quota limited to a handful of checks per day per IP. Paid evaluations cost $0.01 each via a prepaid WALLETBUREAU_API_KEY or through on-chain settlement with X402_PRIVATE_KEY. Without credentials, the demo quota will deplete after a few queries.
What it helps with
- score counterparty risk on Base before sending a USDC transfer
- detect recent volume spikes and concentrated inflows on an address
- halt autonomous agent payments whenever receiving an
avoidverdict
Example prompts for the agent
- Check counterparty address
0x1234...abcdon Base before sending payment - Run
check_counterpartyon0x9876...fedcand report the risk flags - Fetch index statistics using
get_service_stats
How to install mcp
Platform CLI
claude mcp add --env WALLETBUREAU_API_KEY=<WALLETBUREAU_API_KEY> --env X402_PRIVATE_KEY=<X402_PRIVATE_KEY> --env X402_MAX_PRICE_USD=<X402_MAX_PRICE_USD> --transport stdio walletbureau-mcp -- npx -y @walletbureau/mcpReplace <…> with your own values
Platform CLI
codex mcp add walletbureau-mcp --env WALLETBUREAU_API_KEY=<WALLETBUREAU_API_KEY> --env X402_PRIVATE_KEY=<X402_PRIVATE_KEY> --env X402_MAX_PRICE_USD=<X402_MAX_PRICE_USD> -- npx -y @walletbureau/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"walletbureau-mcp": {
"command": "npx",
"args": [
"-y",
"@walletbureau/mcp"
],
"env": {
"WALLETBUREAU_API_KEY": "<WALLETBUREAU_API_KEY>",
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"X402_MAX_PRICE_USD": "<X402_MAX_PRICE_USD>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"walletbureau-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@walletbureau/mcp"
],
"env": {
"WALLETBUREAU_API_KEY": "<WALLETBUREAU_API_KEY>",
"X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
"X402_MAX_PRICE_USD": "<X402_MAX_PRICE_USD>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WALLETBUREAU_API_KEY=<WALLETBUREAU_API_KEY> -e X402_PRIVATE_KEY=<X402_PRIVATE_KEY> -e X402_MAX_PRICE_USD=<X402_MAX_PRICE_USD> walletbureau-mcp npx -y @walletbureau/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Run claude mcp add mcp -e WALLETBUREAU_API_KEY=<WALLETBUREAU_API_KEY> -e X402_PRIVATE_KEY=<X402_PRIVATE_KEY> -- npx -y @walletbureau/mcp. Replace the placeholders with your keys, or omit the -e arguments to run on the public free tier.
What does this MCP server do?
It provides risk scores from 0 to 100 and status verdicts for Base network addresses handling USDC. Agents use it to identify suspicious recipients before signing transactions.
How are checks billed?
The public demo tier allows several free queries each day per IP address. Detailed checks cost $0.01 each, billed against a prepaid key via WALLETBUREAU_API_KEY or signed in USDC over Base with X402_PRIVATE_KEY.
Similar MCP servers
All MCP servers for Finance and business →mcp by other authors comes first.