base-wallet-toolkit-mcp

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