A favicon of Ethereum Tools for Claude

Ethereum Tools for Claude

Ethereum Tools for Claude - A comprehensive blockchain analysis toolkit that enables Claude AI to audit smart contracts, analyze wallets, track profitability, and fetch on-chain data using Model Context Protocol (MCP). Seamlessly integrates blockchain capabilities into Claude for Desktop.

Installation

Installing for Claude Desktop

Option 1: One-Command Installation

npx mcpbar@latest install 0xGval/evm-mcp-tools -c claude

This command will automatically install and configure the Ethereum Tools for Claude MCP server for your selected client.

Option 2: Manual Configuration

Run the command below to open your configuration file:

npx mcpbar@latest edit -c claude

After opening your configuration file, copy and paste this configuration:

View JSON configuration
{
  "mcpServers": {
    "Ethereum Tools for Claude": {
      "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",
        "RAPIDAPI_KEY": "your_rapidapi_key"
      }
    }
  }
}

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
  • Twitter Search: Find tweets by keywords, usernames, dates, or complex search criteria with natural language processing

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
    • RapidAPI - For Twitter search functionality
    • (Optional) RPC provider like Infura or use free public endpoints

Setup Steps

  1. Clone this repository:

    git clone https://github.com/0xGval/evm-tools-mcp
    cd evm-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",
            "RAPIDAPI_KEY": "your_rapidapi_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
  • searchTwitter(query: "ethereum", section: "top", limit: 5): Intelligent Twitter search with natural language processing

    • Automatically formats natural language queries into proper Twitter syntax
    • Understands user queries like "Find tweets by _gval about hyperliquid"
    • Supports advanced Twitter search operators: from:username, has:links, etc.
    • Optional parameters: min_likes, min_retweets, min_replies, start_date, end_date, language
  • twitterSearchHelp(topic: "general"): Get help with Twitter search syntax

    • Available topics: "general", "user", "date"
    • Provides examples and explanations of Twitter search operators

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
  • Twitter search errors: Make sure your RapidAPI key has access to the Twitter154 API

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

Share:
Details:
  • Stars


    6
  • Forks


    4
  • Last commit


    4 months ago
  • Repository age


    4 months
View Repository

Auto-fetched from GitHub .

MCP servers similar to Ethereum Tools for Claude:

 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


Ethereum Tools for Claude: MCP Server – MCP.Bar