Spectra MCP Server

Plan position rollovers for expiring MetaVault positions. When a MetaVault position approaches maturity, the curator must: (1) identify the next pool, (2) estimate transition costs, (3) time the entry, (4) execute the rollover. This tool automates steps 1-3 by scanning Spectra and Pendle for rollover candidates matching the expiring position's underlying asset, computing entry impact at the position's capital size, and ranking by effective APY. Returns per expiring position: ranked list of rollover candidates with entry impact, yield gap (days of zero yield during transition), overlap windo…

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 …

Description is built at runtime.

Calculate a leveraged fixed-yield strategy using Pendle PT + Morpho looping. Strategy: Buy Pendle PT → use as Morpho collateral → borrow underlying → buy more PT → repeat. Each loop multiplies yield exposure. Returns projected yields at different leverage levels (1x to max safe leverage), effective APY, risk parameters, borrow rate sensitivity, and break-even analysis. Automatically fetches the live Morpho borrow rate and LLTV when a matching market exists. NOTE: Looping requires a Morpho market that accepts the specific Pendle PT as collateral. Morpho markets for Pendle PTs exist primaril…

Analyze a Pendle market's capacity by computing price impact at increasing capital sizes. Shows how price impact and effective APY degrade as capital grows, helping curators find the sweet spot (max capital with acceptable impact) and the exhaustion point (where APY collapses). Uses Pendle's logit AMM model (conservative scalarRoot=50) which accounts for time-decay pricing. Near maturity, the AMM becomes more capital-efficient, so impact is lower than constant-product estimates. This is the Pendle equivalent of spectra_get_pool_capacity. Use pendle_get_market_details for full market inform…

Get detailed information about a specific Pendle market by address. Returns: market name, PT/YT/SY/underlying addresses, implied APY (fixed rate), LP APY breakdown (swap fees + PENDLE incentives + boost), underlying variable APY, TVL, pool liquidity, 24h volume, pool reserves, maturity, and external Merkl campaigns. This is the Pendle equivalent of spectra_get_pt_details. Use it to drill into a specific Pendle market after finding it via pendle_list_markets, mv_compare_yield, or mv_scan_curator_opportunities. Use mv_check_ibt_health(ibt_address=SY_ADDRESS) to assess the underlying vault's h…

Historical time-series data for a Pendle market. Shows how implied APY, TVL, volume, PT/YT prices, and other metrics have moved over time. The first tool that answers "what happened?" not just "what is it now?" Enables: trend analysis, yield stability assessment, anomaly detection, conviction building before entry. A flat APY with low stddev means predictable yield. A volatile APY with high stddev means the rate you see today may not persist. Available fields: impliedApy, tvl, tradingVolume, ptPrice, ytPrice, baseApy, lpPrice, lpRewardApy, maxApy, pendleApy, swapFeeApy, syPrice, totalPt, to…

View a wallet's Pendle positions across all chains (or a specific chain). Shows PT, YT, and LP token balances with USD valuations for each Pendle market the wallet has positions in. Includes maturity dates, implied APY, LP APY, strategy inference, and expiry warnings. This is the Pendle equivalent of spectra_get_portfolio. Use pendle_get_market_details to drill into a specific market. Use mv_plan_rollover to plan rollovers for expiring positions. Use spectra_get_portfolio for Spectra positions.

Get Pendle protocol-wide statistics: total TVL, market count, liquidity, and volume across all Pendle-supported chains. Shows per-chain breakdown and aggregate metrics. Includes: - Active market count and TVL per chain - Total pool liquidity and 24h volume - Average implied APY and LP APY - Chain overlap with Spectra (expansion opportunities) The Pendle equivalent of spectra_get_protocol_stats. Use pendle_list_markets for detailed market-level data. Use mv_scan_curator_opportunities for cross-protocol ranking.

