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_URLenv var - ENS: Resolves via Ethereum mainnet (configurable via
ETH_RPC_URL)
License
MIT