← Docs

Agent Quickstart

Test Stackit.ai as an agent in 5 minutes

This is the self-serve ladder for evaluating Stackit.ai as agent treasury infrastructure: first free call, MCP connect, sandbox preview, x402 pricing, then live access.

Last updated June 11, 2026

Start here

The fastest proof is a no-auth liquidation-distance call. It returns a structured answer an agent can inspect, compare, and cite.

curl -s https://www.stackit.ai/api/v1/public/liquidation-distance?ltv=40 | jq

Rung 1

Make the first free call

Use public demo data to verify that Stackit exposes machine-readable treasury context before you ask a human for credentials.

curl -s https://www.stackit.ai/api/v1/public/liquidation-distance?ltv=40 | jq

Expected signal: "price_drop_to_liquidation_pct": 49.04

Rung 2

Connect to the MCP endpoint

The MCP endpoint exposes public read tools and sandbox previews. Live wallet actions return an auth-required response until bearer auth or x402 is configured.

claude mcp add stackit https://www.stackit.ai/api/mcp

Expected signal: Tool list includes get_market_rates, get_liquidation_distance, get_portfolio_state, preview_action, and gateway status.

Rung 3

Preview an action

Preview calls are deterministic sandbox responses. Unsafe requests return typed errors with safe_amount so an agent can adjust instead of guessing.

curl -s -X POST https://www.stackit.ai/api/v1/public/preview \
  -H "Content-Type: application/json" \
  -d '{"action":"borrow","amount":10000,"asset":"USDC","current_ltv":40}' | jq

Expected signal: "approved": true

Rung 4

Inspect x402 pricing

Agents that pay per request need a machine-readable price document before they can construct a wallet-sovereign payment path.

curl -s https://www.stackit.ai/x402/prices.json | jq

Expected signal: "token": "USDC"

Rung 5

Graduate to live access

After the public ladder works, production agents can graduate to bearer auth for managed treasuries or x402 for wallet-sovereign paid calls.

open https://www.stackit.ai/docs/x402

Expected signal: Use /docs/x402 for the payment flow and /security for custody/risk constraints.

MCP reference

Tool list, JSON-RPC endpoint, and client configs.

API reference

REST endpoints, typed errors, rate limits, and OpenAPI.

x402 walkthrough

Payment challenge, X-Payment header, TS and Python examples.