StakeWise LLM Tools

Real-time StakeWise protocol data for AI assistants. Query vault APYs, user balances, staking rewards, osETH positions, withdrawal queues, and more — directly from the model.

Works with Claude Code, Cursor, Codex, OpenClaw, and any MCP-compatible tool.

What the model can do

• Look up any StakeWise vault — APY, TVL, fee, capacity, osETH minting config
• Show all vaults sorted by APY or browse the full vault list
• Check a user's staked balance, minted/boosted osETH, and earned rewards across all vaults
• Track historical vault performance and personal earnings over time (daily breakdown)
• Monitor unstake and unboost queue status
• Check private vault whitelist and whether a user is whitelisted
• List vaults created (administered) by a given address

Setup

OpenClaw

OpenClaw's api.registerTool does not reliably expose MCP tools to the model. This plugin works around the issue by running a local HTTP server on port 5165 and using a skill file that instructs the model to call endpoints via curl.

Install the plugin:

openclaw plugins install clawhub:stakewise-llm-tools

Allow the model to execute curl against the local server:

openclaw config set tools.exec.security full
openclaw config set tools.exec.ask off

See openclaw#25652 for background on why this is required.

Restart the gateway and start a new conversation:

openclaw gateway restart

Then type /new in the chat to begin a fresh session with the plugin loaded.

Claude Code

Requires tsx installed globally:

npm i -g tsx

Create a .mcp.json file in the root of any project where you want to use these tools:

{
  "mcpServers": {
    "stakewise-llm-tools": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@stakewise/llm-tools"]
    }
  }
}

Restart Claude Code to apply.

Cursor

Go to Settings → Tools & MCPs → New MCP Server, and add to the opened mcp.json:

{
  "mcpServers": {
    "stakewise-llm-tools": {
      "command": "npx",
      "args": ["-y", "@stakewise/llm-tools"]
    }
  }
}

Codex

Add to .codex/config.toml in your project root:

[mcp_servers.stakewise-llm-tools]
command = "npx"
args = ["-y", "@stakewise/llm-tools"]

Available Tools

Tool	Description	Requires address
save_address	Save user wallet for subsequent queries	No
vaults_list	All StakeWise vaults sorted by APY	No
vault_data	Public vault info (APY, fee, capacity, osETH config)	No
vault_stats	Historical vault performance (daily APY, TVL, rewards)	No
vault_whitelist	Whitelist for a private vault	No
staked_vaults	All vaults where the user has a position	Yes
vault_balance	User's detailed position in a specific vault	Yes
vault_queue	Unstake & unboost queue status	Yes
user_stats	User's personal earnings history in a vault	Yes
created_vaults	Vaults administered by the user	Yes

Example Prompts

• "Show me the top StakeWise vaults by APY"
• "What's my staking balance?" (the model will ask for your address first)
• "How has Genesis Vault performed over the last 7 days?"
• "Show my rewards in vault 0x..."
• "Is my withdrawal ready?"
• "Which vaults did I create?"
• "Am I whitelisted in this vault?"

Requirements

• Node.js >= 20.0.0
• tsx installed globally (for MCP server mode)

License

MIT