Base Onchain Tools

dev.workers.dolerite.base-onchain-toolsPublished by base-onchain-tools.dolerite.workers.devOfficial publisherv1.0.0Updated Oct 24, 2026

Base mainnet analysis: contract audits, transfer simulation, token pricing. Paid via x402.

VerifiedStreamable HTTPWeb executableFinanceSecurity & Monitoring

Overview

AI-generated overview

A remote MCP server for Base mainnet analysis: contract audits, address and transaction checks, token pricing, gas and portfolio lookups, paid per call in USDC.

What you can do
Audit and identify contracts: disassemble unverified bytecode, detect ERC-20/721/1155 types and proxies, and run a free fixed-address demo audit of Base USDC. Check addresses and transactions: contract vs EOA, balances, outbound transaction count, and confirmation, finality and ERC-20 transfer details. Read token data: metadata, allowances, and USD prices for any Base token via Uniswap V3 pools or Chainlink feeds. Check gas and simulate transfers: live gas oracle, transfer cost estimate, and revert reasons without spending gas. Look up portfolios: ETH and USDC balances for up to 20 addresses in one call.
When to use it
Use it when you need to vet a Base address before sending funds, confirm a transaction, price a token, or inspect what an unverified contract can do. The free demo tool lets you see the output shape before paying for any call.
Requirements
A remote streamable HTTP endpoint; no local runtime, account or API key is declared. Paid tools require USDC payment on Base over x402, so a funded wallet able to complete x402 payments is needed. Network access to the endpoint and Base mainnet data is required.
Before you install
Most tools cost money per call in USDC over x402, from $0.001 to $0.003; calling a paid tool returns payment requirements and failed calls are stated not to be billed. Payments involve a wallet and real funds on Base. Results are read-only analysis, not financial advice, and depend on third-party on-chain data.

Installation

In SourceWeft

  1. Open Base Onchain Tools in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.workers.dolerite.base-onchain-tools%2Fbase-onchain-tools/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "base-onchain-tools": {
      "type": "http",
      "url": "https://base-onchain-tools.dolerite.workers.dev/mcp"
    }
  }
}

Tools

12

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.

Takes no parameters.

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.

Parametersaddressrequired

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.

Parametershashrequired

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.

Parametersaddressrequired

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.

Takes no parameters.

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.

Takes no parameters.

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.

Parametersaddressrequired

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.

Parametersownerrequiredtokenspenderrequired

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.

Parametersaddressrequired

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.

Parameterstorequiredfromrequiredtokenamountrequiredspender

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.

Parametersaddressrequiredfollow_proxy

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.

Parametersaddressesrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

72% 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 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.