finanzgoblin avatar

Spectra Mcp Server

finanzgoblin/spectra-mcp-server

This is a comprehensive yield intelligence interface for DeFi agents working with Spectra Finance, Pendle, and Morpho across 10+ chains. It exposes 55 read-only tools covering PT/YT position analysis, leveraged looping strategies with Morpho collateral, on-chain Curve trade quoting, MetaVault monitoring, and cross-protocol portfolio mapping. The architecture is built around "open emergence" with three knowledge layers: protocol context tools explaining PT/YT mechanics, rich tool descriptions with cross-reference nudges, and runtime analysis hints like position shape detection and supplier cascade modeling. Reach for this when you need an AI agent to discover fixed-rate opportunities, calculate looping economics, stress-test vault withdrawals, or compare yields across protocols without hardcoding strategy logic. Includes veSPECTRA and vePENDLE governance queries, Merkl campaign APR integration, and historical eth_getLogs recovery when API data ages out.

GitHub stars
4
tools
50
transport
STDIO
last updated
Feb 13, 2026

Tools

50 tools

Public tool metadata for what this MCP can expose to an agent.

spectra_get_best_fixed_yieldsScan ALL chains for top fixed-rate opportunities. The main discovery tool. Supports `compact` mode.

Scan ALL chains for top fixed-rate opportunities. The main discovery tool. Supports `compact` mode.

No parameter schema in public metadata yet.

spectra_list_poolsList all active pools on a specific chain, sorted by APY/TVL/maturity. Surfaces pool reserves, IBT APR composition, maturityValue, multipliers, and tags. Supports `compact` mode and `include_expired` flag.

List all active pools on a specific chain, sorted by APY/TVL/maturity. Surfaces pool reserves, IBT APR composition, maturityValue, multipliers, and tags. Supports `compact` mode and `include_expired` flag.

No parameter schema in public metadata yet.

spectra_get_pt_detailsDeep dive on a specific Principal Token -- full data including maturityValue, multipliers (points programs), tags, pool reserves, IBT APR composition, and baseIbt for wrapper tokens.

Deep dive on a specific Principal Token -- full data including maturityValue, multipliers (points programs), tags, pool reserves, IBT APR composition, and baseIbt for wrapper tokens.

No parameter schema in public metadata yet.

spectra_compare_yieldFixed (PT) vs. variable (IBT) yield comparison with spread mechanics and entry cost analysis.

Fixed (PT) vs. variable (IBT) yield comparison with spread mechanics and entry cost analysis.

No parameter schema in public metadata yet.

spectra_get_looping_strategyCalculate leveraged yield via PT + Morpho looping with effective liquidation margins, borrow rate sensitivity (+1/2/3%), break-even period, and failure scenario modeling. Auto-fetches live Morpho rates when a matching market exists.

Calculate leveraged yield via PT + Morpho looping with effective liquidation margins, borrow rate sensitivity (+1/2/3%), break-even period, and failure scenario modeling. Auto-fetches live Morpho rates when a matching market exists.

No parameter schema in public metadata yet.

morpho_list_marketsFind Morpho lending markets that accept Spectra PTs as collateral. Filter by chain or symbol. Shows reward incentives, vault supplier count per market. Cross-references Spectra PT addresses.

Find Morpho lending markets that accept Spectra PTs as collateral. Filter by chain or symbol. Shows reward incentives, vault supplier count per market. Cross-references Spectra PT addresses.

No parameter schema in public metadata yet.

morpho_get_rateGet live borrow rate, state, and supply-side context for a specific Morpho market. Includes PT spread analysis, top supplier identification, and vault allocation details (% of AUM, cap utilization).

Get live borrow rate, state, and supply-side context for a specific Morpho market. Includes PT spread analysis, top supplier identification, and vault allocation details (% of AUM, cap utilization).

No parameter schema in public metadata yet.

morpho_get_market_suppliersSupply-side analysis for a Morpho market: top suppliers ranked by size, vault vs EOA/looper identification, concentration analysis, supply gap warnings. Reveals where lending liquidity comes from.

Supply-side analysis for a Morpho market: top suppliers ranked by size, vault vs EOA/looper identification, concentration analysis, supply gap warnings. Reveals where lending liquidity comes from.

No parameter schema in public metadata yet.

morpho_list_vaultsList Morpho vaults on a chain with enriched allocations: Spectra PT tagging, live borrow rates and utilization per allocation, cap utilization percentages. Parallel-fetches market rates and PT addresses for zero-latency enrichment.

