RAG-powered MCP server for Ethereum consensus specs and EIPs
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"eth-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# ethereum-mcp RAG-powered MCP server for Ethereum consensus specs, EIPs, and client source code. [](https://badge.fury.io/py/ethereum-mcp) [](https://github.com/be-nvy/ethereum-mcp/actions/workflows/ci.yml) ## What It Does Indexes and searches across: - [Consensus Specs](https://github.com/ethereum/consensus-specs) - Official beacon chain specifications - [EIPs](https://github.com/ethereum/EIPs) - Ethereum Improvement Proposals - [Builder Specs](https://github.com/ethereum/builder-specs) - MEV-boost and PBS specifications - [leanSpec](https://github.com/leanEthereum/leanSpec) - Python consensus specification implementation - [leanEthereum PQ](https://github.com/leanEthereum) - Post-quantum cryptography (leanSig, leanMultisig, etc.) - Client Source Code - All major EL and CL implementations ## Installation Important note: The package name is eth-mcp, but the commands are ethereum-mcp. Don't download the ethereum-mcp package. ```bash # From PyPI pip install eth-mcp # From source pip install -e . # With client code parsing support pip install -e ".[clients]" # With Voyage API embeddings (best quality) pip install -e ".[voyage]" ``` ## Quick Start ```bash # Build the index (downloads specs + creates embeddings) ethereum-mcp build # Search the specs ethereum-mcp search "slashing penalty" # Check status ethereum-mcp status ``` ## Features ### Incremental Indexing The v0.2.0 release introduces **incremental indexing** - only re-embeds changed files instead of rebuilding the entire index. This reduces update time from minutes to seconds. ```bash # Update repos and incrementally re-index (fast!) ethereum-mcp update # Incremental index (default behavior) ethereum-mcp index # Preview what would change without indexing ethereum-mcp index --dry-run # Force full rebuild ethereum-mcp index --full ``` **How it works:** 1.…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.