Skip to main content
Glama

ethereum-tools

by 0xGval

Ethereum Tools for Claude MCP

A comprehensive toolkit for Ethereum blockchain analysis directly within Claude AI using Model Context Protocol (MCP).

Features

  • Smart Contract Audit: Analyze contracts for security issues, verify source code, and detect token standards
  • Wallet Analysis: Check ETH balances, token holdings, and transaction history
  • Profitability Tracking: Calculate wallet profit/loss across tokens and trades
  • Blockchain Data: Fetch and analyze on-chain data with simple commands
  • Token Analysis: Get comprehensive token details, price history, and trading patterns

Installation

Prerequisites

  • Node.js v16+
  • Claude for Desktop
  • Free API keys:
    • Etherscan - For contract verification and analysis
    • Moralis - For wallet profitability and token balances
    • Codex - For token price history and advanced analytics
    • (Optional) RPC provider like Infura or use free public endpoints

Setup Steps

  1. Clone this repository:
    git clone https://github.com/giovannialbero1992/ethereum-tools-mcp cd ethereum-tools-mcp
  2. Install dependencies:
    npm install
  3. Create your configuration:
    • Copy mcp.json.example to mcp.json
    • Edit mcp.json to include your API keys and correct file paths
    { "mcpServers": { "ethereum-tools": { "command": "node", "args": ["YOUR_ABSOLUTE_PATH_TO/main.js"], "env": { "ETH_RPC_URL": "https://eth.llamarpc.com", "MORALIS_API_KEY": "your_moralis_api_key", "ETHERSCAN_API_KEY": "your_etherscan_api_key", "CODEX_API_KEY": "your_codex_api_key" } } } }
  4. Configure Claude for Desktop:
    • On Windows: Create/edit %APPDATA%\Claude\claude_desktop_config.json
    • Copy the contents of your mcp.json file into this configuration

Available Tools

Contract Analysis

  • auditContract(address: "0x..."): Perform security audit on a smart contract

Balance & Tokens

  • getEthBalance(address: "0x..."): Get ETH balance
  • getTransactionCount(address: "0x..."): Get transaction count (nonce)
  • getTokensBalance(address: "0x...", chain: "eth", excludeSpam: true): Get all token balances

Profitability

  • getWalletPnl(address: "0x...", chain: "eth"): Analyze wallet profit/loss

Token Analysis

  • getTokenInfo(address: "0x...", networkId: 1): Get basic token information including name, symbol, and supply
  • getTokenPriceHistory(address: "0x...", networkId: 1, days: 7, resolution: "1D"): Get historical price data
  • analyzeToken(address: "0x...", networkId: 1, days: 30): Perform comprehensive token analysis including volatility and trading patterns

Utilities

  • add(a: 1, b: 2): Simple utility function example

Troubleshooting

Common issues:

  • Environment variables not found: Make sure your API keys are correctly set in mcp.json
  • Provider errors: Check that your ETH_RPC_URL is valid and accessible
  • Path errors: Ensure you're using full absolute paths with proper escaping in Windows (\\)
  • Codex API issues: Verify your Codex API key is valid and has permission to access token data

Development

To add new tools:

  1. Create or modify files in the tools/ directory
  2. Register your tools in main.js
  3. Restart Claude for Desktop to see changes

License

This project is licensed under the MIT License.

Acknowledgements

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A comprehensive toolkit for Ethereum blockchain analysis within Claude AI, enabling contract auditing, wallet analysis, profitability tracking, and on-chain data retrieval.

  1. Features
    1. Installation
      1. Prerequisites
      2. Setup Steps
    2. Available Tools
      1. Contract Analysis
      2. Balance & Tokens
      3. Profitability
      4. Token Analysis
      5. Utilities
    3. Troubleshooting
      1. Development
        1. License
          1. Acknowledgements

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              Enables Claude to interact with Ethereum nodes, allowing users to check ENS token balances, view smart contract code, and decode transactions through natural language.
              Last updated -
              5
              1
              JavaScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              Provides onchain tools for Claude AI to interact with the Base blockchain and Coinbase API, enabling wallet management, fund transfers, and smart contract deployment.
              Last updated -
              28
              262
              TypeScript
              MIT License
              • Apple
              • Linux
            • A
              security
              A
              license
              A
              quality
              Provides tools for AI assistants to interact with the Ethereum blockchain through standard JSON-RPC methods, enabling queries for account balances, gas prices, and smart contract code.
              Last updated -
              6
              8
              JavaScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              Provides Claude with access to Ethereum and EVM-compatible blockchain operations, enabling wallet management, transaction handling, contract interactions, and blockchain queries through natural language.
              Last updated -
              35
              434
              4
              TypeScript
              MIT License
              • Apple
              • Linux

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/0xGval/evm-mcp-tools'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server