flarewatch

List Flare P-Chain validators with FlareWatch composite Score, stake, fee, uptime, and capacity. Sort by score (default), stake, or apy. Pure on-chain + computed data; no editorial ranking. limit caps at 100.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sort_by": {
      "default": "score",
      "type": "string",
      "enum": [
        "score",
        "stake",
        "apy"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the FlareWatch composite Score and full per-dimension breakdown for one Flare validator by NodeID. Each dimension carries its raw score, max, and the detail string explaining the score (e.g. 'Active outage · 3 consecutive missed epochs'). Methodology link returned.

{
  "type": "object",
  "properties": {
    "node_id": {
      "type": "string",
      "pattern": "^NodeID-[1-9A-HJ-NP-Za-km-z]{32,50}$"
    }
  },
  "required": [
    "node_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

List FTSO data providers on Flare or Songbird. Flare rows include FlareWatch composite Score; Songbird rows expose vote power, fee, and last-epoch reward rate (no score on SGB by design). Default sort: score (FLR) / vote power (SGB). limit caps at 100.

{
  "type": "object",
  "properties": {
    "network": {
      "type": "string",
      "pattern": "^(flare|songbird)$"
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "network"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return detailed metrics for one FTSO data provider on Flare or Songbird: fee, reward rate, uptime, vote power, delegator count, and (Flare) the FlareWatch composite Score plus the provider's rank and percentile by score and by reward rate among all providers (provider_count is the denominator). address must be a lowercase 0x EVM address.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "network": {
      "type": "string",
      "pattern": "^(flare|songbird)$"
    }
  },
  "required": [
    "address",
    "network"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return current FTSO reward-epoch state for Flare (default) or Songbird: current epoch ID, when it started, how far into the epoch we are, and how many seconds remain. Source is FlareSystemsManager on-chain reads. Nulls returned when on-chain read fails.

{
  "type": "object",
  "properties": {
    "network": {
      "default": "flare",
      "type": "string",
      "pattern": "^(flare|songbird)$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return FlareWatch's own Flare P-Chain validator stats — same scoring algorithm as every other validator, no promotional weighting. Returns one row per FlareWatch-operated node, with self-bond, delegations, fee, uptime, expiry, and composite Score. is_live=false indicates the row is a cold-load fallback (RPC down or no match yet).

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return FlareWatch's Songbird FTSO entity's live on-chain stats: WSGB vote power, self-balance, current delegation fee, and per-WSGB reward rate from the last finished reward epoch. Source is direct on-chain reads (WNat + WNatDelegationFee + RewardManager). configured=false indicates the entity address isn't set yet.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Latest FLR, SGB and XRP prices in USD and major fiats (EUR, GBP, AUD, JPY, CAD). Each asset has its OWN source (ftso oracle, or coingecko fallback) and sources can differ within one response, so check source per asset. degraded=true only when a whole upstream fails: one asset falling back does NOT set it, nor a missing rate (fx.<cur>=null). fx is the shared USD-to-fiat rate: fiat = usd * fx.

{
  "type": "object",
  "properties": {
    "currencies": {
      "default": [
        "usd",
        "eur",
        "gbp",
        "aud",
        "jpy",
        "cad"
      ],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "usd",
          "eur",
          "gbp",
          "aud",
          "jpy",
          "cad"
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the FlareWatch agent's recent action feed: surface, action kind (observation/propose/topup/rollback/claim/etc), outcome, and detect-to-remediate latency on the agent's own recoveries. Validator-surface entries are proposals only — the node's own controllers act, never the agent. Source: hourly signed snapshot, verifiable via chain_verify_url; available=false when it is unavailable.

{
  "type": "object",
  "properties": {
    "since_ts_minute": {
      "type": "string"
    },
    "limit": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the FlareWatch agent's capability surface: autonomous-vs-total playbook counts per family (validator families are propose-only — autonomous 0 by design), autonomous fraction across agent-owned surfaces, drill correctness, defects caught, and recovery counts (deterministic = the node's own controllers; agentic = the agent). Source: hourly signed snapshot; available=false when unavailable.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the FlareWatch agent's reliability scorecard from its hourly signed snapshot: autonomous fraction across agent-owned surfaces (validator families are propose-only) + per-family breakdown, recovery counts (deterministic = the node's own controllers; agentic = the agent; 30-day window), drill correctness, defects caught, and human-in-the-loop queue depth. available=false when unavailable.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return Flare's monetary metrics: circulating and committed supply, total staked, staking ratio, WFLR supply, annualized inflation (rate + FLR/yr), and the FLR burn rate (daily + annualized estimate) with net supply change. Source is on-chain reads plus a live block sample for the burn estimate. Nulls (not zeros) returned for any leg whose on-chain read fails.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return FAssets status on Flare: for each FAsset (e.g. FXRP), its symbol, underlying asset, minted amount, and USD TVL (minted x underlying price), plus aggregate total_tvl_usd. Source is on-chain totalSupply reads valued at current prices. available=false when the read fails or none are minted.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return total value locked (USD) across the Flare DeFi ecosystem with a per-protocol breakdown (protocol name, TVL, token count). Source is on-chain reads valued at current prices. available=false / total null when the price-dependent TVL read is unavailable.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return live Flare C-chain activity: transactions per second, average block time, block utilization, gas price (gwei), average fee per tx, latest block number, and all-time totals (transactions, addresses, blocks). Source is a live block sample plus explorer stats. Nulls returned when a leg is unavailable.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return one Flare FTSO provider's per-epoch reward-rate and Score trend over the last tracked reward epochs (up to 30, newest first). address may be the provider's entity address or its delegation address. found=false when the provider isn't in the tracked window.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    },
    "limit": {
      "default": 30,
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "address"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

List the FTSO block-latency price feeds Flare's oracle provides (e.g. FLR/USD, BTC/USD, ETH/USD) with Flare's published risk tier for each (low/medium/high/new — volatility + liquidity). Optionally filter by risk. These are the symbols the on-chain oracle prices; this tool returns the feed list, not live prices.

{
  "type": "object",
  "properties": {
    "risk": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "new"
      ]
    },
    "limit": {
      "default": 500,
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return machine-readable payment options for paid FlareWatch capacity: deposit USDT0 on Flare and the sending wallet is credited compute units (CU) that never expire. Includes the deposit address, credit rate, and balance URL. provisioned=false means the rail is not accepting deposits yet.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Estimate annual WFLR FTSO-delegation rewards for delegating an amount to a Flare FTSO provider (defaults to FlareWatch). Annualizes the provider's latest realized per-epoch reward rate (rate x ~104.29 epochs/yr). Returns estimated APR and annual/monthly reward in FLR. A projection, not a guarantee; FTSO delegation only, not P-chain staking. found=false when the provider isn't cached.

{
  "type": "object",
  "properties": {
    "amount_flr": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000
    },
    "provider_address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$"
    }
  },
  "required": [
    "amount_flr"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Side-by-side comparison of up to 10 Flare validators by NodeID. Rows returned in the order supplied (no re-ranking by FlareWatch). Each row carries score, stake, fee, uptime, capacity, APR, and stake-period expiry. Missing NodeIDs return found=false with null fields.

{
  "type": "object",
  "properties": {
    "node_ids": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^NodeID-[1-9A-HJ-NP-Za-km-z]{32,50}$"
      }
    }
  },
  "required": [
    "node_ids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Side-by-side comparison of up to 10 FTSO providers on Flare or Songbird. Rows returned in the order supplied (no re-ranking by FlareWatch). Flare rows include the composite Score; Songbird rows expose vote power, fee, last-epoch reward rate. Missing addresses return found=false with null fields.

{
  "type": "object",
  "properties": {
    "addresses": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$"
      }
    },
    "network": {
      "type": "string",
      "pattern": "^(flare|songbird)$"
    }
  },
  "required": [
    "addresses",
    "network"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Verify that a previously-served FlareWatch MCP response really came from this server. Pass the structured envelope WITHOUT the verification_signature field as payload, and the signature you received as signature. Returns valid=true when the HMAC matches. Useful for cross-AI citation verification.

{
  "type": "object",
  "properties": {
    "payload": {},
    "signature": {
      "type": "string",
      "minLength": 32,
      "maxLength": 256
    }
  },
  "required": [
    "payload",
    "signature"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the calling wallet's WFLR FTSO delegations and P-chain validator delegations. Requires OAuth scope wallet:read. The wallet is resolved from the OAuth token; no input arg accepts a wallet address (cross-tenancy isolation).

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return what the calling wallet can claim right now: Flare FTSO delegation, P-chain staking (mirror), provider fee and validation rewards in FLR, the unclaimed epoch range, and Songbird FTSO rewards. Types owed but not yet priced on-chain are listed in flr_pending_resolution. Requires OAuth scope wallet:read.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the calling wallet's FLR and SGB balances and their USD valuations. Native and wrapped (WFLR / WSGB) balances are reported separately; wrapped balances roll into the per-token USD values and the total. Requires OAuth scope wallet:read.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Return the calling wallet's reward history: FLR claimed per recent reward epoch (at least the last 30 days), split into FTSO delegation, P-chain staking and provider fee (including auto-claims), plus cumulative validation rewards and burn-window countdowns. Read-only. Requires OAuth scope wallet:read.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}