Show the yield curve (term structure) for a given underlying asset across Pendle chains. Fetches all active Pendle markets matching the underlying (e.g., "USDC", "ETH", "stETH"), sorts by maturity, and displays implied APY at each point on the curve. This is the fixed-income view: "What rate can I lock for 30 days vs 90 days vs 180 days?" Helps curators spot term premium anomalies, compare cross-chain rates, and choose maturities. The Pendle equivalent of spectra_get_yield_curve. Use pendle_get_market_details to drill into a specific maturity. Use pendle_get_market_capacity to check depth …

Scan Pendle chains for markets approaching maturity. Groups results by urgency: - CRITICAL (≤7d): Immediate action required — redeem or rollover - WARNING (≤14d): Plan rollover within days - ALERT (≤threshold): Monitor and prepare This is the Pendle equivalent of spectra_list_expiring_pools. Useful for: - Portfolio managers who need to plan rollovers - Curators monitoring MetaVault positions that include Pendle PTs - Traders looking for near-maturity convergence plays Use pendle_get_market_details for full market info on an expiring market. Use mv_plan_rollover to plan rollovers for MetaVau…

Description is built at runtime.

Estimate expected output, price impact, and effective APY for a Pendle PT trade. Uses the Pendle logit AMM model to estimate trade outcomes. Shows: - Expected output amount and effective rate - Price impact at your trade size - Effective APY after accounting for entry cost - Minimum output with slippage tolerance Side: - "buy": Spend underlying/SY to get PT (lock in fixed rate) - "sell": Sell PT for underlying/SY (exit fixed position) The Pendle equivalent of spectra_quote_trade. Use pendle_get_market_capacity for a multi-size impact curve. Use pendle_get_market_details for full market inf…

Scan all Pendle chains for the best yield opportunities, sized to your capital. This is the Pendle equivalent of spectra_scan_opportunities. Unlike pendle_get_best_fixed_yields (raw APY ranking), this tool computes: - Entry price impact at YOUR capital size using Pendle's logit AMM model - Effective APY after amortizing entry cost over days to maturity - Pool capacity (max capital before impact exceeds threshold) - Morpho looping availability for Pendle PTs on Morpho-capable chains - External Merkl campaign incentives The ranking reflects what you can actually EARN, not just what the protoco…

Scan Pendle markets for YT (Yield Token) mispricing opportunities. Compares the underlying's variable APY against the implied rate from the PT/YT market price. When these diverge, a spread exists: - Positive spread (Underlying APY > Implied): YT is underpriced — buy YT - Negative spread (Underlying APY < Implied): YT is overpriced — sell YT Unlike Spectra (where YT trades indirectly via Router flash-mint/redeem), Pendle YT trades directly on the Pendle AMM, making execution simpler: - Buy YT: swap SY → YT on Pendle AMM - Sell YT: swap YT → SY on Pendle AMM This is the Pendle equiva…

Simulate how a Pendle PT trade would change a wallet's portfolio. Shows before/after comparison: - Existing Pendle positions on the target chain - New position from the simulated trade - Blended APY across all positions - Concentration analysis Does NOT execute any transaction — purely informational. The Pendle equivalent of spectra_simulate_trade. Use pendle_quote_trade for a detailed trade quote first. Use pendle_get_portfolio to see full current portfolio.

Compare Spectra's fixed yield (via PT) against the variable yield of the underlying interest-bearing token. Helps users decide if locking in a fixed rate is worthwhile versus staying in the variable-rate position. Protocol context: - Fixed rate is labeled "implied APY" (annualized, compounded). Variable rate is labeled "IBT APR" (not compounded). LP yield is labeled "LP APY". Each is labeled at point of use. - Entry cost (price impact) is amortized over days to maturity. - LP alternative: providing liquidity earns trading fees + SPECTRA gauge emissions. Output surfaces competing interpreta…

