npm base-wallet-toolkit-mcpstdioupdated 6mo ago
An MCP server for AI agents to interact with Base chain wallets. Check balances, estimate gas, inspect tokens, verify allowances, and more.
What can you do with base wallet toolkit?
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
Install
Add base wallet toolkit to your client. Pick the one you use.
claude mcp add base-wallet-toolkit-mcp -- npx -y base-wallet-toolkit-mcpcodex mcp add base-wallet-toolkit-mcp -- npx -y base-wallet-toolkit-mcpamp mcp add base-wallet-toolkit-mcp -- npx -y base-wallet-toolkit-mcp{
"mcpServers": {
"base-wallet-toolkit-mcp": {
"command": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"base-wallet-toolkit-mcp": {
"command": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"base-wallet-toolkit-mcp","command":"npx","args":["-y","base-wallet-toolkit-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"base-wallet-toolkit-mcp": {
"command": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"base-wallet-toolkit-mcp": {
"command": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"base-wallet-toolkit-mcp": {
"command": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"base-wallet-toolkit-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"base-wallet-toolkit-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"base-wallet-toolkit-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y base-wallet-toolkit-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
7 tools
base wallet toolkit exposes 7 tools to a connected agent.
- 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
Score
59 / 100
Adequate
- Documentation22/25
- Maintenance13/25
- Trust6/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 178 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 7 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.2Latest | Mar 7, 2026 |
| 1.0.1 | Mar 7, 2026 |