MCP Server
base-onchain-tools
dev.workers.dolerite.base-onchain-tools/base-onchain-tools
What this MCP does
Analyzes Base mainnet contracts, tokens, addresses and transactions, including contract capabilities, transfer simulation, balances, allowances, gas and token pricing.
Capabilities
Tools
12
tools
base_address_check
Pre-flight check on a Base mainnet address before you pay it: contract vs EOA, ETH and USDC balances, outbound tx count, and warnings about whether funds sent there can actually be moved. Costs $0.002 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Base mainnet address (0x-prefixed, 20 bytes)'}}}
base_allowance
ERC-20 allowance on Base: how much a spender may pull from an owner, whether it is an unlimited approval, the owner balance, and how much is actually spendable right now. Defaults to USDC. Costs $0.001 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['owner', 'spender'], 'properties': {'owner': {'type': 'string', 'description': 'Token holder address'}, 'token': {'type': 'string', 'description': 'Optional ERC-20 contract, defaults to USDC on Base'}, 'spender': {'type': 'string', 'description': 'Address allowed to spend'}}}
base_contract_audit
What an UNVERIFIED Base contract can actually do — the case where block explorers show you nothing. Disassembles the deployed bytecode with a PUSH-aware opcode walk (a naive byte scan reports SELFDESTRUCT on contracts that cannot self-destruct), strips the Solidity metadata trailer, recovers the function selectors from the dispatch table and names them against a keccak-derived signature database, then reports admin powers (mint, blacklist, freeze, pause, trading switches, adjustable fees, upgrade hooks), dangerous opcodes (DELEGATECALL, SELFDESTRUCT, CALLCODE, CREATE2), which token standards it really implements, and whether it supports EIP-3009 so it can be paid gaslessly over x402 at all. Proxies are detected and followed, because a forwarder's own bytecode tells you nothing. Costs $0.04 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Contract address on Base mainnet'}, 'follow_proxy': {'type': 'string', 'description': "Optional, default true. Set to false to audit the proxy's own bytecode instead of its implementation."}}}
base_contract_type
Identify what a Base contract actually is: ERC-20, ERC-721 or ERC-1155 via ERC-165, plus proxy detection across EIP-1967, EIP-1822 and the legacy ZeppelinOS slot with the current implementation address. Costs $0.002 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Contract address on Base mainnet'}}}
base_demo
Free. Returns a complete, live contract audit of Base USDC — the same output shape as the paid audit tool, with the address fixed. Call this first to see what the paid tools return before spending anything.
Input schema
{'type': 'object', 'required': [], 'properties': {}}
base_gas
Live Base mainnet gas oracle: current gas price, base fee, recent base fee trend, priority fee percentiles, and the estimated cost of a plain ERC-20 transfer in ETH. Costs $0.001 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': [], 'properties': {}}
base_portfolio
ETH and USDC balances for up to 20 Base addresses in a single call, with per-address funded flags and totals. One request instead of forty RPC round trips. Costs $0.003 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['addresses'], 'properties': {'addresses': {'type': 'string', 'description': 'Comma-separated Base addresses, max 20'}}}
base_price
ETH/USD and BTC/USD read live from Chainlink's on-chain price feeds on Base, with the feed's own description, decimals, update timestamp, age in seconds and a staleness flag. Costs $0.001 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': [], 'properties': {}}
base_simulate_transfer
Will this token payment actually go through, and if not exactly why. Simulates the transfer without spending gas, decodes the real revert reason (Error(string), Panic codes translated to English, or a custom error selector), and separately reports balance and allowance blockers. Understands that a caller with no ETH is fine for gasless EIP-3009 or a sponsored relayer. Costs $0.008 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string', 'description': 'Recipient address'}, 'from': {'type': 'string', 'description': 'Address the tokens leave'}, 'token': {'type': 'string', 'description': 'Optional ERC-20 contract, defaults to USDC on Base'}, 'amount': {'type': 'string', 'description': 'Amount in atomic units (for USDC, 1000000 = $1)'}, 'spender': {'type': 'string', 'description': 'Optional: simulate transferFrom pulled by this spender instead of a direct transfer'}}}
base_token
ERC-20 token metadata on Base mainnet: name, symbol, decimals and total supply, read straight from the contract. Costs $0.001 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'ERC-20 contract address on Base mainnet'}}}
base_token_price
USD price for ANY token on Base, not just the two assets Chainlink covers. Discovers every Uniswap V3 pool against WETH and USDC across all four fee tiers, reads sqrtPriceX96 and does the Q96 fixed-point maths, prices off the deepest pool, ignores deployed-but-never-traded pools, and cross-checks the remaining ones to flag thin or manipulated liquidity. Costs $0.006 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'ERC-20 token address on Base mainnet'}}}
base_tx_check
Confirm a Base mainnet transaction: success or reverted, block, confirmations and finality, gas used, and every ERC-20 transfer it moved with USDC amounts decoded. Costs $0.002 per call, paid in USDC over x402 on Base. Calling this tool returns the payment requirements; failed calls are never billed.
Input schema
{'type': 'object', 'required': ['hash'], 'properties': {'hash': {'type': 'string', 'description': 'Base mainnet transaction hash (0x-prefixed, 32 bytes)'}}}
History
Recent tool changes
Added
base_portfolio
Sept. 17, 2026, 12:39 p.m.
Added
base_contract_audit
Sept. 17, 2026, 12:39 p.m.
Added
base_simulate_transfer
Sept. 17, 2026, 12:39 p.m.
Added
base_token_price
Sept. 17, 2026, 12:39 p.m.
Added
base_allowance
Sept. 17, 2026, 12:39 p.m.
Added
base_contract_type
Sept. 17, 2026, 12:39 p.m.
Added
base_price
Sept. 17, 2026, 12:39 p.m.
Added
base_gas
Sept. 17, 2026, 12:39 p.m.
Added
base_token
Sept. 17, 2026, 12:39 p.m.
Added
base_tx_check
Sept. 17, 2026, 12:39 p.m.
Added
base_address_check
Sept. 17, 2026, 12:39 p.m.
Added
base_demo
Sept. 17, 2026, 12:39 p.m.
Discover
Similar MCP servers
Agent Einstein — Crypto & Market Intelligence
io.emc2ai/einstein
Provides crypto and market intelligence including price forecasts, sentiment, whale flows, token and wallet security, arbitrage, …
Swarm0x
sh.swarm0x/swarm0x
Analyzes tokens and wallets on Robinhood Chain, simulates trades, monitors activity, and prepares unsigned transactions.
tachyo
ai.tachyo/tachyo
Provides crypto market intelligence, token rug checks, and wallet verification.
Seneschal Data
io.github.Rotwang9000/seneschal-data
Provides Monero, Zcash, and Ethereum data services including payment monitoring, DeFi liquidation analysis, MEV intelligence, bui…
ScanHood
xyz.scanhood/mcp
Scans Robinhood Chain tokens for honeypot and rug risks, provides on-chain market data and quotes, and builds token, bridge, and …
tech-risk
io.github.rezearcher/tech-risk
Provides live crypto prices, funding rates, DeFi yields, prediction-market data, Base blockchain queries, token security analysis…
XRPLHub — XRPLScore & XRPL actions
io.github.Dcroyalty/xrplhub
Analyzes XRPL wallets, lending exposure, credentials, token risk, sanctions status, and creditworthiness, and builds ready-to-sig…
cerberus-index
com.cerberusindex/cerberus-index
Performs XRPL token, issuer, wallet, transaction, route, liquidity, price, and address risk analysis, including token monitoring …