Skip to main content
Glama
Veri5ight MCP Server

Veri5ight MCP Server

by 5ajaki

🔍 Veri5ight

Your friendly neighborhood Ethereum node whisperer! A Model Context Protocol (MCP) server that helps Claude chat with Ethereum nodes.

🌟 What's This All About?

Veri5ight is a direct interface between Claude and Ethereum nodes, providing:

  • 💰 Real-time token balance and delegation info for any ERC20

  • 🔎 Smart contract information

  • 🚀 Direct node access without rate limits

  • 🔒 Private, secure interactions

Related MCP server: ENS MCP Server

🚀 Quick Start

# Clone the repository
git clone https://github.com/5ajaki/veri5ight.git

# Install dependencies
npm install

# Build the project
npm run build

⚙️ Configuration

  1. Copy .env.example to .env:

cp .env.example .env
  1. Add your Ethereum node URL (example shown below - update with your actual node URL and port):

ETH_NODE_URL="http://localhost:8545"  # Example - replace with your node's URL and port
  1. Configure Claude Desktop:

{
  "mcpServers": {
    "veri5ight": {
      "command": "node",
      "args": ["/absolute/path/to/veri5ight/dist/index.js"] // Local path to the compiled index.js file
    }
  }
}

Note: The path in step 3 must point to the compiled index.js in your local dist directory. This is created when you run npm run build.

Launch Options

By default, Veri5ight launches automatically with the Claude Desktop App. If you prefer to run it on-demand:

  1. Remove the postbuild script from package.json that auto-launches with Claude

  2. Run manually when needed:

node dist/index.js

🎮 Available Tools

ethereum_getTokenBalance

Get the token balance for any ERC20 token using address or ENS name.

Example:

Claude, what's vitalik.eth's UNI balance?

ethereum_getTokenDelegation

Check delegation info for any governance token.

Example:

Claude, who has nick.eth delegated their tokens to?

ethereum_getContractInfo

Get detailed information about any smart contract.

Example:

Claude, what can you tell me about this contract: nick.eth

ethereum_getRecentTransactions

View recent transactions for any address. Note: This function scans the most recent 10 blocks for transactions involving the specified address.

Example:

Claude, show me any recent transactions for vitalik.eth

The function will return up to the requested number of transactions (default 3) found within those blocks. If no transactions are found in the recent blocks, it will return an empty result.

🔍 Debugging

Check Claude's logs for any issues:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

💡 Why Direct Node Access?

  • Low Latency: Direct node queries without API overhead

  • No Rate Limits: Unlimited queries to your own node

  • Privacy: Queries stay between you and your node

  • Full Access: Complete JSON-RPC API availability

  • Real-time Data: Direct access to latest blockchain state

🛠️ Development

# Watch mode for the cool kids
npm run dev

# Build for production
npm run build

🤝 Contributing

Got ideas? Found a bug? PRs are welcome! Just:

  1. Fork it

  2. Branch it

  3. Code it

  4. PR it

📜 License

MIT - Go wild! See LICENSE for the boring legal stuff.

🙏 Props

  • Built with ❤️ by the Veri5ight team

  • Powered by Claude's big brain

  • Standing on the shoulders of Ethereum giants

🆘 Need Help?

  • 🐛 Found a bug? Open an issue!

  • 🤔 Questions? Start a discussion!

  • 🎉 Cool feature idea? Let's hear it!

Remember: Veri5ight is like a Swiss Army knife for Ethereum data - just don't try to open bottles with it! 🍾

Available Tools

5 tools
ethereum_getContractInfoC

Get information about any contract

Inputs: address (required).

ethereum_getRecentTransactionsC

Get recent transactions for an Ethereum address

Inputs: address (required), limit.

ethereum_getTokenBalanceC

Get ERC20 token balance for an address

Inputs: address (required), token (required).

ethereum_getTokenDelegationC

Get delegation info for an ERC20 governance token

Inputs: address (required), token (required).

ethereum_getTransactionInfoC

Get detailed information about an Ethereum transaction

Inputs: hash (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting different Ethereum data types: contract info, recent transactions, token balance, token delegation, and transaction details. There is no overlap in functionality, making it easy for an agent to select the right tool.

    Naming Consistency5/5

    All tools follow a consistent 'ethereum_verbNoun' pattern with snake_case, using descriptive verbs like 'get' and specific nouns like 'ContractInfo' or 'TokenBalance'. This predictability enhances usability.

    Tool Count4/5

    Five tools is a reasonable number for an Ethereum data server, covering key queries. It might be slightly thin for broader blockchain interactions, but it's well-scoped for its apparent purpose of retrieving specific Ethereum data.

    Completeness3/5

    The tools cover read operations for contracts, transactions, tokens, and delegation, but there are notable gaps such as write operations (e.g., sending transactions), broader blockchain state queries, or support for other token standards. Agents can work with the provided tools but may hit limitations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides Ethereum blockchain data tools via Etherscan's API, enabling users to check ETH balances, view transactions, track token transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names.
      6
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables Claude to interact with the Ethereum Name Service (ENS) system to resolve names, check availability, retrieve records, and perform other ENS-related operations through natural language.
      8
      8
      MIT
    • A
      license
      D
      quality
      D
      maintenance
      A comprehensive toolkit for Ethereum blockchain analysis within Claude AI, enabling contract auditing, wallet analysis, profitability tracking, and on-chain data retrieval.
      11
      2,530 npm
      19
      MIT