Ethers Wallet

by crazyrabbitltc

5 stars

225 downloads

Not rated

GitHub

About

Integrates with Ethereum networks and smart contracts using ethers.js to enable wallet operations, transaction management, and blockchain interactions.

Details

Author: crazyrabbitltc
Repository: crazyrabbitLTC/mcp-ethers-server
GitHub stars: 5
Downloads: 225
License: MIT License
Categories: Design, Developer Tools, AI, Infrastructure, API, Frontend, Other

- 40+ tools for Ethereum blockchain interactions
- Wraps ethers.js v6 for maximum compatibility
- Supports 20+ EVM networks (Ethereum, Polygon, Arbitrum, Base, etc.)
- Secure prepare‑sign‑broadcast workflow; private keys never stored
- Token support for ERC20, ERC721, and ERC1155
- Smart contract calls with custom ABI support

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Ethers Wallet

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/build/src/index.js
Environment
- INFURA_API_KEY your_infura_key
- ALCHEMY_API_KEY your_alchemy_key
- DEFAULT_NETWORK mainnet
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/c",
                "node",
                "/path/to/build/src/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/c",
                "node",
                "/path/to/build/src/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/c",
                "node",
                "/path/to/build/src/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/c",
                "node",
                "/path/to/build/src/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/c",
                "node",
                "/path/to/build/src/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

git clone https://github.com/yourusername/ethers-server.git
cd ethers-server
npm install
npm run build


Create .env file:

ALCHEMY_API_KEY=your_alchemy_key INFURA_API_KEY=your_infura_key DEFAULT_NETWORK=mainnet

bash claude mcp add --scope project ethers-wallet -- node /path/to/build/src/index.js ```

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ethers wallet": {
            "env": {
                "INFURA_API_KEY": "your_infura_key",
                "ALCHEMY_API_KEY": "your_alchemy_key",
                "DEFAULT_NETWORK": "mainnet"
            },
            "args": [
                "/path/to/build/src/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "INFURA_API_KEY": "your_infura_key",
        "ALCHEMY_API_KEY": "your_alchemy_key",
        "DEFAULT_NETWORK": "mainnet"
    },
    "args": [
        "/path/to/build/src/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "INFURA_API_KEY": "your_infura_key",
        "ALCHEMY_API_KEY": "your_alchemy_key",
        "DEFAULT_NETWORK": "mainnet"
    },
    "args": [
        "/path/to/build/src/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "INFURA_API_KEY": "your_infura_key",
        "ALCHEMY_API_KEY": "your_alchemy_key",
        "DEFAULT_NETWORK": "mainnet"
    },
    "args": [
        "/c",
        "node",
        "/path/to/build/src/index.js"
    ],
    "command": "cmd"
}

MCP Ethers Server

⚡ Claude Code Setup:

claude mcp add ethers-wallet -- node /path/to/ethers-server/build/src/index.js

A 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

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 build

Environment Variables

Create .env file:

ALCHEMY_API_KEY=your_alchemy_key

INFURA_API_KEY=your_infura_key

DEFAULT_NETWORK=mainnet

Advanced Setup

Local Project

claude mcp add --scope local ethers-wallet --env ALCHEMY_API_KEY=your_key -- node /path/to/build/src/index.js

Shared Team Config

claude mcp add --scope project ethers-wallet -- node /path/to/build/src/index.js

Security

🔐 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.29:["$","div",null,{"className":"my-8 pb-8 h-full

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

MCP Ethers Server

Tool Categories

🔗 Core Ethereum

🪙 Token Standards

📝 Transaction Management

🔧 Contract Interaction

Quick Example

Get USDC token info

Installation

Environment Variables

Advanced Setup

Local Project

Shared Team Config

Security

Development

Contributing

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel