ethereum-validator-queue-mcp

Purpose

ethereum-validator-queue-mcp is an MCP server for tracking Ethereum's validator activation queue and exit queue in real time, enabling AI agents to monitor staking dynamics and network participation trends.

Key Capabilities

The server provides the following tools and prompts:

Tools

• get_activation_queue(): Returns activation queue statistics, for example "Current activation queue length: 7189 validators, total active validators: 1084363, entering validator balance: 283043.84 ETH, estimated wait time: about 8.0 days."
• get_exit_queue(): Returns exit queue statistics, for example "Current exit queue length: 27152 validators, total active validators: 1084363, exiting validator balance: 882528.00 ETH, estimated wait time: about 30.2 days."
• get_validator_status(pubkey): Returns validator details based on the given public key (a 48-byte hexadecimal string starting with '0x'), for example "Validator 0x1234...: status: active_online, effective balance: 32.00 ETH, activation epoch: 123456, exit epoch: N/A."

Prompts

• analyze_queue(): Generates a prompt for an LLM to analyze queue trends, for example "Analyze the current Ethereum validator queue: What does the current queue length mean for staking demand? How might this affect ETH price and network security? Please provide historical context if possible."

Usage

Environment Requirements

• Python: 3.10 or higher
• uv: a fast, modern Python package manager

Installation Steps

1. Clone the repository:

git clone https://github.com/kukapay/ethereum-validator-queue-mcp.git
cd ethereum-validator-queue-mcp

1. Install dependencies:

uv sync

1. Install to Claude Desktop: Install the server as a Claude Desktop application:

uv run mcp install main.py --name "Ethereum Validator Queue"

Configuration file reference:

{
  "mcpServers": {
    "Ethereum Validator Queue": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ethereum-validator-queue-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Replace /path/to/ethereum-validator-queue-mcp with the actual installation path.

Applicable Scenarios

In an MCP-compatible client (for example, Claude Desktop), you can call the above tools and prompts using natural language prompts, for example:

• Get activation queue statistics: "Show the current Ethereum validator activation queue status." Calls get_activation_queue().
• Get exit queue statistics: "What is the status of the Ethereum validator exit queue?" Calls get_exit_queue().
• Get validator status: "Check the status of the validator with public key 0x93247f2f..." Calls get_validator_status("0x93247f2f...").
• Analyze queue trends: "Analyze the current Ethereum validator queue trends." Calls analyze_queue(), sending the generated prompt to an LLM for analysis.

Limitations

• Requires Python 3.10 or higher and uses the uv package manager.
• Must be installed to an MCP-compatible client before it can be called via natural language.
• Example outputs are based on sample data; actual results depend on the real-time data source.
• The project uses the MIT license; see the LICENSE file for details.