# Spiral Stake

> Leverage-aware yield router on Ethereum mainnet and Robinhood Chain, powered by Morpho. Discover leveraged-yield ("looping") strategies over yield-bearing collateral, preview positions, and get UNSIGNED transactions to open, manage, and close leverage. Non-custodial: the service only builds transactions — your wallet signs them. It never signs, sends, or holds keys.

## Model Context Protocol (MCP)

Agents should connect here. Streamable HTTP transport; works with any MCP-compatible client (Claude, Cursor, etc.).

- [MCP endpoint](https://api.spiralstake.xyz/mcp): Streamable HTTP MCP server. Tools: `list_strategies`, `get_strategy`, `get_prices`, `simulate_leverage`, `build_leverage_tx`, `build_manage_tx`, `get_positions`. Pass `chainId` (1 = Ethereum, 4663 = Robinhood Chain) to target a chain; default is Ethereum.
- [MCP server manifest](https://spiralstake.xyz/.well-known/mcp.json): machine-readable server descriptor.

## Read API (REST)

The same data over plain HTTP, for non-MCP clients.

- [OpenAPI spec](https://api.spiralstake.xyz/openapi.json): full REST schema.
- [Strategies](https://api.spiralstake.xyz/v1/strategies): eligible leveraged-yield strategies with raw risk facts (collateral/borrow APY, leverage ladder, oracle type, exit liquidity, LTVs). Add `?chainId=4663` for Robinhood Chain.
- [Health](https://api.spiralstake.xyz/health): service + supported-chain status.

## What agents can do

- Rank strategies by leveraged APY, oracle safety (nav vs market), exit liquidity, and LTV headroom — every number is a raw, unit-labeled fact (opinions are namespaced under `spiralHints` with their thresholds).
- `simulate_leverage` returns a deterministic position preview (leverage, effective LTV, expected APY, price impact) with no wallet required.
- `build_leverage_tx` / `build_manage_tx` return `{ approvals, tx }` for the user's own wallet to sign. Approvals are scoped to the exact contract; swaps carry a slippage floor. Always simulate first and rebuild if `meta.expiresAt` has passed.

## Links

- [App](https://app.spiralstake.xyz): the Spiral Stake web app.
- [Website](https://spiralstake.xyz): overview and docs.

## Notes

- Numbers are a snapshot (`asOf`); they move with market prices.
- This is not financial advice.