# 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

```bash
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.):

```json
{
  "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