> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spiralstake.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> The Spiral Stake MCP server — leveraged-yield strategies for AI agents, non-custodial.

Spiral Stake exposes its leveraged-yield strategies to AI agents through a **Model Context Protocol (MCP)** server. Any MCP-compatible client — Claude, Cursor, or your own — connects to a single endpoint and gains tools to discover strategies, preview positions, and build transactions the user signs.

<Card title="MCP endpoint" icon="plug" href="https://api.spiralstake.xyz/mcp">
  `https://api.spiralstake.xyz/mcp` — Streamable HTTP. Open, no key required.
</Card>

## What an agent can do

<CardGroup cols={2}>
  <Card title="Discover" icon="magnifying-glass">
    List eligible strategies with raw risk facts — collateral/borrow APY, leverage ladder, oracle type, exit liquidity, LTVs.
  </Card>

  <Card title="Simulate" icon="chart-line">
    Preview the exact resulting position — leverage, effective LTV, expected APY, price impact — deterministically, with no wallet.
  </Card>

  <Card title="Build" icon="hammer">
    Get an **unsigned** transaction (approvals + tx) to open, manage, or close a leveraged position.
  </Card>

  <Card title="Read positions" icon="wallet">
    Read a wallet's open/closed positions from chain state — collateral, debt, LTV headroom, live APY.
  </Card>
</CardGroup>

## Non-custodial by design

The server **never signs, sends, or holds keys.** The build tools return a plain `{ approvals, tx }` payload that the user's own wallet signs. This is the same trust model as Morpho, 1inch, and KyberSwap MCPs — the agent orchestrates, the wallet holds custody.

## Facts, not verdicts

Every field is a raw, unit-labeled fact. The only opinion is namespaced under `spiralHints`, and it always ships its own thresholds so an agent can override it. The agent decides; Spiral supplies the numbers.

<Card title="Connect in 2 minutes" icon="rocket" href="/agents/quickstart">
  Point your MCP client at the endpoint and start querying.
</Card>