The MCP Ethers Wallet server provides a standardized interface for interacting with Ethereum wallets, networks, and smart contracts using Ethers.js v6.
Query Blockchain Data: Get network information, block details, gas prices, and fee data
Wallet Operations: Manage wallets, check balances (ETH and ERC20), retrieve transaction counts
Transaction Management: Send transactions, get transaction details, and manage transactions within blocks
Smart Contract Interaction: Call contract methods (read/write), get bytecode, query events and logs
ENS Operations: Resolve ENS names and addresses
Unit Conversion: Convert between wei and ether, format/parse units
Advanced Features: Sign messages, send pre-signed raw transactions, customize gas settings
Cross-Network Support: Works with multiple Ethereum-compatible networks
Provides API key-based access to Ethereum networks, serving as a node provider for blockchain interactions.
Enables comprehensive interaction with Ethereum networks, including querying blockchain data, managing wallets, sending transactions, and interacting with smart contracts.
Utilizes Ethers.js v6 as the core library for blockchain interactions, providing standardized interfaces for wallet management, smart contract interaction, and transaction handling.
Supports interaction with the Optimism network, allowing for blockchain queries, wallet operations, and transaction management on this Ethereum L2 solution.
Enables interaction with Polygon PoS network, providing tools for blockchain queries, wallet operations, and transaction management on this Ethereum scaling solution.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Ethers Walletget Vitalik's ETH balance on mainnet"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Ethers Server
⚡ Claude Code Setup:
claude mcp add ethers-wallet -- node /path/to/ethers-server/build/src/index.jsA complete ethers.js v6 wrapper for Claude with 40+ tools for Ethereum blockchain interactions. Works with 20+ EVM networks including Ethereum, Polygon, Arbitrum, Base, and more.
Tool Categories
🔗 Core Ethereum
Network info • Block/transaction data • Wallet operations • Gas estimation • ENS resolution • Message signing • Unit conversion
🪙 Token Standards
ERC20: Token info, balances, transfers, approvals
ERC721: NFT info, ownership, transfers, metadata
ERC1155: Multi-token balances, transfers, batch operations
📝 Transaction Management
Transaction preparation • ERC20/721/1155 transaction prep • Secure transaction broadcasting • Gas optimization
🔧 Contract Interaction
Smart contract calls • Contract code inspection • Custom ABI support
Related MCP server: EVM MCP Server
Quick Example
# Get Vitalik's ETH balance
"getWalletBalance": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"provider": "mainnet"
}
# Get USDC token info
"erc20GetTokenInfo": {
"tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"provider": "mainnet"
}Installation
git clone https://github.com/yourusername/ethers-server.git
cd ethers-server
npm install
npm run buildEnvironment Variables
Create .env file:
ALCHEMY_API_KEY=your_alchemy_key
INFURA_API_KEY=your_infura_key
DEFAULT_NETWORK=mainnetAdvanced Setup
Local Project
claude mcp add --scope local ethers-wallet --env ALCHEMY_API_KEY=your_key -- node /path/to/build/src/index.jsShared Team Config
claude mcp add --scope project ethers-wallet -- node /path/to/build/src/index.jsSecurity
🔐 Secure by Design: Uses prepare → sign → send workflow. Private keys never stored on server. External signing supported (hardware wallets, offline signing).
⚠️ API Keys: Protect your .env file. Never expose Alchemy/Infura keys.
Development
Built with ethers.js v6 for maximum compatibility and performance. Full TypeScript support with comprehensive error handling.
Testing: npm test (requires Hardhat local node)
Build: npm run build
Contributing
Contributions welcome! See our comprehensive test suite and follow existing code patterns.
License
MIT License - Dennison Bertram (dennison@tally.xyz)
🚀 Production Ready: Successfully validated with live Ethereum mainnet transactions. Complete MCP server with 40+ tools for all your Web3 needs.
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.