CATALOG / pegana

Pegana: stablecoin peg and asset state

Pegana comprehended: assets, state and detail by mint, history, alerts and the index, so an agent can read whether a stablecoin is on peg before it routes value through it.

api · open · served now · origin: api.pegana.xyz

Machine readers: the Markdown twin is /catalog/pegana.md

Use cases

• Check a peg before a swap

  Ask: “Is USDG on peg right now?”

  search_capabilities→ state_by_mint

$ claude mcp add --transport http pegana https://mcp.geckovision.tech/pegana/mcp

Tools served now

29 tools, measured 2026-09-02T03:01:24.677Z · server 1.28.1

• search_capabilities

  Find which endpoint/tool fits a natural-language intent. Returns {plan, tools}: `tools` = full schemas for just the ops that answer it; `plan` (when present) =

• get_capability

  Fetch ONE tool's full callable schema by name. Use this whenever you already know which tool you want (e.g. from a tools/list entry) — one schema, no ranking. C

• query_docs

  Search the comprehended API's virtualized docs (spec-derived summaries, params, and agent-native artifacts) to understand WHY a call failed and how to rewrite i

• root

  API index + version

• live

  Liveness probe

• ready

  Readiness probe

• list_alerts

  List recent state-transition alerts Optional: asset, class, limit, since.

• list_assets

  List all active assets Optional: class, peg.

• detail_by_mint

  Get an asset by mint address Required: mint.

• state_by_mint

  Get peg state by mint address Required: mint.

• asset_detail

  Get an asset by symbol Required: symbol.

• history

  Get an asset's discount history Required: symbol. Optional: bucket, from, to, limit.

• state

  Get an asset's current peg state Required: symbol.

• index

  List recent audit receipts Optional: limit, exclude_pegged, state.

• csv

  Export audit receipts as CSV Required: from, to. Optional: asset.

• audit_detail

  `GET /v1/audit/{alert_id}` — single receipt with ADR-0006 four-state

• onchain

  Get an alert's on-chain commit pointer Required: alert_id.

• replay_bundle

  Download an alert's replay bundle Required: alert_id.

• consume_magic

  `POST /v1/auth/magic/consume` — public endpoint the web client calls

• mint_magic

  `POST /v1/auth/magic/mint` — internal endpoint the bot calls when a user

• login

  `POST /v1/auth/telegram` — exchange a verified Telegram Login Widget

• calibration_health

  Per-asset calibration self-monitor (p95 vs band, 8d)

• webhook_ips

  GET /v1/meta/webhook-ips — IP allowlist hint for webhook subscribers.

• webhook_keys

  GET /v1/meta/webhook-keys — active Ed25519 public keys for verifying

• current

  Get the active methodology version

• peg_feed

  Batch peg signal for every active asset, keyed by mint

• peg_feed_by_mint

  Peg signal for a single asset by mint Required: mint.

• summary

  Aggregate counters + delivery health

• ws_handler

  `GET /v1/ws` — upgrade to a WebSocket carrying the live peg-state stream.