# 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.

- Surface: `pegana` (api), access: open, served now
- Origin: api.pegana.xyz
- MCP endpoint: https://mcp.geckovision.tech/pegana/mcp
- HTML page: https://geckovision.tech/catalog/pegana

## Use cases

### Check a peg before a swap

Ask: "Is USDG on peg right now?"

Tools, in order: `search_capabilities`, `state_by_mint`

## Get started

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

First call: `search_capabilities` with `{"query":"is USDG on peg right now"}`.

Raw MCP over HTTP, the order for money paths, and the definition of done: https://geckovision.tech/agents.md

## Tools served now

Measured at 2026-09-02T03:01:24.387Z (server pegana 1.28.1): 29 tools.

- `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.