Skip to content

GeObts/lido-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Lido MCP Server

Model Context Protocol (MCP) server for Lido Finance operations

Built by AOX (@AOXexchange, aox.llc) for The Synthesis Ethereum Agent Hackathon 2026.


πŸš€ Live Server

Status: βœ… Running
Server: http://3.142.118.148:3300 (AWS EC2)
Wallet: 0x7e7f825248Ae530610F34a5deB9Bc423f6d63373
Process: PID 116673 (managed via nohup)
Log: ~/lido-mcp/server.log

Server Process

# Check if running ps aux | grep "node index.js" # View logs tail -f ~/lido-mcp/server.log

πŸ§ͺ Live Proof β€” Dry Run Results

Real transaction simulations executed on mainnet:

Test 1: lido_stake (dry_run)

{ "success": true, "dry_run": true, "operation": "stake", "amount": "0.01", "amount_wei": "10000000000000000", "contract": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84", "network": "ethereum-mainnet", "estimated_stETH": "0.01", "gas_estimate": "0.015 ETH", "note": "Simulation only - no transaction executed", "timestamp": "2026-03-19T01:02:10.719Z" }

Test 2: lido_balance (live query)

{ "success": true, "address": "0x7e7f825248Ae530610F34a5deB9Bc423f6d63373", "stETH_balance": "0.0", "timestamp": "2026-03-19T01:02:12.145Z" }

πŸ“‹ Available Tools

Tool Description Network
lido_stake Stake ETH for stETH Ethereum Mainnet
lido_unstake Request unstake (withdrawal queue) Ethereum Mainnet
lido_wrap Wrap stETH to wstETH Base
lido_unwrap Unwrap wstETH to stETH Base
lido_balance Check stETH/wstETH balances Mainnet + Base
lido_rewards Get staking rewards data Mainnet + Base

All write operations support dry_run: true for safe testing.


πŸ”§ Installation

git clone https://github.com/GeObts/lido-mcp.git cd lido-mcp npm install

Environment Setup

cp .env.example .env # Edit .env with your private keys (never commit this file)

πŸš€ Running the Server

Development

node index.js

Production (with nohup)

nohup node index.js > server.log 2>&1 & echo $! > server.pid

Stop Server

kill $(cat server.pid)

πŸ”’ Security

⚠️ WARNING: This server handles real funds.

  • All private keys stored in .env (gitignored)
  • Rate limiting: 10 calls/minute per tool
  • Input validation for amounts (0.001-10 ETH for stakes)
  • Dynamic gas pricing with 20% buffer
  • dry_run mode available for all write operations
  • Never commit real keys β€” use .env.example as template only

πŸ“‘ Usage with MCP Clients

Claude Desktop Config

{ "mcpServers": { "lido": { "command": "node", "args": ["/path/to/lido-mcp/index.js"], "env": { "BANKER_PRIVATE_KEY": "your-private-key" } } } }

Example Tool Calls

Stake ETH (dry run):

{ "tool": "lido_stake", "params": { "amount": "0.1", "dry_run": true } }

Check Balance:

{ "tool": "lido_balance", "params": { "address": "0x7e7f825248Ae530610F34a5deB9Bc423f6d63373" } }

πŸ† Hackathon

Event: The Synthesis β€” Ethereum Agent Hackathon 2026
Team: AOX (Agent Opportunity Exchange)
Prize Track: Lido MCP ($5,000)
ERC-8004: Both Marketplace and Banker agents registered
Repo: https://github.com/GeObts/lido-mcp


πŸ“„ License

MIT β€” See LICENSE


Built by AOX Β· aox.llc Β· @AOXexchange

About

Model Context Protocol server for AI-native Lido ETH staking - The Synthesis Hackathon 2026 - aox.llc

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors