What is Veri5ight

Veri5ight is an MCP Server that serves as a direct interface between Claude and Ethereum nodes, enabling seamless communication and interaction with blockchain data.

Use cases

Use cases for Veri5ight include querying token balances, checking delegation info for governance tokens, and accessing smart contract details through natural language queries.

How to use

To use Veri5ight, clone the repository, install dependencies, configure the Ethereum node URL in the .env file, and set up Claude Desktop to point to the compiled index.js file. You can run it automatically with Claude or manually as needed.

Key features

Key features of Veri5ight include real-time token balance and delegation information for any ERC20 token, smart contract information access, direct node access without rate limits, and secure private interactions.

Where to use

Veri5ight can be used in various fields including decentralized finance (DeFi), blockchain development, and any application requiring interaction with Ethereum nodes.

🔍 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

🚀 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

2. 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

3. Configure Claude Desktop:

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! 🍾