Ethers Wallet MCP server

The MCP Ethers Wallet provides Ethereum wallet functionality to LLM applications through the Model Context Protocol. It offers tools for wallet management, transactions, contract interactions, ENS resolution, and more - all compatible with any MCP client like Claude Desktop.

Installation

# Clone the repository
git clone https://github.com/yourusername/ethers-server.git
cd ethers-server

# Install dependencies
npm install

# Build the TypeScript code
npm run build

Configuration

Environment Variables

Create a .env file in the root directory:

# Required
ALCHEMY_API_KEY=your_alchemy_api_key
INFURA_API_KEY=your_infura_api_key

# Optional
DEFAULT_NETWORK=mainnet  # Default: mainnet
LOG_LEVEL=info           # Default: info (options: error, warn, info, debug)

MCP Client Configuration

To use this with MCP clients like Claude Desktop, configure with:

{
  "ethers": {
    "command": "node",
    "args": [
      "pathTo/ethers-server/build/src/mcpServer.js"
    ],
    "env": {
      "ALCHEMY_API_KEY": "key goes here",
      "INFURA_API_KEY": "key goes here"
    }
  }
}

Replace pathTo/ethers-server with your actual installation path.

Getting Started

Starting the Server

# Using Node.js
npm start

# Using Bun (recommended for faster performance)
bun start

Using with Claude Desktop

1. Configure Claude Desktop to use this server:

   • Go to Settings > Model Context Protocol
   • Set Command to: node path/to/ethers-server/build/src/mcpServer.js

2. Use the Ethers tools in your Claude conversations.

Testing with MCP Inspector

# Install MCP Inspector globally
npm install -g @modelcontextprotocol/inspector

# Run it with your server
mcp-inspector --command "node build/src/mcpServer.js"

Supported Networks

The server supports multiple Ethereum and EVM-compatible networks:

Mainnet Networks

• Ethereum (ETH)
• Polygon PoS (POL)
• Arbitrum (ETH)
• Optimism (ETH)
• Avalanche C-Chain (AVAX)
• Base (ETH)
• BNB Smart Chain (BNB)
• And many more

Testnet Networks

• Monad Testnet (MON)
• MEGA Testnet (ETH)

You can specify networks when using tools: "provider": "polygon" or use custom RPC URLs: "provider": "https://my-custom-rpc.example.com".

Available Tools

Core Network Tools

• getSupportedNetworks: Get all supported networks and configurations
• getBlockNumber: Get current block number
• getBlockDetails: Get block details
• getTransactionDetails: Get transaction details
• getGasPrice: Get current gas price
• getFeeData: Get network fee data

Wallet Tools

• generateWallet: Create a new wallet
• loadWallet: Load wallet from private key
• checkWalletExists: Check if wallet is configured
• getWalletBalance: Check ETH balance
• signMessage: Sign messages

Contract Tools

• callContractMethod: Call read-only contract methods
• estimateGas: Estimate transaction gas

Token Standards

• ERC20: Token balance, transfers, allowances
• ERC721: NFT ownership, transfers, metadata
• ERC1155: Multi-token balance, transfers

Other Tools

• ENS resolution: Name/address lookups
• Unit conversion: Convert between wei/ether/units

Usage Examples

Getting Network Information

{
  "name": "getSupportedNetworks",
  "arguments": {}
}

Getting Wallet Balance

{
  "name": "getWalletBalance",
  "arguments": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "provider": "mainnet"
  }
}

Getting ERC20 Token Information

{
  "name": "erc20GetTokenInfo",
  "arguments": {
    "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "provider": "mainnet"
  }
}

Calling a Contract Method

{
  "name": "callContractMethod",
  "arguments": {
    "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "methodName": "symbol",
    "params": [],
    "abi": ["function symbol() view returns (string)"],
    "provider": "mainnet"
  }
}

ERC20 Token Transfer

{
  "name": "erc20Transfer",
  "arguments": {
    "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "to": "0xRecipientAddress",
    "amount": "100.0",
    "provider": "mainnet"
  }
}

Security Considerations

• Private Keys: The server can store private keys in memory. Use caution with the saveToEnv option.
• API Keys: Protect your Alchemy and Infura API keys by securing your .env file.
• Eth Sign: The ethSign method can sign transaction-like data, which is less secure than signMessage.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "ethers" '{"command":"node","args":["pathTo/ethers-server/build/src/mcpServer.js"],"env":{"ALCHEMY_API_KEY":"key goes here","INFURA_API_KEY":"key goes here"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "ethers": {
            "command": "node",
            "args": [
                "pathTo/ethers-server/build/src/mcpServer.js"
            ],
            "env": {
                "ALCHEMY_API_KEY": "key goes here",
                "INFURA_API_KEY": "key goes here"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "ethers": {
            "command": "node",
            "args": [
                "pathTo/ethers-server/build/src/mcpServer.js"
            ],
            "env": {
                "ALCHEMY_API_KEY": "key goes here",
                "INFURA_API_KEY": "key goes here"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect