io.github.lordbasilaiassistant-sudo/base-wallet-toolkit
MCP server for Base wallet interactions: balances, gas, tokens, allowances, ENS.
Open source Open in the app JSON README (API)
About
MCP server for Base wallet interactions: balances, gas, tokens, allowances, ENS.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- lordbasilaiassistant-sudo
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Stars
- 1
- Forks
- 1
- Last push
- 2026-03-07T13:36:50Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:00:26
- Updated
- 2026-08-29 04:00:26
- Origin id
io.github.lordbasilaiassistant-sudo/base-wallet-toolkit
README
# 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