MCP Server

flarewatch

io.flarewatch/flarewatch

What this MCP does

Provides Flare and Songbird blockchain data including validator and FTSO metrics, prices, DeFi TVL, wallet rewards, network activity, and reward simulations.

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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['addresses', 'network'], 'properties': {'network': {'type': 'string', 'pattern': '^(flare|songbird)$'}, 'addresses': {'type': 'array', 'items': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'maxItems': 10, 'minItems': 1}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['node_ids'], 'properties': {'node_ids': {'type': 'array', 'items': {'type': 'string', 'pattern': '^NodeID-[1-9A-HJ-NP-Za-km-z]{32,50}$'}, 'maxItems': 10, 'minItems': 1}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'currencies': {'type': 'array', 'items': {'enum': ['usd', 'eur', 'gbp', 'aud', 'jpy', 'cad'], 'type': 'string'}, 'default': ['usd', 'eur', 'gbp', 'aud', 'jpy', 'cad']}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1}, 'sort_by': {'enum': ['score', 'stake', 'apy'], 'type': 'string', 'default': 'score'}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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).
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
get_ftso_provider_history
Get FTSO Provider History
Return the per-epoch reward-rate and composite-score trend for one Flare FTSO provider across the most recent tracked reward epochs (up to 30, newest first). Use this for performance trend over time; use get_ftso_provider_metrics for the current snapshot. address must be a 0x EVM address. found=false when the provider isn't in the tracked window.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['address'], 'properties': {'limit': {'type': 'integer', 'default': 30, 'maximum': 30, 'minimum': 1}, 'address': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['address', 'network'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'network': {'type': 'string', 'pattern': '^(flare|songbird)$'}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['network'], 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1}, 'network': {'type': 'string', 'pattern': '^(flare|songbird)$'}}, 'additionalProperties': False}
get_my_claimable
Get My Claimable
Return claimable rewards across networks for the calling wallet. Currently ships SGB FTSO claimable; FLR-side reward streams (FTSO, MIRROR, FlareDrop, validation) ship in a follow-on phase and return null until then. Requires OAuth scope wallet:read.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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).
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
get_my_rewards_history
Get My Rewards History
Return the calling wallet's cumulative staking/VRM reward state: total earned to date, claimed, unclaimed, FTSO-epoch claimable, and days until unclaimed rewards burn on-chain. Read-only on-chain query. Requires OAuth scope wallet:read. Does not include a full per-epoch claim timeline (see notes).
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
get_my_tax_records
Get My Tax Records
Return structured tax line items (FTSO/MIRROR claims, FlareDrop, validation rewards) for the calling wallet for a given year. NOT a tax calculator. NOT professional advice. Always verify on-chain and consult a CPA. Phase 3 ships the shape; full record assembly lands in a follow-on phase. Requires OAuth scope personal:read.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['year'], 'properties': {'year': {'type': 'integer', 'maximum': 2099, 'minimum': 2020}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'network': {'type': 'string', 'default': 'flare', 'pattern': '^(flare|songbird)$'}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1}, 'since_ts_minute': {'type': 'string'}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['node_id'], 'properties': {'node_id': {'type': 'string', 'pattern': '^NodeID-[1-9A-HJ-NP-Za-km-z]{32,50}$'}}, 'additionalProperties': False}
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; use get_flare_prices for live FLR/SGB/XRP values.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'risk': {'enum': ['low', 'medium', 'high', 'new'], 'type': 'string'}, 'limit': {'type': 'integer', 'default': 500, 'maximum': 500, 'minimum': 1}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['amount_flr'], 'properties': {'amount_flr': {'type': 'number', 'maximum': 10000000000, 'exclusiveMinimum': 0}, 'provider_address': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}}, 'additionalProperties': False}
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.
Read only Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['payload', 'signature'], 'properties': {'payload': {}, 'signature': {'type': 'string', 'maxLength': 256, 'minLength': 32}}, 'additionalProperties': False}
Added
get_my_rewards_history
Sept. 17, 2026, 12:40 p.m.
Added
get_my_tax_records
Sept. 17, 2026, 12:40 p.m.
Added
get_my_portfolio_summary
Sept. 17, 2026, 12:40 p.m.
Added
get_my_claimable
Sept. 17, 2026, 12:40 p.m.
Added
get_my_delegations
Sept. 17, 2026, 12:40 p.m.
Added
verify_response
Sept. 17, 2026, 12:40 p.m.
Added
compare_ftso_providers
Sept. 17, 2026, 12:40 p.m.
Added
compare_validators
Sept. 17, 2026, 12:40 p.m.
Added
simulate_delegation_rewards
Sept. 17, 2026, 12:40 p.m.
Added
get_payment_options
Sept. 17, 2026, 12:40 p.m.
Added
list_ftso_feeds
Sept. 17, 2026, 12:40 p.m.
Added
get_ftso_provider_history
Sept. 17, 2026, 12:40 p.m.
Added
get_chain_activity
Sept. 17, 2026, 12:40 p.m.
Added
get_defi_tvl
Sept. 17, 2026, 12:40 p.m.
Added
get_fassets_status
Sept. 17, 2026, 12:40 p.m.
Added
get_network_economics
Sept. 17, 2026, 12:40 p.m.
Added
get_agent_status
Sept. 17, 2026, 12:40 p.m.
Added
get_agent_capabilities
Sept. 17, 2026, 12:40 p.m.
Added
get_recent_agent_actions
Sept. 17, 2026, 12:40 p.m.
Added
get_flare_prices
Sept. 17, 2026, 12:40 p.m.
Added
get_flarewatch_sgb_entity
Sept. 17, 2026, 12:40 p.m.
Added
get_flarewatch_validator
Sept. 17, 2026, 12:40 p.m.
Added
get_network_status
Sept. 17, 2026, 12:40 p.m.
Added
get_ftso_provider_metrics
Sept. 17, 2026, 12:40 p.m.
Added
get_ftso_providers
Sept. 17, 2026, 12:40 p.m.
Added
get_validator_score
Sept. 17, 2026, 12:40 p.m.
Added
get_flare_validators
Sept. 17, 2026, 12:40 p.m.