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