get_circuit_breaker_state
Returns the state of all WZRD circuit breakers (scoring, publisher, relay). States: CLOSED (healthy), OPEN (tripped, requests blocked), HALF_OPEN (testing recovery). An open relay circuit breaker blocks gasless claim submissions. Use this as a pre-flight check before attempting relay calls.
get_yield_flywheel
Returns the full WZRD yield flywheel state when the live protocol snapshot is available: vault exchange rate, total_staked CCM, buffer_balance (queued for compound), treasury_ccm_balance, routeable_balance, compound_count, last compound/route timestamps, and daily_change_bps. If the snapshot has no yield_flywheel, the tool returns available: false with a reason and may still include APR context; if the status fetch fails, the MCP call surfaces the backend error. Use this to understand the current state of the vLOFI→CCM yield pipeline.
get_exchange_rate_history
Returns the CCM/vLOFI exchange rate history (up to 168 hourly points = 7 days). Each point includes timestamp, rate, total_ccm_assets, total_vlofi_shares, and compound_count. The current_rate is live from the on-chain ExchangeRateOracle PDA. Use this to model yield velocity or plot the compound growth curve.
get_protocol_apr
Returns the public WZRD APR surface derived from exchange-rate history. This can still be available even if get_yield_flywheel is unavailable, because it is history-based. Includes base_apr_bps, total_apr_bps, observation_count, and whether the estimate is ready. Attention bonus and liquidity APR remain null until those economics are live.
get_market_nav
Returns the latest DB-tracked market NAV snapshots for vLOFI-style market vault accounting. Each row includes nav_per_share_bps, reserve_usdc, deployed_usdc, total_usdc, and total_shares.
get_dlmm_pools
Returns the status of all WZRD Meteora DLMM liquidity pools. Each pool shows active_bin, is_in_range, position_count, stranded_since, and last_rebalance_at. Out-of-range or stranded pools are not earning fees. Use this to diagnose DLMM rebalancer health.
simulate_compound_cycle
Snapshot-based feasibility check for the compound keeper over the live protocol status snapshot. Dry-runs the subset of compound gates exposed there without submitting a transaction. Returns would_execute (bool), blockers, buffer_balance, buffer_ccm, threshold_ccm, last_compound_at, and compound_count. Blockers can include vault_keepers_disabled, flywheel_unavailable, vault_paused, and buffer_below_threshold. On flywheel_unavailable, the fallback may still include apr and exchange_rate_ccm context. Use this to know when the next compound is likely to fire from the current snapshot.
simulate_route_yield
Snapshot-based feasibility check for the route_yield keeper over the live protocol status snapshot. Dry-runs the subset of route gates exposed there without submitting a transaction. Returns would_execute (bool), blockers, treasury_ccm_balance, treasury_ccm, available_ccm, sweep_ccm, reserve_floor_ccm, min_route_ccm, max_route_ccm, and last_route_at. Blockers can include vault_keepers_disabled, flywheel_unavailable, vault_paused, and sweep_below_min_route. On flywheel_unavailable, the fallback may still include apr and exchange_rate_ccm context. Use this to predict when CCM will next be routed from treasury to vault buffer.
verify_merkle_proof
Verifies a WZRD V4 global merkle proof against the on-chain stored root. Computes keccak256(DOMAIN || mint || root_seq_le || wallet || cumulative_total_le) as the leaf, walks the proof tree, and compares against the stored root for the given root_seq. Returns valid (bool), leaf_hex, stored_root_hex, and any error. Use this as a paranoid pre-flight check before submitting a claim relay transaction.
simulate_claim
Pre-flight check for a gasless CCM claim relay without submitting a transaction. Returns claimable (bool), unclaimed_ccm_base, proof_valid, relay_circuit_breaker state, and blockers. Blockers: no_proof_found, proof_invalid, already_claimed, relay_circuit_breaker_open. Use this before calling the relay endpoint to diagnose whether a claim will succeed.
get_jupiter_quote
Returns the best Jupiter swap quote for any Solana token pair. Supports Token-2022 tokens (including CCM). Returns inAmount, outAmount, priceImpactPct, routePlan, slippageBps, and contextSlot. Use this to estimate swap costs before routing yield or computing CCM value.
get_ccm_price
Returns the current CCM → USDC price via Jupiter. Convenience wrapper around get_jupiter_quote with CCM and USDC mints pre-filled. Returns outAmount (USDC base units, 6 decimals), priceImpactPct, and routePlan. Use this to value pending claims or compute yield in dollar terms.
get_wallet_position_summary
Returns a portfolio summary for any Solana wallet: positions across all markets, total deposited USDC, vLOFI held, CCM earned from settlements, and claimable CCM from the latest merkle proof. All data is read-only and publicly verifiable on-chain. Each position includes market name, platform, USDC deposited, vLOFI minted, multiplier, settlement status, and human-readable amounts. Use this to assess a wallet's protocol exposure or pre-flight a claim.
get_attention_signal
Returns ranked attention signals across all tracked AI models. Fetches the full leaderboard and classifies each market by velocity percentile: BREAKOUT (p90+), MOMENTUM (p70-90), EMERGING (new + above-median), STABLE (p40-70), COOLING (p20-40), WEAK (<p20). Each signal includes signal_strength_pct (0-100 cross-market percentile), velocity_ema, rank, and snapshot_count. Returns a distribution summary and median_velocity_ema for context. Use this to surface breakout models or filter for specific platform signals.
pick_model
Pick the best AI model for a task based on real-time velocity signals. Returns a single routing decision: which model from your candidate list is gaining the most ecosystem traction right now. Supports local model aliases (e.g. "hermes-3-8b-q4_k_m", "qwen3-27b-q4km") — WZRD strips quant suffixes and matches against HuggingFace model families. If no candidates are provided, returns the top trending model overall. Free, no auth required. Use this before making an inference call to route to the model the ecosystem is converging on.
agent_challenge
Start Ed25519 agent authentication for write-capable MCP flows. Returns the nonce and message format the agent must sign before calling agent_verify.
agent_verify
Verify an Ed25519-signed agent challenge and return a short-lived Bearer token. Use the token as Authorization: Bearer <token> on future MCP calls, or pass it as token in tool arguments.
report_outcome
Record the outcome of a routed inference run for rewards attribution. Requires agent auth. Stores picked vs executed model fidelity, provider, outcome, latency, cost, and optional quality metadata. Idempotent on pick_id per agent.
infer
Run a server-witnessed inference call and receive an execution receipt. The WZRD server picks the eval prompt, calls the provider (Gemini → Nous → OpenRouter), grades the response, and stores a tamper-proof receipt. Returns execution_id which you pass to report_outcome to claim verified CCM rewards. This is the earn path: pick_model → infer → report_outcome → get_rewards_balance. Requires agent auth.
get_rewards_balance
Read the authenticated agent reward pipeline state. Returns pending, claimed, and total earned CCM plus merkle publication status and relay readiness. Requires agent auth.