Base Wallet Toolkit

An MCP server for AI agents to interact with Base chain wallets. Check balances, estimate gas, inspect tokens, verify allowances, and more.

Install

npx -y base-wallet-toolkit-mcp

Tools

Tool	Description
check_balances	Get ETH + ERC-20 token balances for any wallet
get_gas_estimate	Estimate gas cost for a transaction on Base
get_token_info	Get ERC-20 token details (name, symbol, supply, decimals)
check_allowance	Check token approval/allowance status
get_base_gas_price	Get current Base gas price and typical tx costs
resolve_address	Resolve ENS name to address (or reverse lookup)
get_tx_status	Check transaction status and details by hash

Setup

Add to your MCP client config (Claude Code, Cursor, etc.):

{
  "mcpServers": {
    "base-wallet-toolkit": {
      "command": "npx",
      "args": ["-y", "base-wallet-toolkit-mcp"]
    }
  }
}

No API keys required. All tools are read-only and use public Base RPC.

Use Cases

• Portfolio tracking: Check ETH and token balances across wallets
• Pre-trade checks: Verify allowances before swaps, estimate gas costs
• Token research: Look up any ERC-20 token details on Base
• Transaction monitoring: Check if a tx confirmed, reverted, or is pending
• ENS resolution: Convert between ENS names and addresses
• Gas optimization: Monitor Base gas prices to time transactions

Chain

• Network: Base mainnet (chainId 8453)
• RPC: Uses public Base RPC by default, configurable via RPC_URL env var
• ENS: Resolves via Ethereum mainnet (configurable via ETH_RPC_URL)

License

MIT