Connect Any Agent
Add Moly to Claude, Cursor, Windsurf, VS Code Copilot, or any MCP client
Moly uses the standard MCP stdio transport. Run the setup wizard once, then add the server config to your AI agent.
Step 1: Setup
Terminal
npx @moly-mcp/lidoThis configures network, mode, wallet, and saves to ~/.moly/config.json.
Step 2: Add MCP Server
MCP Config (works everywhere)
{
"mcpServers": {
"moly": {
"command": "npx",
"args": ["@moly-mcp/lido", "--server"]
}
}
}That's it. Your agent now has 28 Lido tools. Defaults to simulation mode on Hoodi testnet — completely safe.
Where to Put the Config
| Agent | Config File |
|---|---|
| Claude Code | ~/.mcp.json or .mcp.json in project root |
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Claude Desktop (Linux) | ~/.config/Claude/claude_desktop_config.json |
| Cursor | ~/.cursor/mcp.json or .cursor/mcp.json in project root |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code Copilot | .vscode/mcp.json in project root |
| Other MCP clients | Check your client's MCP documentation |
Configure Mode & Network
Use the update_settings tool mid-session, or re-run moly setup to change defaults:
Via tool call
update_settings({ network: "mainnet", mode: "live" })| Setting | Options | Default |
|---|---|---|
| Network | hoodi, mainnet | hoodi |
| Mode | simulation, live | simulation |
Verify
After adding the config, restart your agent and ask:
What Lido tools are available?You should see all available tools. Then try:
What's the stETH balance for 0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18?Example Conversations
Check Balance
You: What's the balance for 0x742d35Cc...?
Agent: [calls get_balance] Shows ETH, stETH, wstETH on Hoodi testnet.Stake ETH
You: Stake 0.1 ETH
Agent: [calls stake_eth] Simulation: ~0.1 stETH expected, gas 82,431.Governance
You: Show me the latest governance proposals
Agent: [calls get_proposals] Lists 5 most recent votes with status.Multi-step
You: Check my balance, then wrap half my stETH
Agent: [calls get_balance] → [calls wrap_steth]
Shows balance, then simulates the wrap.Troubleshooting
| Issue | Fix |
|---|---|
| Tools not showing | Restart your agent after config change |
| Server won't start | Run npx @moly-mcp/lido first to complete setup |
| Timeout errors | RPC may be slow — retry in a moment |
| npx cache stale | Run npx @moly-mcp/lido@latest to force latest version |