MCP Server · Morpho Blue · 2026

A risk reasoning
substrate for
AI agents.

Morpheus is a structured risk modeling layer for Morpho Blue vaults — distributed via the Model Context Protocol. Give your agent the tools to reason about vault health, not just observe it.

MCP Tool · Canonicallive
getVaultSnapshot()
CanonicalTrailingLiquidityCreditStructural

The recommended first call for any vault assessment. Returns a consolidated snapshot of position health — credit risk, cashflow stability, concentration, oracle integrity, and yield — as a single structured object designed for agent consumption.

→ snapshot response
"vault": "steakUSDC",
"at": "2026-04-13T14:22:01Z",
"lenderConfidence": "HIGH",
"sharpe_30d": 1.84,
"hhi": 0.31,
"oracleIntegrityScore": 0.90,
"utilization_wstETH": "82.4%",
"badDebtRatio_30d": "0.00 bps",
"cdr": "4.2%",
"alerts": ["HIGH_UTIL::ETH/USDC"]
System architecture

Three components.
One coherent system.

Layer 01
Risk Metrics Pipeline

Scheduled compute jobs that ingest live Morpho Blue data and produce time-series snapshots across three update tiers — from hourly rolling windows to sub-second event alerts.

Slow hourly · rolling window metrics (Sharpe, HHI)
Medium 5–15 min · utilization, available liquidity
Fast event-driven · liquidations, bad debt, oracle rotation
Layer 02
MCP Server

The distribution layer — a permission-based Model Context Protocol server exposing the pipeline as a structured tool ensemble. Bring your own agent; Morpheus provides the risk reasoning substrate.

getVaultSnapshot · getCreditMetrics · getLiquidity
Each tool annotated with signal type + drill axis
Auth via API token or agent session token (24h)
Layer 03
Developer Portal

A human-readable window into the same data your agent consumes. Validate snapshot output, inspect metric history, and build confidence in the pipeline before deploying to production.

Snapshot explorer · verify agent inputs
API key management · create, rotate, revoke
CLI device flow · auto-wire Claude in 60s
Tool manifest

Every tool is
agent-native.

Each tool carries a natural language purpose declaration, a signal type annotation (trailing / trend / forecast), and a drill axis — so agents can reason about what a tool does before calling it.

ToolDrill AxisSignalDescriptionStatus
getVaultSnapshotCanonicalTrailingConsolidated vault state — the recommended first call. Returns credit, liquidity, structural, and cashflow signals in one object.Live
getCreditMetricsCreditTrailingDefault rate, bad debt ratio, liquidation efficiency, loss given liquidation, and recovery rate across all vault markets.Planned
getLiquidityMetricsLiquidityTrailingUtilization rates, LCR, available liquidity ratio, and cashflow stability sub-scores (DCV, CDR, SYR) per vault.Planned
getConcentrationRiskStructuralTrailingHHI score, single-asset concentration, top-5 allocation share, and whale position ratio. Detects structural dependency.Planned
getOracleIntegrityStructuralTrailingTime-weighted oracle integrity score across vault markets. Surfaces exposure to non-Chainlink or low-quality price feeds.Planned
getPerformanceMetricsYieldTrailingSharpe ratio (7d / 30d / 90d), net APY, yield volatility, TVL mean and delta — all time-bucketed with mean and std dev.Planned
subscribeAlertsAllEventEvent-driven alerts for liquidations, bad debt accumulation, oracle rotations, and utilization threshold breaches.Planned
Computed intelligence

What agents can't know
without Morpheus.

These metrics require rolling-window computation, cross-market correlation, and structured threshold logic — they cannot be derived from raw on-chain state alone.

Cashflow · Composite
Lender Confidence Score
LCS · HIGH / MEDIUM / LOW

Five-factor cashflow stability rating. Combines downside cashflow volatility, drawdown, yield sustainability, incentive dependency, and APY predictability into a single agent-readable signal.

DCV + CDR + SYR + IDR + APRP → composite
Performance · Risk-Adjusted
Sharpe Ratio
SR · 7d · 30d · 90d

Annualized risk-adjusted return vs. a 3.95% risk-free benchmark. The only way an agent can know whether a vault's yield actually compensates for its volatility — not just high in absolute terms.

(μ − r_f) / σ × √365 · rf = 3.95%
Structural · Concentration
HHI Concentration
HHI · 0 = fully diversified

Herfindahl-Hirschman Index across vault market allocations. Agents use this to reason about single-market dependency, identify rebalancing needs, and surface hidden concentration risk before it cascades.

Σ (alloc_i / total_alloc)²
Positioning

Not a dashboard.
A reasoning substrate.

Existing tools — what agents can observe
SQL
Raw TVL, borrow rate, utilization — point-in-time on-chain state with no rolling computation
UI
Protocol-native UIs built for human navigation, not agent consumption or structured output
No Sharpe, HHI, or correlated cross-market risk — agents cannot reason about risk-adjusted yield
No composite scoring — each observable is independent, no signal hierarchy for agents to navigate
No historical snapshots — agents lack time-series context to detect directional trends
Morpheus — what agents can now reason about
Δt
Time-series snapshots across 1d / 7d / 30d / 60d / 90d windows with mean and std dev per metric
MCP
Agent-native tool design — purpose declarations, signal types, and drill axes on every callable tool
LCS
Lender Confidence Score — a 5-factor composite signal no other tool in the Morpho ecosystem computes
SR
Sharpe + HHI — risk-adjusted performance and concentration metrics requiring rolling-window compute
Event-driven fast tier — liquidation, bad debt, and oracle rotation alerts for agent-triggered workflows
Pricing

Two tiers.
One purpose.

API-first pricing. No frontend subscription, no seat-based licensing — pay for the compute and access tier that matches your usage.

Basic
$10/ month

For individual builders and researchers integrating Morpho risk data into agents, scripts, or research pipelines.

Rate limit5 req / sec
Snapshot history30 days
AuthAPI Token
MCP server accessIncluded
Alert webhooks
Agent session token
Start with Basic
Premium
$30/ month

For teams, protocols, and production agent deployments that need full history, higher throughput, and autonomous agent sessions.

Rate limit20 req / sec
Snapshot history90 days
AuthAPI + Agent Session (24h)
MCP server accessIncluded
Alert webhooksIncluded
Agent session token24h autonomous
Start with Premium
Quick setup

Running in
60 seconds.

Option A · Web Portal
1Visit /developer and choose a tier
2Copy your sk_live_ API key
3Add to your MCP client config manually
Recommended
Option B · CLI Device Flow
$ npx morpheus-provision
 
Opening browser for authorization...
→ https://morpheus-ai.dev/auth/device?code=MXPS-7741
 
Waiting for approval...
✓ Approved · writing MCP config
✓ Restart Claude — morpheus is ready
writes to ~/.claude/mcp.json
"mcpServers": {
  "morpheus": {
    "url": "https://morpheus-ai.dev/api/mcp",
    "headers": { "Authorization": "Bearer sk_live_..." }
  }
}