List Morpho vaults on a chain with enriched allocations: Spectra PT tagging, live borrow rates and utilization per allocation, cap utilization percentages. Parallel-fetches market rates and PT addresses for zero-latency enrichment.

No parameter schema in public metadata yet.

morpho_get_positionsQuery a user's Morpho positions across markets and vaults on a chain (or all Morpho chains). Shows collateral, borrows, supply with USD values, vault deposits, health factors, looper detection, and position signals.

Query a user's Morpho positions across markets and vaults on a chain (or all Morpho chains). Shows collateral, borrows, supply with USD values, vault deposits, health factors, looper detection, and position signals.

No parameter schema in public metadata yet.

morpho_get_historyHistorical rates and growth for a specific Morpho market. Shows borrow/supply APY, utilization, and TVL trends with min/avg/max/current stats. Includes rate stability signals, spike detection, and supply/demand squeeze alerts.

Historical rates and growth for a specific Morpho market. Shows borrow/supply APY, utilization, and TVL trends with min/avg/max/current stats. Includes rate stability signals, spike detection, and supply/demand squeeze alerts.

No parameter schema in public metadata yet.

spectra_get_protocol_statsSPECTRA tokenomics, emissions schedule, fee distribution, governance info.

SPECTRA tokenomics, emissions schedule, fee distribution, governance info.

No parameter schema in public metadata yet.

spectra_list_chainsList available networks (10 chains).

List available networks (10 chains).

No parameter schema in public metadata yet.

spectra_get_portfolioWallet positions across PT, YT, and LP with USD values, claimable yield, and Merkl rewards (SPECTRA gauge emissions + incentive programs). Rewards matched to specific pools via reason key parsing.

Wallet positions across PT, YT, and LP with USD values, claimable yield, and Merkl rewards (SPECTRA gauge emissions + incentive programs). Rewards matched to specific pools via reason key parsing.

No parameter schema in public metadata yet.

spectra_get_pool_volumeHistorical buy/sell trading volume for a specific pool. Accepts PT address or pool address.

Historical buy/sell trading volume for a specific pool. Accepts PT address or pool address.

No parameter schema in public metadata yet.

spectra_get_pool_activityRecent individual transactions (buys, sells, liquidity events) with filtering. Address isolation mode presents competing interpretation branches (A/B/C), statistical confidence boundaries on cycles, flow accounting with competing hypotheses, contract/EOA detection, gas estimat...

Recent individual transactions (buys, sells, liquidity events) with filtering. Address isolation mode presents competing interpretation branches (A/B/C), statistical confidence boundaries on cycles, flow accounting with competing hypotheses, contract/EOA detection, gas estimat...

No parameter schema in public metadata yet.

spectra_get_address_activityCross-pool address scanner — finds all pools an address has interacted with on a chain (or all chains) in one call. Includes expired/matured pools via portfolio lookup. Per-pool breakdown + cross-pool aggregates.

Cross-pool address scanner — finds all pools an address has interacted with on a chain (or all chains) in one call. Includes expired/matured pools via portfolio lookup. Per-pool breakdown + cross-pool aggregates.

No parameter schema in public metadata yet.

spectra_quote_tradePT trade quoting with on-chain Curve `get_dy()` for exact output (falls back to math estimate). Shows price impact, slippage, minOut, pool reserves with ratio, and IBT APR composition.

PT trade quoting with on-chain Curve `get_dy()` for exact output (falls back to math estimate). Shows price impact, slippage, minOut, pool reserves with ratio, and IBT APR composition.

No parameter schema in public metadata yet.

spectra_simulate_tradePreview portfolio BEFORE/AFTER a hypothetical PT trade with deltas, warnings, and on-chain quoting.

Preview portfolio BEFORE/AFTER a hypothetical PT trade with deltas, warnings, and on-chain quoting.

No parameter schema in public metadata yet.

spectra_scan_opportunitiesCapital-aware opportunity scanner: price impact at your size, effective APY, Morpho looping, pool capacity, IBT APR composition, and points multipliers. Supports `compact` mode.

Capital-aware opportunity scanner: price impact at your size, effective APY, Morpho looping, pool capacity, IBT APR composition, and points multipliers. Supports `compact` mode.

No parameter schema in public metadata yet.

spectra_scan_yt_arbitrageYT rate vs IBT rate arbitrage scanner -- finds pools where YT is mispriced relative to underlying yield. Includes IBT APR composition for spread sustainability analysis. Supports `compact` mode.

YT rate vs IBT rate arbitrage scanner -- finds pools where YT is mispriced relative to underlying yield. Includes IBT APR composition for spread sustainability analysis. Supports `compact` mode.

