ethcli-mcp 0.1.13

Overview

Exposes 200+ Ethereum tools via the Model Context Protocol (MCP), enabling AI assistants like Claude to query blockchains, analyze transactions, fetch DeFi data, and interact with 50+ data sources.

Features

• 230+ MCP tools - Full ethcli functionality exposed as typed tools
• JSON Schema validation - All tool inputs have schemas for LLM structured output
• Multi-chain support - Ethereum, Polygon, Arbitrum, Optimism, Base, and more
• DEX aggregators - 1inch, CowSwap, LI.FI, KyberSwap, OpenOcean, 0x, Velora, Enso
• Data sources - CoinGecko, DefiLlama, Alchemy, Moralis, Chainlink, Pyth, Dune
• Security tools - GoPlus token analysis, Solodit vulnerability search, bytecode security analysis

Installation

Prerequisites

ethcli must be installed separately. The MCP server spawns ethcli as a subprocess.

cargo install ethcli
ethcli --version

Install ethcli-mcp

cargo install ethcli-mcp

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ethcli": {
      "command": "ethcli-mcp"
    }
  }
}

Manual Testing

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | ethcli-mcp

Tool Categories

Environment Variables

Architecture

┌─────────────────┐     JSON-RPC      ┌─────────────────┐    subprocess    ┌─────────────┐
│  Claude/LLM     │ ◄──── STDIO ────► │   ethcli-mcp    │ ◄─────────────► │   ethcli    │
└─────────────────┘                   └─────────────────┘                  └─────────────┘

Security

• Rate limiting - Max 10 concurrent subprocesses
• Timeouts - 30-second limit on all commands
• Input validation - Argument length limits, null byte detection
• Error sanitization - API keys filtered from error messages

Development

See CONTRIBUTING.md for guidelines.

cargo build -p ethcli-mcp
cargo test -p ethcli-mcp --test integration

License

MIT