{
  "status": "ok",
  "server": "frankencoin-mcp",
  "version": "2.0.0",
  "description": "Frankencoin (ZCHF) protocol data server — 17 tools (13 data + 4 webhook)",
  "interfaces": {
    "mcp": "POST /mcp  — MCP protocol (AI agents, Claude Desktop, Cursor)",
    "rest": "GET  /api/<tool>  — plain JSON REST, no handshake (curl, fetch, scripts)",
    "sse": "GET  /sse  — legacy SSE transport (older clients)",
    "webhooks": "/webhooks/*  — event subscription and webhook delivery"
  },
  "tools": [
    {
      "name": "get_protocol_snapshot",
      "description": "Full live state of the Frankencoin (ZCHF) protocol in one call. Returns: total supply + per-chain breakdown, TVL (CHF/USD), FPS price/supply/market cap/reserve/earnings, savings lead rate + base rate + pending proposals, and active challenge count. Best starting point for any protocol question."
    },
    {
      "name": "get_market_data",
      "description": "Live market data: ZCHF peg health (price vs CHF, deviation, status), FPS price, all ecosystem token prices (collateral + ZCHF + FPS), CHF stablecoin comparison (ZCHF vs VCHF vs CHFAU — peg, market cap, volume, supply), macro context (BTC, ETH prices + 24h changes), and accepted collateral token prices with 24h changes. One call for everything price/market related."
    },
    {
      "name": "get_savings",
      "description": "Complete savings picture: current approved rates per chain/module, any pending rate proposals, plus per-module stats (total deposited, interest paid, withdrawals, event counts). Combines rate governance state with TVL/flow data in one call."
    },
    {
      "name": "get_governance",
      "description": "Governance activity: rate proposals (pending/past), minter applications (pending/denied/all), FPS equity trades (buy/sell), and FPS/ZCHF holder stats from Dune. Use 'type' to select what governance data to return."
    },
    {
      "name": "get_positions",
      "description": "ZCHF minting positions. By default returns address list + count (lightweight). Set detail=true for full on-chain data: collateral type/balance, minted amount, available capacity, liquidation price, collateral ratio, risk premium, expiry, cooldown, and live market prices."
    },
    {
      "name": "get_challenges",
      "description": "Liquidation challenges against collateral positions. Returns challenge status, size, bids, timing, collateral details, liquidation price, and position context."
    },
    {
      "name": "get_collaterals",
      "description": "List all accepted collateral types in the Frankencoin protocol — token names, symbols, addresses, decimals, and which chain they're on."
    },
    {
      "name": "get_analytics",
      "description": "Historical protocol analytics. Use 'type' to select: 'time_series' (daily supply, equity, savings, FPS price, rates, earnings — default), 'trades' (FPS equity buy/sell trades), 'minters' (minter application history), 'rate_history' (governance rate change timeline)."
    },
    {
      "name": "get_knowledge",
      "description": "All explanatory and reference content about Frankencoin. Use 'topic' to select: 'overview' (default — what is Frankencoin), 'faq', 'savings' (savings guide), 'governance', 'minting' (minting guide), 'opening_positions', 'auctions', 'risks', 'reserve', 'pool_shares' (FPS explanation), 'api' (API docs), 'compliance' (links + legal), 'token_addresses' (contract addresses all chains), 'links' (all key URLs + exchanges), 'what_is' (same as overview)."
    },
    {
      "name": "get_news",
      "description": "Frankencoin media coverage: press articles (titles, sources, dates, URLs), videos, real-world use cases, and ecosystem partners. Sourced live from the Frankencoin website repository."
    },
    {
      "name": "get_merch",
      "description": "Frankencoin merch store products (merch.frankencoin.com) — titles, prices, variants, availability, images, and direct product URLs. Live data."
    },
    {
      "name": "get_dune_stats",
      "description": "On-chain analytics from Dune Analytics — ZCHF holder count, FPS holder count, historical minting volume, and savings TVL over time. Data may be slightly delayed vs real-time."
    },
    {
      "name": "query_ponder",
      "description": "Execute a raw GraphQL query against the Frankencoin on-chain indexer at ponder.frankencoin.com. Use for advanced queries not covered by other tools. Available entities: mintingHubV2PositionV2s, mintingHubV1PositionV1s, mintingHubV2ChallengeV2s, mintingHubV1ChallengeV1s, equityTrades, analyticDailyLogs, savingsActivity, savingsMappings, frankencoinMinters, eRC20Balances, eRC20TotalSupplys, leadrateRateChangeds, frankencoinProfitLosss, equityTradeCharts."
    },
    {
      "name": "subscribe_events",
      "description": "Subscribe to Frankencoin protocol events via webhook. Events are delivered as HTTP POST to your URL with HMAC-SHA256 signing. Supported events: mint, burn, large_transfer, challenge_start, challenge_bid, challenge_end, depeg, depeg_resolved, fps_large_trade, minter_proposed, minter_approved, position_proposed, rate_change, supply_change."
    },
    {
      "name": "unsubscribe_events",
      "description": "Remove a webhook subscription by ID."
    },
    {
      "name": "list_subscriptions",
      "description": "List all active webhook subscriptions. Optionally filter by URL."
    },
    {
      "name": "get_webhook_status",
      "description": "Health status of the webhook/event system: poller state, subscription counts, delivery stats, error counters."
    }
  ],
  "activeSessions": 872,
  "docs": "https://github.com/Frankencoin-ZCHF/frankencoin-mcp"
}