Flarewatch

io.flarewatchPublished by flarewatch.ioOfficial publisherv0.1.5Updated Oct 27, 2026

Verifiable Flare & Songbird data: validator scores, FTSO accuracy, prices, wallet intelligence.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Read-only Flare and Songbird blockchain data: validator and FTSO provider scores, prices, network economics, DeFi TVL, and the caller's own wallet rewards.

What you can do
  • List and compare Flare P-Chain validators and FTSO providers, with composite scores, per-dimension breakdowns, metrics and per-epoch history
  • Read network state: FTSO reward-epoch status, chain activity, supply, inflation, burn rate, FAssets status and DeFi TVL
  • Get FLR, SGB and XRP prices in USD and major fiats, and list the oracle's price feeds with risk tiers
  • Simulate delegation rewards and inspect FlareWatch's own validator and Songbird entity stats
  • Query the calling wallet's delegations, claimable rewards, portfolio balances and reward history (OAuth wallet scope)
  • Verify that a previously served response came from this server, and read the operator agent's action feed and status
When to use it
Useful when you want an assistant to answer questions about Flare or Songbird staking, FTSO delegation, validator selection, token prices or ecosystem metrics, or to look up your own delegation and reward positions without leaving the chat.
Requirements
Runs as a remote streamable HTTP endpoint or as a local npm package over stdio. No API key or environment variable is declared. Wallet-specific tools require an OAuth token with the wallet:read scope; the wallet is resolved from that token. Network access to Flare/Songbird chain data and price sources is needed.
Before you install
Wallet tools expose balances, delegations and claimable rewards tied to your OAuth identity, so grant the wallet:read scope deliberately. Payment options describe depositing USDT0 to a deposit address for prepaid compute units; check the provisioned flag before sending funds. Reward simulations are projections, not guarantees, and some values are null when upstream reads fail.

Installation

In SourceWeft

  1. Open Flarewatch in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.flarewatch%2Fflarewatch/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "flarewatch": {
      "type": "http",
      "url": "https://mcp.flarewatch.io/api/mcp"
    }
  }
}

README

This repository has no README.

Tools

26

get_flare_validators

Get Flare Validators

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.

Parameterslimitsort_by

get_validator_score

Get Validator Score

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.

Parametersnode_idrequired

get_ftso_providers

Get FTSO Providers

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.

Parameterslimitnetworkrequired

get_ftso_provider_metrics

Get FTSO Provider Metrics

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.

Parametersaddressrequirednetworkrequired

get_network_status

Get Network Status

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.

Parametersnetwork

get_flarewatch_validator

Get FlareWatch Validator

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

Takes no parameters.

get_flarewatch_sgb_entity

Get FlareWatch SGB Entity

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.

Takes no parameters.

get_flare_prices

Get Flare Prices

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.

Parameterscurrencies

get_recent_agent_actions

Get Recent Agent Actions

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.

Parameterslimitsince_ts_minute

get_agent_capabilities

Get Agent Capabilities

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.

Takes no parameters.

get_agent_status

Get Agent Status

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.

Takes no parameters.

get_network_economics

Get Network Economics

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.

Takes no parameters.

get_fassets_status

Get FAssets Status

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.

Takes no parameters.

get_defi_tvl

Get DeFi TVL

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.

Takes no parameters.

get_chain_activity

Get Chain Activity

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.

Takes no parameters.

get_ftso_provider_history

Get FTSO Provider History

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.

Parameterslimitaddressrequired

list_ftso_feeds

List FTSO Feeds

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.

Parametersrisklimit

get_payment_options

Get Payment Options

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.

Takes no parameters.

simulate_delegation_rewards

Simulate Delegation Rewards

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.

Parametersamount_flrrequiredprovider_address

compare_validators

Compare Validators

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.

Parametersnode_idsrequired

compare_ftso_providers

Compare FTSO Providers

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.

Parametersnetworkrequiredaddressesrequired

verify_response

Verify Response

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.

Parameterspayloadrequiredsignaturerequired

get_my_delegations

Get My Delegations

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

Takes no parameters.

get_my_claimable

Get My Claimable

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.

Takes no parameters.

get_my_portfolio_summary

Get My Portfolio Summary

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.

Takes no parameters.

get_my_rewards_history

Get My Rewards History

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.

Takes no parameters.

Version history

1
  1. v0.1.5LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.