Ethereum Wallet Generator MCP server

Ethereum Wallet Toolkit

A collection of Ethereum wallet tools: Python CLI utilities (ethtoolkit.py, wallet.py, keystore.py, sign.py, transaction.py, typeddata.py, validate.py, vanity.py), five Model Context Protocol (MCP) servers exposing wallet functionality to AI assistants, a fully offline single-file HTML wallet (offline.html), and an x402 payment facilitator. See the sections below for each component.

Offline Build - Official Ethereumjs Libraries

This directory contains the build system to create offline1.html using official ethereumjs libraries.

Libraries Used

All libraries are from the official Ethereum ecosystem:

• @ethereumjs/tx - Transaction signing (legacy + EIP-1559)
• @ethereumjs/util - Utilities (address validation, checksums, etc.)
• @ethereumjs/rlp - RLP encoding
• @ethereumjs/wallet - Wallet utilities
• ethereum-cryptography - Official cryptographic primitives (secp256k1, keccak256)
• @scure/bip39 - BIP39 mnemonic (used by ethereumjs)
• @scure/bip32 - BIP32 HD derivation (used by ethereumjs)

Build Instructions

# Navigate to this directory
cd offline-build

# Install dependencies
npm install

# Build offline1.html
npm run build

The output file offline1.html will be created in the parent directory.

What Gets Bundled

The build process uses esbuild to:

1. Bundle all ethereumjs libraries and their dependencies
2. Minify the code for smaller file size
3. Inline everything into a single HTML file

Typical bundle size: ~400-600 KB (varies by version)

Features

All features match the CLI tool:

• Wallet Generation - Random keypair generation
• Mnemonic Support - Create/restore BIP39 mnemonics, derive accounts
• Vanity Addresses - All vanity options (prefix, suffix, regex, etc.)
• Message Signing - EIP-191 personal_sign
• Signature Verification - Recover signer from signature
• Validation - Address and key validation
• Keystore - V3 keystore encrypt/decrypt (PBKDF2)
• Transactions - Sign legacy and EIP-1559 transactions offline
• EIP-712 - Typed data signing and verification

Security

• The generated HTML file is completely self-contained
• No external network requests
• Can be saved and used on an air-gapped machine
• Uses official, audited Ethereum libraries

MCP Servers

This repository includes 5 Model Context Protocol (MCP) servers that expose Ethereum wallet functionality to AI assistants like Claude.

Documentation

• Prompt Examples - Real-world prompts for interacting with the servers
• Testing Guide - How to run and write tests
• Integration Guide - Setting up with Claude Desktop and other tools
• Workflows & Recipes - Common workflows combining multiple servers

Overview

Total: 57 tools, 348 tests

Quick Start

Installation

Each server is a standalone Python package:

# Install all servers
pip install -e ./ethereum-wallet-mcp
pip install -e ./keystore-mcp-server
pip install -e ./signing-mcp-server
pip install -e ./transaction-mcp-server
pip install -e ./validation-mcp-server

Claude Desktop Configuration

Add to your claudedesktopconfig.json:

Shortened. The full README is on GitHub.