No parameter schema in public metadata yet.

spectra_get_ve_infoLive veSPECTRA data from Base chain (total supply via on-chain read) + boost calculator with per-pool multipliers.

Live veSPECTRA data from Base chain (total supply via on-chain read) + boost calculator with per-pool multipliers.

No parameter schema in public metadata yet.

spectra_list_metavaultsList live MetaVaults across all chains (or a specific chain). Returns curator info, TVL, live APY, share price, active positions, and epoch history.

List live MetaVaults across all chains (or a specific chain). Returns curator info, TVL, live APY, share price, active positions, and epoch history.

No parameter schema in public metadata yet.

spectra_model_metavaultMetaVault "double loop" strategy modeler for curators. Live mode (chain + metavault_address) auto-fetches APY from API; manual mode accepts base_apy directly. Models curator economics (fee revenue, TVL creation, effective ROI).

MetaVault "double loop" strategy modeler for curators. Live mode (chain + metavault_address) auto-fetches APY from API; manual mode accepts base_apy directly. Models curator economics (fee revenue, TVL creation, effective ROI).

No parameter schema in public metadata yet.

spectra_get_curator_dashboardOperational dashboard for MetaVault curators. Vault health, position status with vault allocation (when available) vs pool TVL, depositor flows, fee revenue estimates, bridge activity, and actionable alerts. Explicitly disambiguates vault allocation from pool-level TVL to prev...

Operational dashboard for MetaVault curators. Vault health, position status with vault allocation (when available) vs pool TVL, depositor flows, fee revenue estimates, bridge activity, and actionable alerts. Explicitly disambiguates vault allocation from pool-level TVL to prev...

No parameter schema in public metadata yet.

pendle_list_marketsList active Pendle markets on a given chain or all Pendle chains. Supports Pendle-only chains (Mantle, Berachain, HyperEVM, Corn). Supports `compact` mode.

List active Pendle markets on a given chain or all Pendle chains. Supports Pendle-only chains (Mantle, Berachain, HyperEVM, Corn). Supports `compact` mode.

No parameter schema in public metadata yet.

pendle_get_market_detailsDeep dive on a single Pendle market — implied APY, LP APY breakdown (swap fees + PENDLE incentives + boost), underlying variable APY, pool reserves, fee rate, Merkl campaigns.

Deep dive on a single Pendle market — implied APY, LP APY breakdown (swap fees + PENDLE incentives + boost), underlying variable APY, pool reserves, fee rate, Merkl campaigns.

No parameter schema in public metadata yet.

pendle_get_best_fixed_yieldsScan all Pendle chains for top fixed-rate opportunities. Ranked by implied APY with TVL/liquidity filters. The Pendle equivalent of `spectra_get_best_fixed_yields`.

Scan all Pendle chains for top fixed-rate opportunities. Ranked by implied APY with TVL/liquidity filters. The Pendle equivalent of `spectra_get_best_fixed_yields`.

No parameter schema in public metadata yet.

pendle_get_portfolioWallet positions across all Pendle chains — PT, YT, LP balances with USD values and implied APY per position.

Wallet positions across all Pendle chains — PT, YT, LP balances with USD values and implied APY per position.

No parameter schema in public metadata yet.

pendle_scan_opportunitiesCapital-aware Pendle opportunity scanner — price impact at your size using logit AMM model, effective APY, Morpho looping for Pendle PTs, Merkl campaigns. Supports `compact` mode.

Capital-aware Pendle opportunity scanner — price impact at your size using logit AMM model, effective APY, Morpho looping for Pendle PTs, Merkl campaigns. Supports `compact` mode.

No parameter schema in public metadata yet.

pendle_get_market_capacityMulti-size capacity curve for a Pendle market — quotes at geometric capital tiers using logit AMM model to find sweet spot and exhaustion point.

Multi-size capacity curve for a Pendle market — quotes at geometric capital tiers using logit AMM model to find sweet spot and exhaustion point.

No parameter schema in public metadata yet.

pendle_get_yield_curveTerm structure for a given underlying across Pendle chains. All maturities sorted chronologically with curve shape analysis (normal/inverted/flat), steepest segment, cross-chain pairs.

Term structure for a given underlying across Pendle chains. All maturities sorted chronologically with curve shape analysis (normal/inverted/flat), steepest segment, cross-chain pairs.

No parameter schema in public metadata yet.

pendle_list_expiring_marketsScan Pendle chains for markets approaching maturity. Groups by urgency (CRITICAL ≤7d, WARNING ≤14d, ALERT ≤threshold).

