Quickstart

The Spiral MCP is a remote Streamable HTTP server. There is nothing to install and no key to obtain.

https://api.spiralstake.xyz/mcp

Add the server to your client

Point any MCP-compatible client at the endpoint. See the per-client guides for Claude Desktop, Cursor, or other clients.

Confirm the tools loaded

Your client should list seven tools: list_strategies, get_strategy, get_prices, simulate_leverage, build_leverage_tx, build_manage_tx, get_positions.

Ask a question

Try: “List Spiral’s stable strategies and simulate 3x on the best one.” The agent will call list_strategies, reason over the facts, then simulate_leverage.

Verify the endpoint

A quick unauthenticated check that the server is live and MCP-valid:

curl -s -X POST https://api.spiralstake.xyz/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Expect a result.serverInfo of { "name": "spiralstake", "version": "0.1.0" }.

Raw curl can’t complete the full stateful tool handshake — use a real MCP client (below) or the MCP Inspector to call tools.

The typical flow

Discover

list_strategies → pick a strategy by its risk facts.

Preview

simulate_leverage → confirm leverage, LTV, expected APY.

Build

build_leverage_tx with the user’s wallet address → get the unsigned tx.

Sign

The user signs approvals then the tx in their own wallet (or opens meta.signingUrl).

Introduction

Connect a client

Concepts

Tools

Guides

Reference

Verify the endpoint

The typical flow

​Verify the endpoint

​The typical flow

Verify the endpoint

The typical flow