MCP Server
Philidor DeFi Vault Risk Analytics
io.philidor/defi-vaults
What this MCP does
Searches, compares, and analyzes DeFi vaults and lending markets using TVL, APR, risk scores, incidents, and protocol data.
Capabilities
Tools
14
tools
check_loop_venue
Underwrite a collateral/debt loop on ONE lending market: score, tier, utilization, borrow APR, deposit status, and recent incidents for both reserves. Does not compute health factor and does not prepare txs. Call this before a protocol MCP preview_action / prepare_action. If you do not have a market id, call list_markets first (Aave V4: protocol=aave, version=v4). Examples: aave-v4-1-main, aave-v4-10-etherfi-cash, aave-v4-1-hub-global-dollar.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['marketId', 'collateral', 'debt'], 'properties': {'debt': {'type': 'string', 'description': 'Debt asset symbol you will borrow (e.g. USDC, USDT, GHO).'}, 'marketId': {'type': 'string', 'description': 'Market id from list_markets. Spoke example: aave-v4-1-main. Hub example: aave-v4-1-hub-global-dollar.'}, 'collateral': {'type': 'string', 'description': 'Collateral asset symbol you will post (e.g. weETH, WETH, cbBTC).'}}, 'additionalProperties': False}
compare_vaults
Compare 2-3 DeFi vaults side-by-side on TVL, APR, risk score, risk tier, audited status, and more.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['vaults'], 'properties': {'vaults': {'type': 'array', 'items': {'type': 'object', 'required': ['network', 'address'], 'properties': {'address': {'type': 'string', 'description': "Vault address in the chain's namespace: 0x-hex on EVM chains, base58 (case-sensitive) on Solana"}, 'network': {'type': 'string', 'description': 'Network slug from the chain registry (e.g. ethereum, base, arbitrum, solana). /v1/chains lists slugs for chains with active vaults.'}}, 'additionalProperties': False}, 'maxItems': 3, 'minItems': 2, 'description': 'Array of 2-3 vaults to compare'}}, 'additionalProperties': False}
explain_risk_score
Explain what a Philidor risk score means, including the tier (Prime/Core/Edge), how it is calculated, and what the thresholds are.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['score'], 'properties': {'score': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Risk score (0-10) to explain'}}, 'additionalProperties': False}
find_safest_vaults
Find the highest risk-scored DeFi vaults, optionally filtered by asset, chain, or minimum TVL. Returns the top 10 audited vaults sorted by Philidor risk score (higher = lower assessed risk; scores are not a safety guarantee).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'asset': {'type': 'string', 'description': 'Filter by asset symbol (e.g. USDC, WETH)'}, 'chain': {'type': 'string', 'description': 'Filter by chain name or slug (e.g. Ethereum, Base, Arbitrum, Solana)'}, 'minTvl': {'type': 'number', 'description': 'Minimum TVL in USD'}}, 'additionalProperties': False}
get_curator_info
Get detailed information about a vault curator including their managed vaults, TVL, chain distribution, and performance.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['curatorId'], 'properties': {'curatorId': {'type': 'string', 'description': 'Curator ID'}}, 'additionalProperties': False}
get_market
Get one lending market with every reserve it contains: supplied, supply APR, borrowed, borrow APR, utilization and risk tier per reserve. Spoke ids look like aave-v4-10-etherfi-cash. Aave V4 hub parents (aave-v4-1-hub-global-dollar) are composed from the spokes that share that hub; /v1/markets does not serve those ids.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['marketId'], 'properties': {'marketId': {'type': 'string', 'description': 'Market id from list_markets. Spoke example: aave-v4-10-etherfi-cash. Hub example: aave-v4-1-hub-global-dollar.'}}, 'additionalProperties': False}
get_market_events
Published risk events for ONE lending market: incidents, bad debt, liquidation cascades (e.g. mass liquidations on a Morpho Blue market). Market ids look like morpho-v1-1-pt-reusd-10dec2026-usdc-91-5. Aave V4 hub ids (aave-v4-1-hub-global-dollar) union the spoke feeds. Not platform stats (get_market_overview) and not the market data itself (get_market).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['marketId'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max events (default 20)'}, 'marketId': {'type': 'string', 'description': 'Market id from list_markets. Spoke or composed hub parent (aave-v4-1-hub-global-dollar).'}}, 'additionalProperties': False}
get_market_overview
Get a high-level overview of the DeFi vault market: total TVL, vault count, risk distribution, and TVL by protocol.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_protocol_info
Get detailed information about a DeFi protocol including TVL, vault count, versions, auditors, and security incidents.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['protocolId'], 'properties': {'protocolId': {'type': 'string', 'description': 'Protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino. Aave V4 is listed under aave (aave-v4 is accepted as an alias).'}}, 'additionalProperties': False}
get_vault
Get detailed information about a specific DeFi vault including risk breakdown, recent events, and historical snapshots. Lookup by ID or by network + address.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'id': {'type': 'string', 'description': 'Vault ID (e.g. morpho-1-0x...)'}, 'address': {'type': 'string', 'description': "Vault address in the chain's namespace: 0x-hex on EVM chains, base58 (case-sensitive) on Solana"}, 'network': {'type': 'string', 'description': 'Network slug from the chain registry (e.g. ethereum, base, arbitrum, solana). /v1/chains lists slugs for chains with active vaults.'}}, 'additionalProperties': False}
get_vault_risk_breakdown
Get a detailed breakdown of a vault's risk vectors: Asset Composition, Platform and Strategy, Control and Governance, and History scores with sub-metrics.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['network', 'address'], 'properties': {'address': {'type': 'string', 'description': "Vault address in the chain's namespace: 0x-hex on EVM chains, base58 (case-sensitive) on Solana"}, 'network': {'type': 'string', 'description': 'Network slug from the chain registry (e.g. ethereum, base, arbitrum, solana). /v1/chains lists slugs for chains with active vaults.'}}, 'additionalProperties': False}
list_markets
List lending markets: the market a depositor actually picks (Aave/Spark pool, Aave V4 spoke, Compound Comet, Morpho Blue pair, or Kamino K-Lend market). Aave V4 spokes that share a liquidity hub are grouped under a composed parent (aave-v4-1-hub-global-dollar). The API still keys each market on the spoke. NOTE: this is not `get_market_overview`, which returns platform-wide totals across all vaults.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'type': ['number', 'string'], 'description': 'Filter by chain: integer chain id (e.g. 1, 8453) or slug (e.g. ethereum, solana)'}, 'limit': {'type': 'number', 'description': 'Results per page (1-100, default 20)'}, 'sortBy': {'enum': ['total_supplied_usd', 'total_borrowed_usd', 'reserve_count', 'name'], 'type': 'string', 'description': 'Sort field (default total_supplied_usd)'}, 'version': {'type': 'string', 'description': 'Filter by protocol version: v3, v4, or klend. Use version=v4 with protocol=aave.'}, 'protocol': {'type': 'string', 'description': 'Filter by protocol id: aave, spark, compound, morpho, kamino. Aave V4 is protocol=aave plus version=v4 (aave-v4 is accepted as an alias).'}}, 'additionalProperties': False}
list_vaults_with_incidents
List all vaults that had a recent critical incident (last 365 days). Critical = severity Critical or incident_severity major. Results are sorted by TVL descending, then by time since event ascending (most recent first).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
search_vaults
Search and filter DeFi vaults by chain, protocol, asset, risk tier, TVL, and more. Returns a paginated list with risk scores and APR.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'asset': {'type': 'string', 'description': 'Filter by asset symbol (e.g. USDC, WETH)'}, 'chain': {'type': 'string', 'description': 'Filter by chain name or slug (e.g. Ethereum, Base, Arbitrum, Solana)'}, 'limit': {'type': 'number', 'description': 'Max results (default 10, max 50)'}, 'query': {'type': 'string', 'description': 'Search by vault name, symbol, asset, protocol, or curator'}, 'minTvl': {'type': 'number', 'description': 'Minimum TVL in USD'}, 'sortBy': {'type': 'string', 'description': 'Sort field: tvl_usd, apr_net, name, last_synced_at'}, 'protocol': {'type': 'string', 'description': 'Filter by protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino. Aave V4 is protocol=aave plus protocolVersion=v4 (aave-v4 is accepted as an alias).'}, 'riskTier': {'type': 'string', 'description': 'Filter by risk tier: Prime, Core, or Edge'}, 'sortOrder': {'type': 'string', 'description': 'Sort order: asc or desc'}, 'depositable': {'type': 'boolean', 'description': 'Filter by current ability to accept new deposits. When true, vaults whose depositability is not yet indexed are still included; when false, only vaults whose maxDeposit on-chain is zero (caps reached, paused, or supply queue saturated) are returned.'}, 'protocolVersion': {'type': 'string', 'description': 'Filter by protocol generation: v3, v4, v3-lido, v3-horizon, klend, kvault. Required to isolate Aave V4 (protocol=aave, protocolVersion=v4). Vaults list this as protocol_version.'}}, 'additionalProperties': False}
History
Recent tool changes
Added
list_vaults_with_incidents
Sept. 17, 2026, 12:53 p.m.
Added
explain_risk_score
Sept. 17, 2026, 12:53 p.m.
Added
get_market_overview
Sept. 17, 2026, 12:53 p.m.
Added
get_curator_info
Sept. 17, 2026, 12:53 p.m.
Added
get_protocol_info
Sept. 17, 2026, 12:53 p.m.
Added
find_safest_vaults
Sept. 17, 2026, 12:53 p.m.
Added
compare_vaults
Sept. 17, 2026, 12:53 p.m.
Added
check_loop_venue
Sept. 17, 2026, 12:53 p.m.
Added
get_market_events
Sept. 17, 2026, 12:53 p.m.
Added
get_market
Sept. 17, 2026, 12:53 p.m.
Added
list_markets
Sept. 17, 2026, 12:53 p.m.
Added
get_vault_risk_breakdown
Sept. 17, 2026, 12:53 p.m.
Added
get_vault
Sept. 17, 2026, 12:53 p.m.
Added
search_vaults
Sept. 17, 2026, 12:53 p.m.
Discover
Similar MCP servers
DeltaSignal ATLAS-7
io.github.aitrailblazer/deltasignal-atlas-7
Analyzes SEC and XBRL data for crypto-related public companies, including fundamentals, issuer signals, peer comparisons, stress …
intel
io.chainhelix/intel
Provides multi-chain market intelligence, blockchain activity metrics, trading and portfolio planning, sanctions clearance, agent…
Market Intelligence API
com.marketintelligenceapi.api/market-intelligence
Analyzes crypto and tokenized-asset markets using DEX flows, perpetual positioning, smart-money activity, token risk, market news…
Gate MCP
io.github.gateio-dev/gate-mcp
Provides public Gate exchange market data for spot, futures, delivery, margin, options, Alpha, Earn products, order books, candle…
AgentFeed
io.github.seekdaseek/agentfeed
Provides crypto market data on liquidations, funding, open interest, order books, spreads, liquidation forecasts, and tokenized-a…
whale-insights
com.cryptowhaleinsights/whale-insights
Provides read-only crypto market and on-chain intelligence, including whale activity, analyst signals, prices, funding rates, gas…
Okx
io.github.pipeworx-io/okx
Provides public OKX market data for crypto instruments, including candles, prices, order books, funding rates, open interest, pos…
mcp
com.bykaranteli/mcp
Provides crypto derivatives and market-structure data including funding, open interest, liquidations, options, ETF flows, leverag…