Spectra Mcp Server

Calibration oracle: what does "normal" look like for a market, pool, or IBT? Produces statistical baselines from historical data — percentiles, anomaly thresholds, peer comparison, and assertion-ready language. This is the bridge between perception (monitoring tools) and specification (security assertions like Phylax Credible Layer). The tool answers "what should the threshold be?" from observation, not theory. For each metric (borrow APY, utilization, TVL, implied APY, etc.), returns: - Normal range (5th-95th percentile from historical data) - Current status (normal / elevated / anomalous) - Anomaly threshold (conservative: min of 3-sigma and 2x historical max) - Peer comparison (where this market sits among similar markets) - Assertion hints (natural language threshold suggestions) Supports Morpho markets (by market key), Pendle markets (by market address), and Spectra pools (by pool/PT address). Auto-detects target type from address format (64-char hex = Morpho, 40-char hex = Pendle/Spectra). Use morpho_get_history or pendle_get_market_history for raw time-series. Use mv_check_ibt_health for single-point health snapshots. Use this tool when you need to CALIBRATE — set thresholds, compare to peers, or export knowledge about what normal looks like.

Analyze a pool's capacity by quoting PT trades at increasing capital sizes. Shows how price impact and effective APY degrade as capital grows, helping curators and large deployers find the sweet spot (max capital with acceptable impact) and the exhaustion point (where APY collapses). Two modes: "pt_buy" (default): Measures PT swap impact via Curve get_dy(). Shows how much capital can be deployed as a directional PT buyer before slippage degrades APY. "lp_add": Measures LP deposit impact. LP deposits add liquidity to BOTH sides of the pool, deepening it rather than consuming it. Impact is near-zero for balanced deposits. Shows pool share concentration and post-deposit pool depth. USE THIS MODE for MetaVault curator capacity analysis — curators deploy as LP. Each tier is quoted independently (not cumulative). Real execution across multiple txns would face additional impact from pool state changes. Output surfaces a capacity framing note: pt_buy mode measures directional swap impact, but MetaVault curators deploy as LP where entry impact is near-zero and the constraint is pool share concentration. Use lp_add mode for curator capacity analysis. On-chain quotes use the actual Curve StableSwap-NG amplification parameter. Set use_on_chain=false for math-only estimates (faster, more conservative). Use spectra_quote_trade for a single exact quote at a specific amount. Use spectra_scan_opportunities for capital-aware ranking across all pools. Use mv_check_ibt_health to verify the underlying IBT before deploying.

Get essential protocol mechanics for Spectra, Pendle, and Morpho — needed for correct reasoning. This server covers 3 protocols with 55 tools. This context tool teaches how they all work. Use topic "pendle_morpho" first if you're unfamiliar with the multi-protocol scope — it explains all three protocols, their tools (spectra_*, pendle_*, morpho_*, mv_*), and when to use cross-protocol tools vs protocol-specific ones. IMPORTANT: MetaVaults (spectra_list_metavaults, spectra_model_metavault, spectra_get_curator_dashboard, spectra_stress_test_vault) are Spectra-specific curated vaults — don't miss them. Use topic "workflow_routing" to learn which tools to call for a given goal (yield optimization, wallet analysis, YT arbitrage, curator strategies, etc.) and how they feed into each other. Recommended starting point for agents new to the tool set. Use topic "pt_yt_mechanics" for how PT/YT splitting works on Spectra. Use topic "router_batching" for how Spectra Router affects pool activity interpretation. Use topic "deposit_path" for step-by-step entry mechanics (how to buy PT, mint YT, LP, loop). Use topic "glossary" for key term definitions (IBT, sw-prefix, LLTV, gauge, maturity value, APR vs APY, underlying, LP, ERC-4626, Curve StableSwap-NG, boost formula). Use topic "fees_and_costs" for protocol YT fees (Spectra 3%, Pendle 5%), reward basis (held vs notional), Merkl campaign types, and external points programs. Use topic "protocol_pulse" for LIVE cross-protocol vital signs (TVL, emissions, pool counts, expiring pools). Fetches real-time data — takes 5-15 seconds. Available topics: pt_yt_mechanics, router_batching, position_analysis, looping, networks, deposit_path, glossary, fees_and_costs, pendle_morpho, workflow_routing, protocol_pulse Omit the topic parameter to get all topics at once.

Aggregate multiple MetaVaults managed by a single curator into one portfolio view. Supports two modes: 1. Discovery mode: provide curator_address to scan all chains and find MetaVaults where the curator's address matches the vault's curator.addresses array. 2. Explicit mode: provide metavault_addresses as a JSON array of {chain, address} pairs to aggregate specific vaults. If both are provided, metavault_addresses takes priority (explicit over discovery). Returns: - Total AUM across all vaults - Blended APY (TVL-weighted) - Projected annual fee revenue at the configured curator fee - Concentration by underlying asset and by chain - Per-vault summary with position count and action items - Cross-vault action items (expiring positions, idle capital, etc.) Use spectra_get_curator_dashboard for deep-dive into a specific vault. Use morpho_monitor_risk for Morpho position health across the curator's address. Use spectra_stress_test_vault for withdrawal simulation on a specific vault.

Scan all Spectra AND Pendle chains for the best yield opportunities, sized to your capital. Cross-protocol scanner designed for MetaVault curators who can allocate to either protocol. Unlike spectra_scan_opportunities (Spectra-only), this tool includes Pendle markets with: - Capital-aware price impact for BOTH protocols - Maturity-aware cross-protocol matching (same underlying + similar expiry) - Morpho looping analysis for Spectra PTs (Pendle looping in future phase) - Unified ranking by effective APY across both protocols - External Merkl campaign APR for both protocols (incentive programs beyond native yield) - Protocol tags ([Spectra] vs [Pendle]) and cross-protocol match indicators Unlike spectra_get_best_fixed_yields or pendle_list_markets, this tool computes effective APY at YOUR capital size — a high-APY pool with thin liquidity may be useless at your scale. The ranking can disagree with spectra_scan_opportunities because it includes a different opportunity set (Pendle markets). This disagreement is intentional — both tools measure different things. Use mv_compare_yield for detailed head-to-head on a specific chain. Use spectra_model_metavault to model blended Spectra+Pendle MetaVault allocation. Use spectra_get_curator_dashboard for operational monitoring of an existing MetaVault.