xyz.spiralstake/leverage

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Leveraged-yield router on Morpho. List strategies, simulate, and build UNSIGNED txs.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "leverage": {
      "url": "https://api.spiralstake.xyz/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• list_strategies read-only

  List eligible Spiral strategies on a chain with raw risk facts (collateral/borrow APY, leverage ladder, oracle type, exit liquidity, LTVs, curator). Mainnet (1): correlated yield loops on stables, ETH, BTC and Pendle PTs. Robinhood Chain (4663): stable loops on USDG, directional perps (spiralHints.profile 'leveraged_perp' — APYs are financing carry only) and stock + yield equity vaults (profile 'equity_yield_vault', ids start with 'equity-'). Optionally filter by collateral category.

  Parameters:

  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • category — string — Filter by collateral category: 'stable', 'ETH', 'BTC', 'stable-PT', 'stocks' (equity vaults), 'Other' (perps).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_strategy read-only

  Get one eligible strategy's full raw facts by its Morpho market id.

  Parameters:

  • id (required) — string — Morpho market id (0x followed by 64 hex chars).
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_prices read-only

  Current USD prices of every loan and collateral token the chain's strategies use (token address -> USD), including equity-vault stocks. Loan tokens are priced from CoinGecko; collateral from the market oracle × its loan token's price — the same figures the strategies' priceUsd fields carry.

  Parameters:

  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• simulate_leverage read-only

  Preview opening a leveraged position — deterministic, read-only, no wallet needed. Returns the resulting leverage, effective LTV, leveraged collateral, expected leveraged APY, price impact, the auto-selected execution path, flash-loan size, and (if the flash loan exceeds direct market liquidity) the public-allocator reallocation fee. Numbers move with market prices.

  Parameters:

  • strategyId (required) — string — Morpho market id of the strategy (from list_strategies / get_strategy).
  • payToken (required) — string — Address of the token you pay in. May be the collateral (opened directly) or any other token (zapped: swapped to collateral first). Native ETH = the zero address 0x0000…0000.
  • amount (required) — string — Amount of payToken in human units (e.g. '10000' for 10,000 USDC).
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • leverage — number — Target leverage, e.g. 3. Provide this OR desiredLtv.
  • slippage — number — Swap slippage as a ratio (0.005 = 0.5%). Default 0.005, capped at 0.01.
  • desiredLtv — string — Target LTV percent, e.g. '66.67'. Provide this OR leverage.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• build_leverage_tx

  Build the UNSIGNED transaction to open a leveraged position, for the given wallet to sign. Non-custodial: this server never signs, sends, or holds keys. The canonical output is the executable { approvals[], tx{to,data,value} } — sign and broadcast it directly (approvals first), plus the same position preview as simulate_leverage. meta.signingUrl is an optional one-click link for a human to sign in their own wallet. The embedded swap calldata is time-sensitive (see meta.expiresAt) — rebuild if stale.

  Parameters:

  • strategyId (required) — string — Morpho market id of the strategy (from list_strategies / get_strategy).
  • payToken (required) — string — Address of the token you pay in. May be the collateral (opened directly) or any other token (zapped: swapped to collateral first). Native ETH = the zero address 0x0000…0000.
  • amount (required) — string — Amount of payToken in human units (e.g. '10000' for 10,000 USDC).
  • userAddress (required) — string — The wallet address that will sign and send. Approvals and onBehalfOf are built for it.
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • leverage — number — Target leverage, e.g. 3. Provide this OR desiredLtv.
  • slippage — number — Swap slippage as a ratio (0.005 = 0.5%). Default 0.005, capped at 0.01.
  • desiredLtv — string — Target LTV percent, e.g. '66.67'. Provide this OR leverage.

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

• get_positions read-only

  Read a wallet's open/closed Spiral leverage positions from chain state (read-only). For each: collateral/loan, leveraged collateral, net equity, debt, current LTV vs liquidation LTV (with headroom), current leverage, net USD value, and current leveraged APY. No cost-basis / realized P&L (those need off-chain history). Newest first. `equityPositions` lists the wallet's open equity vaults (stock leg + the yield loop(s) it funds); those loops are excluded from `positions`.

  Parameters:

  • userAddress (required) — string — Wallet address to read positions for.
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• build_manage_tx

  Build the UNSIGNED transaction to adjust or close an OPEN position, for the given wallet to sign. Non-custodial (never signs/holds keys). Canonical output is the executable { approvals[], tx{to,data,value} } (sign/broadcast directly); meta.signingUrl is an optional link for a human to sign in their own wallet. Actions: 'close' (unwind fully), 'increase_leverage' (borrow to a higher LTV), 'add_collateral' (top up — pay in collateral or any token), 'remove_collateral' (withdraw), 'repay' (pay down debt; set full=true to clear it), 'borrow' (draw more loan token). Get the position `id` from get_positions. Swap calldata (close/increase/zap paths) is time-sensitive — see meta.expiresAt.

  Parameters:

  • userAddress (required) — string — Wallet that owns the position and will sign.
  • id (required) — integer — On-chain position index, from get_positions (its `id`).
  • action (required) — string — What to do to the position.
  • full — boolean — repay only: clear the entire remaining debt.
  • amount — string — Human-units amount. Required for add_collateral/remove_collateral/repay/borrow.
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • leverage — number — increase_leverage: target leverage. Provide this OR desiredLtv.
  • payToken — string — Token to pay in (add_collateral/repay). Collateral/loan = direct; any other = zapped. ETH = zero address.
  • slippage — number — Swap slippage ratio (0.005 = 0.5%). Default 0.005, capped at 0.01.
  • desiredLtv — string — increase_leverage: target LTV percent (e.g. '80'). Provide this OR leverage.

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

• simulate_equity_deposit read-only

  Preview depositing USDG into a stock + yield equity vault — deterministic, read-only, no wallet. You end up 1x long the stock (held as your own Morpho collateral), with `stockLtvPct` of its value borrowed as USDG and flash-looped into the vault's yield strategy. Returns the stock received, the borrow, the stock liquidation price and headroom, the yield leg's size/leverage/APY, the net APY at that LTV, fees and price impact per leg.

  Parameters:

  • strategyId (required) — string — The vault's id from list_strategies (starts with 'equity-').
  • amount (required) — string — Deposit amount in human units of the vault's deposit token (USDG), e.g. '10000'.
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • slippage — number — Swap slippage ratio. Default 0.01 (the app's setting for vaults), capped at 0.01.
  • stockLtvPct — string — Stock-leg LTV percent to borrow at (e.g. '50'). Default: the vault's targetLtvPct. Capped at 88% of the stock market's liquidation LTV (55 on a 62.5% market) — a higher value is refused, not clamped.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• build_equity_deposit_tx

  Build the UNSIGNED call batch to deposit into a stock + yield equity vault, for the given wallet to sign. Non-custodial. Returns `calls[]` (approve USDG → router, authorize the router on Morpho, the one-call equityEntry, revoke) to submit as ONE atomic batch (EIP-5792 wallet_sendCalls / Safe), plus the same preview as simulate_equity_deposit. meta.signingUrl is a one-click link for a human to sign in the app. Swap calldata is time-sensitive (meta.expiresAt).

  Parameters:

  • strategyId (required) — string — The vault's id from list_strategies (starts with 'equity-').
  • amount (required) — string — Deposit amount in human units of the vault's deposit token (USDG), e.g. '10000'.
  • userAddress (required) — string — The wallet that will sign and send; the stock leg and yield loop are opened for it.
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • slippage — number — Swap slippage ratio. Default 0.01 (the app's setting for vaults), capped at 0.01.
  • stockLtvPct — string — Stock-leg LTV percent to borrow at (e.g. '50'). Default: the vault's targetLtvPct. Capped at 88% of the stock market's liquidation LTV (55 on a 62.5% market) — a higher value is refused, not clamped.

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

• build_equity_exit_tx

  Build the UNSIGNED call batch to fully unwind an OPEN equity vault (from get_positions.equityPositions): close each of its yield loops, then one self-funded router call repays the stock debt, withdraws the stock, swaps it to USDG and returns the proceeds. Submit as ONE atomic batch. Non-custodial; the vault's yield loop cannot be closed alone through build_manage_tx. Only the vault's own loop(s) are closed: those get_positions attributes unambiguously, or exactly the ones you pass in yieldPositionIds. Always read meta.closedYieldPositionIds.

  Parameters:

  • strategyId (required) — string — The vault's id ('equity-0x…').
  • userAddress (required) — string — Wallet that owns the vault and will sign.
  • chainId — integer — Chain to target. Supported: 1, 4663. Default: 1.
  • slippage — number — Swap slippage ratio. Default 0.01, capped at 0.01.
  • yieldPositionIds — array — The yield loop id(s) to close with the stock leg (from get_positions). Optional when the vault's yieldLoopMatch is tagged/basis/mixed; REQUIRED when it is 'ambiguous'. Nothing outside this list is closed.

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.