Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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/mcp
Open on GitHub

What 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 avoid verdict

Example prompts for the agent

  • Check counterparty address 0x1234...abcd on Base before sending payment
  • Run check_counterparty on 0x9876...fedc and 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/mcp

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

mcp kubeshark mcp is a Claude Code MCP server that exposes Kubernetes network traffic to an AI agent. It can help trace API calls and investigate failures. CX Codex +1 ★ 12,142repo stars mcp butterbase-ai The Butterbase MCP server gives your agent access to schemas, auth, functions, storage, RAG and deploys. Useful when your backend runs on Butterbase. CX Codex +1 ★ 3,033repo stars mcp medplum Connect an AI agent to healthcare data stored in Medplum and work with those records through MCP. Useful when you want an agent to access FHIR data. CX Codex +1 ★ 2,812repo stars mcp sceneview MCP server for Claude Code with SceneView SDK documentation, samples, and code generation. Generates working Compose, SwiftUI, or JavaScript code from scene descriptions. CX Codex +1 ★ 1,379repo stars mcp Buoy-gg mcp is a Claude Code MCP server that connects an agent to Buoy tools in a running React Native or Flutter app. The agent can inspect app data and change its state. CX Codex +1 ★ 696repo stars FiatDock fiatdock FiatDock is an MCP server for Claude Code and other agents that provides a microservice marketplace with per-call USDC payments via x402 and bank off-ramping. CX Codex +1 ★ 1repo stars xenarch-mcp xenarch xenarch-mcp enables AI agents to handle HTTP 402 micropayments with USDC on Base L2. Lets tools pay sellers directly without custodial middlemen. CX Codex +1 974installs TWZRD Agent Intelligence twzrd-sol TWZRD Agent Intelligence evaluates x402 sellers and store listings before agents send payments. Works as a pre-spend inspection gate on Solana and Base. CX Codex +1 Token risk x402 OgenaLabs Token risk x402 inspects token safety across Solana and Base before trades occur. It functions without an API key via the x402 protocol and includes a free tier. CX Codex +1 Coal - Payments for AI agents coal Coal - Payments for AI agents gives agents tools to browse decentralized product listings, send USDC on Base, and fetch purchased files autonomously. CX Codex +1 1,558installs Liquid Agent LiquidAgent Liquid Agent equips AI agents with financial capabilities over x402, including multi-chain USDC bridging, Polymarket pricing, tokenized equity vaults, and B2B lead searches. CX Codex +1

Project sponsors

Companies that keep this analytics open