Scan all pools on a chain (or all chains) for a given address's activity. Returns per-pool breakdown and cross-pool aggregates. Useful for discovering multi-pool strategies without making N manual spectra_get_pool_activity calls. When investigating a wallet that operates across multiple pools (e.g., a curator or yield farmer diversifying across maturities), this tool reveals the full scope of their on-chain activity in one call. Each pool's activity is summarized with type breakdown and total volume. Cross-pool totals show the address's aggregate engagement with Spectra. For deep per-pool a…

Find the best fixed-rate yield opportunities across all Spectra chains. Scans all supported networks and returns the top opportunities ranked by implied APY. Filters by asset type if specified. Important: This ranks by raw implied APY without considering your capital size or pool liquidity. These rankings will often disagree with spectra_scan_opportunities (which ranks by effective APY after entry cost). That disagreement is intentional -- raw APY reflects the pool's headline rate while effective APY reflects what you actually capture at your capital size. Neither ranking is "correct" -- they…

Operational dashboard for MetaVault curators. Aggregates vault health, position status, depositor flows, fee revenue estimates, and actionable alerts into a single view. Designed for curators managing live MetaVaults who need a quick operational overview. Returns: - Vault health: TVL with unallocated ratio (undeployed capital AFTER subtracting external positions — shown when >5%), Status label for non-VISIBLE vaults, live APY with optional 30d avg suffix and APY composition (base vs incentives), share price - APY 4-number breakdown when live-vs-30d delta ≥ 0.5pp: shows base+i…

