Spectra Finance

Provides read-only MCP endpoints to discover, analyze, and simulate Spectra yields, portfolios, and opportunities across 10 chains.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "finanzgoblin-spectra-mcp-server": {
      "command": "npx",
      "args": [
        "spectra-mcp-server"
      ]
    }
  }
}

Spectra Finance MCP Server enables AI agents to discover, analyze, and simulate interactions with Spectra’s protocol across multiple chains via the Model Context Protocol. It exposes read-only tools that help you identify the best fixed yields, compare yields, quote trades on-chain, simulate portfolio outcomes, and explore advanced strategies without requiring any wallet or on-chain transactions.

How to use

You interact with the MCP server through an MCP client. Start by connecting the server to your agent, then use the available tools to discover opportunities, analyze portfolios, and simulate trades. The server provides structured outputs and cross-references between tools to help you compose your own analytical workflows. If you need protocol mechanics details, you can query the protocol context on demand.

How to install

Prerequisites: you need Node.js installed on your system. Use a supported package manager to install or run the server directly.

# Install the MCP server globally (optional)
npm install -g spectra-mcp-server

# Or run directly without installing
npx spectra-mcp-server

How to connect to the MCP server

To connect your MCP-enabled client (for example Claude Desktop or Claude Code), configure the server command as shown below. This uses the local, runtime approach with npx.

{
  "mcpServers": {
    "spectra_mcp": {
      "command": "npx",
      "args": ["spectra-mcp-server"]
    }
  }
}

Available tools

get_best_fixed_yields

Scan all chains to discover top fixed-rate yield opportunities. Supports a compact mode for concise results.

list_pools

List active pools on a specific chain, sorted by APY, TVL, and maturity. Supports a compact mode.

get_pt_details

Provide a deep dive on a specific Principal Token to reveal full data.

compare_yield

Compare fixed (PT) vs variable (IBT) yields, including spread mechanics and entry cost analysis.

get_looping_strategy

Calculate leveraged yield via PT + Morpho looping, auto-fetching live Morpho rates when available.

get_morpho_markets

Find Morpho lending markets that accept Spectra PTs as collateral, with chain or symbol filters.

get_morpho_rate

Retrieve live borrow rates and state for a specific Morpho market.

get_protocol_stats

Provide protocol-wide tokenomics, emission schedules, fees, and governance data.

get_supported_chains

List the networks across which Spectra MCP operates.

get_portfolio

Show wallet positions across PT, YT, and LP with USD values and claimable yield.

get_pool_volume

Fetch historical buy/sell trading volume for a pool by PT or pool address.

get_pool_activity

Show recent transactions for a pool or PT address with filtering and address-isolation hints.

get_address_activity

Cross-pool address scanner to reveal interactions across pools and chains.

quote_trade

Quote PT trades using on-chain Curve get_dy() when possible, with price impact and slippage.

simulate_portfolio_after_trade

Preview portfolio state BEFORE/AFTER a hypothetical PT trade with deltas and on-chain quotes.

scan_opportunities

Capital-aware opportunity scanner considering price impact, effective APY, and Morpho looping.

scan_yt_arbitrage

Identify YT arbitrage opportunities where IBT rate diverges from YT implied rate.

get_ve_info

Fetch live veSPECTRA data from Base and compute per-pool boost multipliers.

model_metavault_strategy

Model MetaVault double-loop strategies for curators and evaluate ROI, fees, and TVL effects.

get_protocol_context

Return protocol mechanics reference such as PT/YT identity and Router batching for on-demand queries.