Scan Pendle chains for markets approaching maturity. Groups by urgency (CRITICAL ≤7d, WARNING ≤14d, ALERT ≤threshold).

No parameter schema in public metadata yet.

pendle_scan_yt_arbitrageYT mispricing scanner — compares underlying variable APY vs implied rate. Pendle YT trades directly on AMM (simpler execution than Spectra's Router flash-mint/redeem).

YT mispricing scanner — compares underlying variable APY vs implied rate. Pendle YT trades directly on AMM (simpler execution than Spectra's Router flash-mint/redeem).

No parameter schema in public metadata yet.

pendle_get_protocol_statsProtocol-wide aggregate stats — total TVL, market count, volume, avg APY across all Pendle chains with per-chain breakdown and Spectra overlap indicator.

Protocol-wide aggregate stats — total TVL, market count, volume, avg APY across all Pendle chains with per-chain breakdown and Spectra overlap indicator.

No parameter schema in public metadata yet.

pendle_get_looping_strategyLeveraged PT + Morpho looping calculator for Pendle PTs — borrow rate sensitivity, break-even analysis, 30-day historical risk assessment with P(underwater) probability. Auto-detects Morpho markets.

Leveraged PT + Morpho looping calculator for Pendle PTs — borrow rate sensitivity, break-even analysis, 30-day historical risk assessment with P(underwater) probability. Auto-detects Morpho markets.

No parameter schema in public metadata yet.

pendle_quote_tradePT trade quote using Pendle logit AMM model — expected output, price impact, effective APY after entry cost, min output with slippage tolerance.

PT trade quote using Pendle logit AMM model — expected output, price impact, effective APY after entry cost, min output with slippage tolerance.

No parameter schema in public metadata yet.

pendle_simulate_tradePortfolio impact simulation for Pendle PT trades — before/after position values, blended APY change, concentration analysis.

Portfolio impact simulation for Pendle PT trades — before/after position values, blended APY change, concentration analysis.

No parameter schema in public metadata yet.

mv_compare_yieldSide-by-side Pendle vs Spectra yield comparison on overlapping chains (mainnet, base, arbitrum, optimism, sonic, bsc). Maturity-aware matching with configurable tolerance (exact ≤7d, close ≤30d, loose ≤90d).

Side-by-side Pendle vs Spectra yield comparison on overlapping chains (mainnet, base, arbitrum, optimism, sonic, bsc). Maturity-aware matching with configurable tolerance (exact ≤7d, close ≤30d, loose ≤90d).

No parameter schema in public metadata yet.

mv_scan_curator_opportunitiesCross-protocol (Spectra + Pendle) capital-aware scanner for MetaVault curators. Price impact at your size, effective APY, Morpho looping (Spectra + Pendle), cross-protocol match tagging. Supports `compact` mode.

Cross-protocol (Spectra + Pendle) capital-aware scanner for MetaVault curators. Price impact at your size, effective APY, Morpho looping (Spectra + Pendle), cross-protocol match tagging. Supports `compact` mode.

No parameter schema in public metadata yet.

spectra_get_onchain_activityHistorical on-chain activity via `eth_getLogs` — recovers data when the API has aged out transactions. Supports dynamic `rpc_url` parameter for any chain, `token_decimals` for correct formatting (USDC=6, WBTC=8). Decodes Curve pool events (swaps, LP adds/removes) via `pool_add...

Historical on-chain activity via `eth_getLogs` — recovers data when the API has aged out transactions. Supports dynamic `rpc_url` parameter for any chain, `token_decimals` for correct formatting (USDC=6, WBTC=8). Decodes Curve pool events (swaps, LP adds/removes) via `pool_add...

No parameter schema in public metadata yet.

spectra_get_pool_capacityMulti-size capacity curve — quotes PT trades at geometric capital tiers to show price impact and effective APY degradation. Identifies sweet spot and exhaustion point. On-chain Curve quotes.

Multi-size capacity curve — quotes PT trades at geometric capital tiers to show price impact and effective APY degradation. Identifies sweet spot and exhaustion point. On-chain Curve quotes.

No parameter schema in public metadata yet.

mv_check_ibt_healthMulti-signal IBT health assessment — on-chain ERC-4626 conversion rate, APR composition (organic vs incentive), pool balance ratio, protocol recognition, liquidity level. Returns HEALTHY/CAUTION/WARNING verdict.

Multi-signal IBT health assessment — on-chain ERC-4626 conversion rate, APR composition (organic vs incentive), pool balance ratio, protocol recognition, liquidity level. Returns HEALTHY/CAUTION/WARNING verdict.

No parameter schema in public metadata yet.

spectra_get_yield_curveTerm structure for a given underlying across all chains. All maturities sorted chronologically with implied APY, TVL, liquidity. Curve shape analysis (normal/inverted/flat), steepest segment, cross-chain pairs.

Term structure for a given underlying across all chains. All maturities sorted chronologically with implied APY, TVL, liquidity. Curve shape analysis (normal/inverted/flat), steepest segment, cross-chain pairs.

No parameter schema in public metadata yet.

morpho_monitor_riskLiquidation risk monitor for curator Morpho positions — health factor, liquidation price, distance-to-liquidation, borrow rate drift, alert levels (ok/watch/warning/critical).

Liquidation risk monitor for curator Morpho positions — health factor, liquidation price, distance-to-liquidation, borrow rate drift, alert levels (ok/watch/warning/critical).

No parameter schema in public metadata yet.

spectra_stress_test_vaultWithdrawal stress test for MetaVaults — liquidity waterfall (idle → maturing → LP removal → PT sale), cost to remaining depositors, maximum safe redemption size. Market stress mode (2x impact).

Withdrawal stress test for MetaVaults — liquidity waterfall (idle → maturing → LP removal → PT sale), cost to remaining depositors, maximum safe redemption size. Market stress mode (2x impact).

No parameter schema in public metadata yet.

mv_plan_rolloverPosition rollover planner for expiring MetaVault positions — scans Spectra + Pendle for replacement candidates, computes entry impact, yield gap, overlap windows, and net effective APY.

Position rollover planner for expiring MetaVault positions — scans Spectra + Pendle for replacement candidates, computes entry impact, yield gap, overlap windows, and net effective APY.

No parameter schema in public metadata yet.

mv_get_curator_portfolioMulti-vault portfolio aggregation — total AUM, blended APY, fee revenue projection, concentration by underlying/chain, cross-vault action items. Discovery mode (by curator address) or explicit mode.

Multi-vault portfolio aggregation — total AUM, blended APY, fee revenue projection, concentration by underlying/chain, cross-vault action items. Discovery mode (by curator address) or explicit mode.

No parameter schema in public metadata yet.

mv_get_calibrationCalibration oracle — what does "normal" look like? Computes statistical baselines (percentiles, anomaly thresholds) from historical data for any Morpho market, Pendle market, or Spectra pool. Includes peer comparison and assertion-ready threshold language. The bridge between p...

Calibration oracle — what does "normal" look like? Computes statistical baselines (percentiles, anomaly thresholds) from historical data for any Morpho market, Pendle market, or Spectra pool. Includes peer comparison and assertion-ready threshold language. The bridge between p...

No parameter schema in public metadata yet.

mv_get_position_mapCross-protocol position map — sees the WHOLE wallet across Spectra + Pendle + Morpho + governance (veSPECTRA + vePENDLE) in one parallel call. Contradiction detection: unused governance boost, lending when fixed rates are higher, concentration risk, looper detection, expiring...

Cross-protocol position map — sees the WHOLE wallet across Spectra + Pendle + Morpho + governance (veSPECTRA + vePENDLE) in one parallel call. Contradiction detection: unused governance boost, lending when fixed rates are higher, concentration risk, looper detection, expiring...

No parameter schema in public metadata yet.

Sponsors

Readme

MetaVault MCP

Multi-protocol yield intelligence for AI agents — covering Spectra Finance, Pendle, and Morpho via the Model Context Protocol.

55 tools · 3 protocols · 10+ chains · read-only · open emergence architecture · calibration intelligence · on-chain Curve quoting · Pendle logit AMM modeling · ERC-4626 health checks · yield curve term structure · historical eth_getLogs · full Pendle protocol parity (15 tools) · cross-protocol position map · cross-protocol Spectra↔Pendle comparison · veSPECTRA + vePENDLE governance · Pendle historical time-series · Morpho supply-side visibility with supplier cascade modeling · Morpho user positions & historical rates · Merkl campaign APR + expiry integration · entry path awareness · prescriptive observation boundaries · curator risk monitoring · withdrawal stress testing · rollover planning · multi-vault portfolio aggregation · pool expiry monitoring · zero web3 library dependencies

What This Does

Any AI agent (Claude, GPT, open-source) that supports MCP can query Spectra, Pendle, and Morpho in a unified interface to:


View the full README on GitHub

Details

Repository
github.com/finanzgoblin/spectra-mcp-server
Package
spectra-mcp-server
Transport
STDIO
Registry
MCP registry, active