Lido MCP

Lido MCP Server

Reference for building or using an MCP server that makes Lido staking operations natively callable by AI agents.

Core Operations

1. Stake ETH → stETH

Send ETH to the Lido contract's submit() function:

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84\",\"data\":\"0xa1903eab0000000000000000000000000000000000000000000000000000000000000000\",\"value\":\"0xde0b6b3a7640000\"},\"latest\"],\"id\":1}'"

0xa1903eab = submit(address _referral). Send ETH as value. Returns shares minted.

2. Wrap stETH → wstETH

Approve stETH then call wrap():

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0\",\"data\":\"0xea598cb00000000000000000000000000000000000000000000000000000000000000000\"},\"latest\"],\"id\":1}'"

0xea598cb0 = wrap(uint256 _stETHAmount). Returns wstETH amount.

3. Unwrap wstETH → stETH

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0\",\"data\":\"0xde0e9a3e0000000000000000000000000000000000000000000000000000000000000000\"},\"latest\"],\"id\":1}'"

0xde0e9a3e = unwrap(uint256 _wstETHAmount). Returns stETH amount.

4. Request Withdrawal (Unstake)

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1\",\"data\":\"0xd6681042\"},\"latest\"],\"id\":1}'"

Withdrawal Queue: 0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1 Key functions: requestWithdrawals(uint256[] amounts, address owner), claimWithdrawals(uint256[] requestIds, uint256[] hints)

Balance & Rate Queries

stETH balance:

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84\",\"data\":\"0x70a08231000000000000000000000000USER_ADDRESS_HERE\"},\"latest\"],\"id\":1}'"

wstETH/stETH exchange rate:

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0\",\"data\":\"0x035faf82\"},\"latest\"],\"id\":1}'"

0x035faf82 = stEthPerToken(). Divide result by 1e18.

Shares balance (underlying stETH shares):

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84\",\"data\":\"0xf5eb42dc000000000000000000000000USER_ADDRESS_HERE\"},\"latest\"],\"id\":1}'"

0xf5eb42dc = sharesOf(address).

Total pooled ETH:

exec command="curl -s -X POST https://eth.llamarpc.com -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"method\":\"eth_call\",\"params\":[{\"to\":\"0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84\",\"data\":\"0x37cfdaca\"},\"latest\"],\"id\":1}'"

0x37cfdaca = getTotalPooledEther().

Lido REST APIs (Free, no auth)

APR API (https://eth-api.lido.fi)

Current APR (7-day SMA):

web_fetch url="https://eth-api.lido.fi/v1/protocol/steth/apr/sma"

Latest APR:

web_fetch url="https://eth-api.lido.fi/v1/protocol/steth/apr/last"

Protocol stats:

web_fetch url="https://eth-api.lido.fi/v1/protocol/steth/stats"

Withdrawal Queue API (https://wq-api.lido.fi)

Queue wait time:

web_fetch url="https://wq-api.lido.fi/v2/request-time/calculate"

Estimated time for specific amount:

web_fetch url="https://wq-api.lido.fi/v2/request-time/calculate?amount=32"

Time for specific request IDs:

web_fetch url="https://wq-api.lido.fi/v2/request-time?ids=1&ids=2"

Reward History API (https://reward-history-backend.lido.fi)

Staking rewards for an address:

web_fetch url="https://reward-history-backend.lido.fi/?address=0xUSER&currency=USD&onlyRewards=true"

Governance (Aragon DAO)

Query active proposals via Snapshot:

exec command="curl -s -X POST 'https://hub.snapshot.org/graphql' -H 'Content-Type: application/json' -d '{\"query\":\"{proposals(first:5,where:{space:\\\"lido-snapshot.eth\\\",state:\\\"active\\\"},orderBy:\\\"created\\\",orderDirection:desc){id title state start end scores_total}}\"}'

Contract Addresses

Ethereum Mainnet

Lido Earn Vaults (Mellow)

wstETH on L2s

Chainlink Price Feeds

MCP Tool Schema

Recommended MCP tools for a Lido server:

All write operations must support dry_run: true to simulate without executing.

Key Integration Notes

• stETH rebases daily — holder balances change. Use sharesOf() for stable accounting.
• wstETH does NOT rebase — preferred for DeFi, L2 bridging, and agent wallets.
• 1-2 wei rounding: stETH transfers may lose 1-2 wei due to shares math. Always use transferShares() for exact amounts.
• Withdrawal queue: requests are NFTs (ERC-721). Min 100 wei, max 1000 stETH per request. Finalization takes 1-5 days.
• Staking limits: call getCurrentStakeLimit() before staking. If limit insufficient, swap on DEX instead.
• L2 wstETH: bridged via canonical bridges. Same non-rebasing behavior as mainnet.
• Withdrawal functions: requestWithdrawalsWstETH() accepts wstETH directly. Use getWithdrawalStatus() to check finalization.
• LDO token quirk: returns false instead of reverting on transfer failure — always check return value.