> ## 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.

# Tools overview

> The seven MCP tools and when to use each.

<CardGroup cols={2}>
  <Card title="list_strategies" icon="list" href="/agents/tools/list-strategies">
    List eligible strategies with raw risk facts. Optionally filter by collateral category.
  </Card>

  <Card title="get_strategy" icon="file-magnifying-glass" href="/agents/tools/get-strategy">
    Full facts for one strategy by its Morpho market id.
  </Card>

  <Card title="get_prices" icon="dollar-sign" href="/agents/tools/get-prices">
    Current USD prices for loan/collateral tokens.
  </Card>

  <Card title="simulate_leverage" icon="chart-line" href="/agents/tools/simulate-leverage">
    Deterministic position preview — no wallet needed.
  </Card>

  <Card title="build_leverage_tx" icon="hammer" href="/agents/tools/build-leverage-tx">
    Unsigned transaction to open a position.
  </Card>

  <Card title="build_manage_tx" icon="wrench" href="/agents/tools/build-manage-tx">
    Unsigned transaction to adjust or close a position.
  </Card>

  <Card title="get_positions" icon="wallet" href="/agents/tools/get-positions">
    Read a wallet's open/closed positions from chain state.
  </Card>
</CardGroup>

## Read vs. execution

|               | Tools                                                            | Wallet?                                    |
| ------------- | ---------------------------------------------------------------- | ------------------------------------------ |
| **Read**      | `list_strategies`, `get_strategy`, `get_prices`, `get_positions` | No                                         |
| **Preview**   | `simulate_leverage`                                              | No                                         |
| **Execution** | `build_leverage_tx`, `build_manage_tx`                           | Returns an **unsigned** tx; the user signs |

All tools accept an optional `chainId` (default `1`). Execution tools fail closed with a clear reason on stale data or a missing route — never a half-built transaction.