Boo X402 Mcp

io.github.lucle87Published by GitHub account lucle87v1.0.1Updated Oct 27, 2026

Pay-per-call crypto data for AI agents. USDC on Base via x402. No API key.

VerifiedSTDIODesktop onlyFinanceSecurity & Monitoring

Overview

AI-generated overview

Pay-per-call crypto and web3 data server: an assistant can query token, wallet, DeFi and prediction-market data across five chains, paying in USDC on Base.

What you can do
  • List paid tools and check session spend with the two free tools
  • Screen tokens, holders, contracts, wallets and Solana bundles for safety and sanctions risk
  • Look up token prices, supply, snapshots, meme-token discovery and momentum
  • Read market and DeFi data: fear and greed, gas, ENS, TVL, yields, stablecoin pegs, funding and trade signals
  • Search and read prediction markets and their history
  • Query Robinhood Chain health, wallets, tokens, transactions, trending and burns
When to use it
Useful when an assistant needs on-chain crypto ground truth across Ethereum, BNB Chain, Base, Solana or Robinhood Chain and you would rather pay a few cents per call than manage API keys or subscriptions. Also suited to token and wallet risk screening before acting on a token.
Requirements
Runs locally over stdio via npx (Node.js). A wallet holding USDC on Base is required for paid tools, supplied as WALLET_PRIVATE_KEY; no ETH is needed for gas. Optional caps MAX_USD_PER_CALL (default 0.05) and MAX_USD_TOTAL (default 5). The free tools work without a wallet. Desktop MCP client only.
Before you install
Requires a wallet private key (WALLET_PRIVATE_KEY) in the MCP config; anyone with access to that config can spend from the wallet, so use a dedicated low-balance wallet. Every paid call costs real USDC, and spend caps are per session and reset on restart. Queries go to third-party data providers. Output is read-only data and explicitly not investment advice.

Installation

In SourceWeft

  1. Open Boo X402 Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

boo-x402-mcp

One MCP server giving AI agents pay-per-call access to crypto/web3 ground-truth data across 5 chains: Ethereum, BNB Chain, Base, Solana, and Robinhood Chain (chain_id 4663).

Paid in USDC on Base via x402. No API key. No signup. No subscription. Built-in spend caps.

Why

Agents cannot sign up for API keys. x402 lets your agent pay per call with a signature. This server wraps a fleet of data APIs behind one install, routes each question to the right backend, and enforces a spending limit before the wallet ever signs.

Tools (34 paid + 2 free)

Call x402_list_paid_tools (FREE) first to see everything with live prices.

Safety (use before you buy)

ToolPriceChains
token_rugcheck$0.01eth, bnb, base, solana, rhchain
token_holders$0.01eth, bnb, base, solana, rhchain
contract_safety$0.01eth, bnb, base
wallet_risk$0.01eth, bnb, base, solana
wallet_sanctions$0.01OFAC screen
wallet_signal$0.02composite verdict
solana_bundle_check$0.015solana (sniper/bundle detection)

Meme tokens

ToolPrice
meme_discover$0.01
token_momentum$0.01
meme_signal$0.02 (composite)

Token data

ToolPrice
token_price$0.01
token_supply$0.01
token_snapshot$0.015 (price + supply + safety)

Market & DeFi

ToolPrice
fear_greed$0.005
gas_oracle$0.005
ens_resolve$0.005
defi_tvl$0.01
defi_yields$0.01
chain_tvl$0.01
stablecoin_peg$0.01
derivatives_funding$0.01
trade_signal$0.02

Prediction markets

ToolPrice
prediction_markets$0.008
prediction_search$0.005
prediction_market$0.008
prediction_history$0.008

Robinhood Chain (new L2, not covered by other providers)

ToolPrice
rhchain_health$0.005
rhchain_wallet$0.01
rhchain_wallet_score$0.01
rhchain_token_screener$0.008
rhchain_token_detail$0.008
rhchain_tx$0.005
rhchain_trending$0.008
rhchain_burn$0.005

Free: x402_list_paid_tools, x402_spend_status

Install

json
{  "mcpServers": {    "boo-x402": {      "command": "npx",      "args": ["-y", "boo-x402-mcp"],      "env": {        "WALLET_PRIVATE_KEY": "0x...",        "MAX_USD_PER_CALL": "0.05",        "MAX_USD_TOTAL": "5"      }    }  }}

Works with Claude Desktop, Claude Code (claude mcp add), Cursor, and any MCP client.

Wallet

You need a wallet holding USDC on Base. No ETH needed for gas: x402 uses EIP-3009, so your wallet only signs, and the facilitator pays gas.

Your private key stays on your machine, in your MCP config. It is never transmitted. Payments are signed locally, per call.

The free tools work with no wallet at all.

Spend caps

x402 wallets are unlimited by default. This server is not:

  • MAX_USD_PER_CALL (default 0.05) - rejects any single payment above this, before signing
  • MAX_USD_TOTAL (default 5) - rejects further calls once session spend reaches this

Restart the server to reset the session total.

Data

Public, verifiable sources (Blockscout, RPC, DEX pairs, DefiLlama, GoPlus). Read-only.

NOT investment advice.

License

MIT

Source: README.md at commit 79a44dc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.