Nolus Webapp Backend

{
  "name": "Nolus Webapp Backend",
  "version": "1.0.0",
  "description": "Public REST API for the Nolus Protocol webapp (app.nolus.io). Serves live protocol data \u2014 prices, leases, pools, staking, governance, referrals. Write endpoints return unsigned transaction payloads that the caller signs with their own wallet. The authoritative machine-readable contract is the OpenAPI 3.1 document at /api/openapi.json.\n\nAGENT ROUTING \u2014 pick the right surface for the task:\n\u2022 REST + WebSocket (this card): general-purpose, address-parameterized queries; pre-built unsigned tx payloads for any caller.\n\u2022 @nolus/nolusjs stdio MCP (https://github.com/nolus-protocol/nolus.js#mcp-server): the FULL trading instrument. Runs locally in your agent (Claude Desktop, Cursor, etc.). Includes tx-builder tools (open lease, repay, deposit LPP, withdraw, stake, vote) that produce unsigned txs for the user's wallet. Use this when the agent runs outside the browser or when the user wants programmatic trading actions.\n\u2022 In-page WebMCP (in supportedInterfaces below): VIEW + CONNECT + NAVIGATE ONLY, runs inside the user's browser tab on app.nolus.io. Tools auto-bind to the already-connected wallet (no address parameter). Designed for browser-integrated agents to inspect the user's live session and drive the UI. Does NOT sign or broadcast transactions and never will \u2014 signing remains the wallet popup's responsibility. For tx execution, hand off to @nolus/nolusjs MCP or to the dApp's UI flow.",
  "url": "https://app.nolus.io/",
  "provider": {
    "organization": "Nolus Protocol",
    "url": "https://nolus.io/"
  },
  "documentationUrl": "https://app.nolus.io/api/openapi.json",
  "supportedInterfaces": [
    {
      "url": "https://app.nolus.io/api/",
      "transport": "https",
      "protocol": "rest",
      "description": "REST API (OpenAPI 3.1)",
      "contentType": "application/json"
    },
    {
      "url": "wss://app.nolus.io/ws",
      "transport": "wss",
      "protocol": "websocket",
      "description": "Real-time price and position updates"
    },
    {
      "url": "https://app.nolus.io/",
      "transport": "in-page",
      "protocol": "webmcp",
      "description": "In-page WebMCP tools \u2014 wallet-scoped reads (balances, leases, earn, staking), wallet connect, and UI navigation, registered via navigator.modelContext.registerTool. Tools auto-bind to the user's connected wallet \u2014 no address parameter required. SCOPE: connect, read, and navigate only. Transaction signing is intentionally NOT exposed via WebMCP and never will be \u2014 txs go through the explicit user-driven UI flow with the wallet popup as the consent surface. See https://webmachinelearning.github.io/webmcp/."
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "read-protocol-data",
      "name": "Read live protocol data",
      "description": "Fetch prices, currencies, protocols, leases, earn positions, staking data, governance proposals, fees, and more via /api/* REST endpoints. 85 documented paths in the OpenAPI spec.",
      "tags": [
        "defi",
        "rest-api",
        "read-only"
      ],
      "examples": [
        "What is the current APR on Nolus?",
        "What assets does Nolus support?",
        "What are the active leverage leases for address nolus1abc...?",
        "Which liquidity pools are open?"
      ]
    },
    {
      "id": "build-unsigned-transactions",
      "name": "Build unsigned transactions",
      "description": "POST endpoints under /api/leases/*, /api/earn/*, /api/staking/*, etc. return unsigned Cosmos transaction messages for the user's wallet to sign. The backend never holds keys.",
      "tags": [
        "defi",
        "rest-api",
        "transactions"
      ],
      "examples": [
        "Build a quote for opening a leveraged lease",
        "Prepare a deposit into the earn pool",
        "Stake NLS to validator nolusvaloper1..."
      ]
    },
    {
      "id": "realtime-updates",
      "name": "Real-time updates via WebSocket",
      "description": "Subscribe at wss://app.nolus.io/ws for live price and position updates.",
      "tags": [
        "defi",
        "websocket",
        "realtime"
      ]
    },
    {
      "id": "in-page-webmcp-tools",
      "name": "In-page WebMCP tools",
      "description": "Browser-side tools registered via navigator.modelContext on app.nolus.io. Wallet-scoped reads (get_balances, get_open_leases, get_earn_positions, get_staking_delegations) auto-bind to the connected wallet \u2014 no address argument needed. Plus get_connected_wallet, get_prices, connect_wallet (opens the wallet extension popup, never signs), and navigate(route) for driving the UI. SCOPE: connect, read, navigate only \u2014 transaction signing is NOT exposed and never will be. WHEN TO USE: pick WebMCP when the agent runs in the user's browser and you want to inspect their live in-page session or drive the UI. For TRADING ACTIONS (open/close lease, deposit, repay, stake, vote) use the @nolus/nolusjs stdio MCP server \u2014 it's the real trading instrument. WebMCP is the view + UI driver, nolus.js MCP is the trading instrument; they are complements, not substitutes.",
      "tags": [
        "defi",
        "webmcp",
        "browser",
        "wallet-scoped",
        "read-only-and-navigation"
      ],
      "examples": [
        "Connect my Keplr wallet",
        "What is my current LTV across open leases?",
        "Take me to the earn page",
        "How much NLS am I currently staking and what are my pending rewards?"
      ]
    }
  ]
}