Full veSPECTRA governance dashboard: gauge vote distribution, voting APRs, bribe incentives, SPECTRA emissions per pool, and Merkl campaign health. Shows where veSPECTRA holders direct their votes, what rewards they earn for voting, and how SPECTRA emissions are distributed across pools. Essential for: - Deciding where to direct veSPECTRA votes for maximum return - Finding pools with active bribe markets (voting incentives) - Understanding emission concentration and governance dynamics - Evaluating bribe efficiency ($ per vote) - Detecting broken emission pipelines (votes directing SPECTRA to…

Calculate a leveraged fixed-yield strategy using Spectra PT + Morpho looping. Strategy: Deposit asset -> mint PT on Spectra -> use PT as collateral on Morpho -> borrow underlying -> deposit again -> repeat. Each loop multiplies yield exposure. Returns projected yields at different leverage levels (1x to max safe leverage), effective APY, and risk parameters. Automatically fetches the live Morpho borrow rate and LLTV when a matching market exists. You can still override morpho_ltv and borrow_rate manually if needed. NOTE: Looping requires a Morpho market that accepts the specific PT as coll…

Description is built at runtime.

Get recent trade and liquidity activity for a specific Spectra pool. Returns individual transactions: buys, sells, and liquidity adds/removes with USD values, timestamps, and tx hashes. Pool activity shows only the Curve pool's perspective (IBT ↔ PT swaps and LP events). The Spectra Router batches operations atomically, so any single pool event may be one step of a multi-step strategy. There is no BUY_YT or SELL_YT event type — the pool never touches YT directly. Use mv_get_protocol_context for the full mechanics of how Router batching maps to pool activity types. Protocol mechanics that aff…

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. I…

Get historical trading volume for a specific Spectra pool. Returns timestamped buy/sell volume in USD. Use spectra_list_pools first to find pool addresses. Useful for assessing pool activity and liquidity depth before entering a position. Context: Volume alone doesn't indicate capital efficiency — $1M volume in a $5M liquidity pool is very different from $1M in a $500K pool. Combine volume data with pool liquidity (from spectra_list_pools or spectra_get_pt_details) to assess real trading conditions. Output includes volume/liquidity ratio analysis when pool data is available. For individual t…

Get wallet positions on Spectra for a specific address. Returns PT, YT, and LP balances with USD values, claimable yield, and current rates. Queries a single chain or all chains. Use this to understand what a wallet currently holds on Spectra. Also fetches unclaimed Merkl rewards (SPECTRA gauge emissions and other incentive programs) per position. Merkl rewards are best-effort — if the Merkl API is unavailable, the portfolio still displays without reward data. Protocol context: - Depositing IBT always mints BOTH PT and YT in equal amounts. If a wallet holds YT but no PT, it sold or LPed it…

Get Spectra protocol-wide statistics: SPECTRA token supply, circulating supply, current weekly emissions, rebase formula, and general protocol info. Use this for questions about SPECTRA tokenomics or protocol health. Protocol context: - Rebase distributes additional SPECTRA to veSPECTRA holders. The formula is highly non-linear: (veSPECTRA/totalSPECTRA)^3. At 10% lock rate, rebase captures ~0.1% of emissions. At 50% lock rate, rebase captures ~12.5%. This incentivizes high ve participation. - Weekly emissions decay exponentially and eventually stabilize. - Gauge emissions boost LP APY a…

Get detailed information about a specific Spectra Principal Token (PT). Returns: maturity date, TVL, implied APY, PT/YT prices, pool liquidity, LP APY breakdown, underlying asset info, IBT protocol, yield leverage, pool reserves (IBT/PT amounts), maturity redemption value, points program multipliers, asset tags, and base IBT info. Protocol context: - PT trades at a discount to its underlying (the discount IS the fixed yield). At maturity, PT redeems for the maturityValue shown (may differ from 1:1). - PT + YT = 1 underlying at maturity. YT price = 1 - PT price (in underlying terms). - YT le…

Get live veSPECTRA governance token information and compute boost scenarios. Reads the current veSPECTRA total supply from Base chain on-chain, and given your balance + a specific pool, computes your exact boost multiplier. The Spectra boost formula: B = min(2.5, 1.5 * (v/V) * (D/d) + 1) v = your veSPECTRA balance V = total veSPECTRA supply (read live from Base) D = pool TVL d = your deposit size Full 2.5x boost when: v/V >= d/D (your share of votes >= your share of pool) Useful for understanding how much veSPECTRA you need for max boost in a given pool at a given deposit size.

Show the yield curve (term structure) for a given underlying asset across all chains. Fetches all active Spectra PTs matching the underlying (e.g., "USDC", "ETH"), sorts by maturity, and displays implied APY at each point on the curve. This is the fixed-income view: "What rate can I lock for 30 days vs 90 days vs 180 days?" Helps curators spot term premium anomalies, compare cross-chain rates at similar maturities, and choose optimal maturity targets. Handles symbol variants automatically (USDC.e, WETH, wstETH → normalized). Use spectra_get_pt_details or mv_check_ibt_health to drill into a…

List all blockchain networks supported by Spectra Finance. Use this as a starting point to discover what's available. Not all chains have identical feature coverage. Morpho looping markets currently exist on mainnet, base, arbitrum, and katana. veSPECTRA governance lives on Base.

Scan all Spectra chains for pools approaching maturity. Returns pools expiring within the specified threshold (default 21 days / 3 weeks), grouped by urgency level. Designed for operators who need lead time to: - Create follow-up pools with new maturities - Submit gauge proposals for successor pools - Plan LP migration and rollover strategies - Coordinate with IBT protocol teams Each result includes the PT address, IBT address, chain ID, underlying asset, TVL, and current implied APY — everything needed to plan the successor pool. Automatically cross-references each expiring pool's IBT agai…

List live MetaVaults from the Spectra API. MetaVaults are ERC-7540 curated vaults that automate LP rollover and compound YT yield back into LP positions. They are managed by curators who earn performance fees on depositor yield. Returns all MetaVaults with: - Curator info, TVL (with unallocated ratio when >5% undeployed, computed AFTER subtracting external positions so avant/pendle externals aren't mislabeled as idle) - Live APY breakdown + 30d avg (when available) - Active Spectra LP positions (PT markets the vault is deployed in) - External Positions: value held OUTSIDE Spe…

List all active Spectra pools on a given chain. Returns a summary of each pool including: asset name, maturity, TVL, implied APY, LP APY, pool liquidity, pool reserves (IBT/PT amounts with ratio), IBT APR breakdown (organic vs incentive yield), maturity redemption value, points multipliers, and asset tags. Metric definitions used across all Spectra tools: - PT TVL = value of underlying deposited to mint PTs (pt.tvl in API) - Liquidity = AMM pool depth (IBT + PT both sides of the Curve pool, pool.liquidity in API) - Implied APY = annualized fixed rate from buying PT at discount - IBT APR = var…

Model a MetaVault "double loop" strategy for curators. MetaVaults are ERC-7540 curated vaults that automate LP rollover and compound YT yield back into LP positions. This tool models the economics of leveraging MetaVault shares as collateral on Morpho (or similar lending markets). Two modes: 1. Live mode: Provide chain + metavault_address to auto-populate base_apy from the live MetaVault API. All other params can be overridden. 2. Manual mode: Provide base_apy directly for hypothetical modeling. The "double loop": Layer 1 (inside vault): YT yield → LP tokens (compounding loop, ma…

Estimate expected output, price impact, and minimum output for a PT trade. Automatically uses on-chain Curve get_dy() for exact quotes when a public RPC is available for the chain. Falls back to a conservative constant-product math estimate if on-chain quoting fails. Side: "buy" = spend underlying/IBT to buy PT (e.g. spend USDC-worth to get PT) "sell" = sell PT to receive underlying/IBT This tool only quotes PT trades on the Curve AMM pool. YT does not trade on the pool directly — YT is acquired by minting (deposit IBT to get PT+YT) or sold via flash-redeem. To estimate YT value: YT pri…

Scan all Spectra chains for the best risk-adjusted yield opportunities, sized to your capital. Unlike spectra_get_best_fixed_yields (which ranks by raw APY), this tool computes: - Entry price impact at YOUR capital size (a 50% APY pool with $10K liquidity is useless at $500K) - Effective APY after amortizing entry cost over days to maturity - Morpho looping availability and optimal leveraged net APY - Pool capacity (max capital before price impact exceeds your threshold) - IBT APR composition (organic base yield vs external incentive programs) - Points program multipliers and asset tags per o…

Scan all Spectra chains for YT (Yield Token) arbitrage opportunities. Compares the IBT's actual current variable APR against the rate implied by the YT's market price. When these diverge significantly, an arbitrage opportunity may exist: - Positive spread (IBT APR > YT implied rate): IBT earns more than the YT price implies - Negative spread (IBT APR < YT implied rate): IBT earns less than the YT price implies Returns opportunities sorted by absolute spread, with capital-aware entry sizing, break-even analysis, IBT APR composition (organic base yield vs external incentive programs — cri…

Preview what a wallet's Spectra portfolio would look like after a PT trade. Fetches the wallet's current position (if any) and the PT pool data, computes a trade quote, then shows BEFORE / TRADE / AFTER with deltas. Works even if the wallet has no existing position (simulates a new entry). Side: "buy" = acquire PT, "sell" = dispose PT. Note: This simulates PT trades only, not YT. YT is acquired by minting (deposit IBT to get PT+YT) and sold via the Router's flash-redeem mechanism, not through the Curve pool directly. The wallet's YT balance is shown but not modified by this simulation. Use…

Simulate a large redemption on a MetaVault to assess withdrawal liquidity. Builds a liquidity waterfall — sources of cash ordered by cost: Tier 1: Unallocated Cash (undeployed, no external — instant, no cost) Tier 1b: Avant Redemption Queue (avUSDx → avUSD burn, ~1 week cooldown per Avant docs, no price impact — emitted only when avant external positions exist; EXCLUDED from within-epoch max-safe calculation due to the delay, INCLUDED in the separate within-1-week metric) Tier 2: Naturally maturing Spectra LP positions (no cost, time-dependent) Tier …