# Philidor DeFi Vault Risk Analytics [Health: Active] **Category:** πŸ’° Finance & Fintech **Repository:** https://github.com/Philidor-Labs/philidor-mcp **GitHub Stars:** 5 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/philidor-defi-vault-risk-analytics ## Description Search 700+ DeFi vaults, compare risk scores, analyze protocols. No API key needed. ## Tools Capabilities this server exposes over MCP: - **search_vaults** β€” Search and filter DeFi vaults by chain, protocol, asset, risk tier, TVL, and more. - **get_vault** β€” Get detailed information about a specific vault including risk breakdown, recent events, and historical snapshots. Lookup by `id` or by `network` + `address`. - **get_vault_risk_breakdown** β€” Detailed breakdown of a vault's three risk vectors with sub-metrics: asset quality, platform code maturity, and governance controls. Returns dimension-level scores, caps, hard-fail flags, and overrides. - **compare_vaults** β€” Side-by-side comparison of 2–3 vaults on TVL, APR, risk score, risk tier, and audit status. - **find_safest_vaults** β€” Find the top 10 audited, high-confidence vaults sorted by risk score. - **get_protocol_info** β€” Protocol details including TVL, vault count, versions, auditors, bug bounties, and security incidents. - **get_curator_info** β€” Curator details including managed vaults, TVL, chain distribution, and performance metrics. - **get_market_overview** β€” High-level DeFi vault market statistics: total TVL, vault count, risk distribution, and TVL by protocol. No parameters required. - **explain_risk_score** β€” Explain what a specific risk score means, including the tier, calculation method, and thresholds. - **list_vaults_with_incidents** β€” List all vaults that had a recent critical incident (last 365 days). Sorted by TVL descending, then by recency. No parameters required. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "philidor-defi-vault-risk-analytics": { "command": "npx", "args": ["-y","skills"] } } ``` ## Documentation & README
# Philidor MCP Server ### DeFi vault risk analytics for AI agents [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-Compatible-8A2BE2)](https://modelcontextprotocol.io) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org) [![Hosted](https://img.shields.io/badge/Hosted-mcp.philidor.io-green.svg)](https://mcp.philidor.io) [![smithery badge](https://smithery.ai/badge/philidor/defi)](https://smithery.ai/servers/philidor/defi) [![LobeHub](https://lobehub.com/badge/mcp/philidor-labs-philidor-mcp)](https://lobehub.com/mcp/philidor-labs-philidor-mcp) Search 700+ DeFi vaults across Morpho, Aave, Yearn, Beefy, and Spark. Compare risk scores, analyze protocols, run due diligence — all through natural language. **No API key required. No installation needed.** [Quick Start](#quick-start) • [Tools](#tools) • [Example Prompts](#example-prompts) • [Risk Framework](#risk-scoring) • [Agent Skill](#agent-skill)
--- ## Why Philidor? Most DeFi data tools give you raw numbers. Philidor gives your AI agent **institutional-grade risk intelligence**. | Feature | Philidor | DefiLlama MCP | Generic DeFi APIs | |---|:---:|:---:|:---:| | Vault risk scores (0–10) | :white_check_mark: | :x: | :x: | | Risk vector decomposition | :white_check_mark: | :x: | :x: | | Vault comparison | :white_check_mark: | :x: | :x: | | Curator intelligence | :white_check_mark: | :x: | :x: | | Protocol security history | :white_check_mark: | :x: | Partial | | Due diligence prompts | :white_check_mark: | :x: | :x: | | Portfolio risk assessment | :white_check_mark: | :x: | :x: | | No API key needed | :white_check_mark: | :white_check_mark: | Varies | | Hosted (zero install) | :white_check_mark: | :x: | :x: | --- ## Quick Start ### Remote Server (Recommended) Connect directly to the hosted server — zero installation, always up to date: ``` https://mcp.philidor.io/api/mcp ``` ### Claude Desktop Add to `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "philidor": { "url": "https://mcp.philidor.io/api/mcp" } } } ``` ### Claude Code ```bash claude mcp add philidor --transport http https://mcp.philidor.io/api/mcp ``` ### Cursor Add to `.cursor/mcp.json`: ```json { "mcpServers": { "philidor": { "url": "https://mcp.philidor.io/api/mcp" } } } ``` ### Windsurf Add to your MCP settings: ```json { "mcpServers": { "philidor": { "serverUrl": "https://mcp.philidor.io/api/mcp" } } } ``` ### Docker (stdio) ```bash docker run -i --rm ghcr.io/philidor-labs/philidor-mcp ``` ### Local (stdio) ```bash git clone https://github.com/Philidor-Labs/philidor-mcp.git cd philidor-mcp npm install npm start ``` --- ## Tools 10 tools for vault discovery, risk analysis, and protocol research. ### `search_vaults` Search and filter DeFi vaults by chain, protocol, asset, risk tier, TVL, and more. | Parameter | Type | Description | |---|---|---| | `query` | string | Search by vault name, symbol, asset, protocol, or curator | | `chain` | string | Filter by chain (Ethereum, Base, Arbitrum, ...) | | `protocol` | string | Filter by protocol ID (morpho, aave-v3, yearn-v3, beefy, spark) | | `asset` | string | Filter by asset symbol (USDC, WETH, ...) | | `riskTier` | string | Filter by risk tier: Prime, Core, or Edge | | `minTvl` | number | Minimum TVL in USD | | `sortBy` | string | Sort field: tvl_usd, apr_net, name | | `sortOrder` | string | Sort order: asc or desc | | `limit` | number | Max results (default 10, max 50) | ### `get_vault` Get detailed information about a specific vault including risk breakdown, recent events, and historical snapshots. Lookup by `id` or by `network` + `address`. | Parameter | Type | Description | |---|---|---| | `id` | string | Vault ID (e.g. `morpho-ethereum-0x...`) | | `network` | string | Network slug (ethereum, base, arbitrum) | | `address` | string | Vault contract address (0x...) | ### `get_vault_risk_breakdown` Detailed breakdown of a vault's three risk vectors with sub-metrics: asset quality, platform code maturity, and governance controls. Returns dimension-level scores, caps, hard-fail flags, and overrides. | Parameter | Type | Description | |---|---|---| | `network` | string | Network slug | | `address` | string | Vault contract address | ### `compare_vaults` Side-by-side comparison of 2–3 vaults on TVL, APR, risk score, risk tier, and audit status. | Parameter | Type | Description | |---|---|---| | `vaults` | array | Array of 2–3 objects with `network` and `address` | ### `find_safest_vaults` Find the top 10 audited, high-confidence vaults sorted by risk score. | Parameter | Type | Description | |---|---|---| | `asset` | string | Filter by asset symbol | | `chain` | string | Filter by chain name | | `minTvl` | number | Minimum TVL in USD | ### `get_protocol_info` Protocol details including TVL, vault count, versions, auditors, bug bounties, and security incidents. | Parameter | Type | Description | |---|---|---| | `protocolId` | string | Protocol ID (morpho, aave-v3, yearn-v3, beefy, spark) | ### `get_curator_info` Curator details including managed vaults, TVL, chain distribution, and performance metrics. | Parameter | Type | Description | |---|---|---| | `curatorId` | string | Curator ID | ### `get_market_overview` High-level DeFi vault market statistics: total TVL, vault count, risk distribution, and TVL by protocol. No parameters required. ### `explain_risk_score` Explain what a specific risk score means, including the tier, calculation method, and thresholds. | Parameter | Type | Description | |---|---|---| | `score` | number | Risk score (0–10) | ### `list_vaults_with_incidents` List all vaults that had a recent critical incident (last 365 days). Sorted by TVL descending, then by recency. No parameters required. --- ## Resources | URI | Description | |---|---| | `philidor://methodology` | The Vector Risk Framework v4.1 documentation | | `philidor://supported-chains` | Supported blockchain networks with vault counts | | `philidor://supported-protocols` | Supported DeFi protocols with TVL data | ## Prompts | Prompt | Description | |---|---| | `vault_due_diligence` | Comprehensive due diligence report for a vault | | `portfolio_risk_assessment` | Portfolio-level risk analysis across positions | | `defi_yield_comparison` | Yield comparison with risk-adjusted analysis | --- ## Example Prompts Once connected, try asking your AI assistant: **Discovery** > "Find the safest USDC vaults with at least $10M TVL" > "What Morpho vaults are available on Base?" > "Show me the DeFi market overview" **Analysis** > "Run due diligence on the Steakhouse USDC vault on Ethereum" > "Compare the top 3 USDC vaults by risk score" > "What's the risk breakdown for this vault: ethereum/0x..." **Portfolio** > "Assess my portfolio: 50% in Morpho Steakhouse USDC, 30% in Aave USDC, 20% in Yearn USDC" > "Which protocols have had security incidents?" > "What does a risk score of 8.5 mean?" --- ## Risk Scoring Philidor uses the **Vector Risk Framework v4.1** to decompose vault risk into three measurable vectors: ``` Final Score = 40% Asset + 40% Platform + 20% Governance ``` ### Asset Composition (40%) Quality of underlying collateral. Blue-chip assets (ETH, USDC) score highest. Factors include oracle reliability, liquidity depth, and peg stability. ### Platform Code (40%) Code maturity measured by: - **Lindy Score** — time-based safety (>2 years ≈ 9/10) - **Audit Density** — number and quality of audits - **Dependency Risk** — multiplicative penalties for risky dependencies - **Incident Penalty** — caps score after security incidents ### Governance (20%) Exit window for users: | Control | Score | |---|---| | Immutable contract | 10/10 | | 7+ day timelock | 9/10 | | No timelock | 1/10 | ### Risk Tiers | Tier | Score | Meaning | |---|---|---| | **Prime** | 8.0–10.0 | Institutional-grade — mature code, multiple audits, safe governance | | **Core** | 5.0–7.9 | Moderate safety — audited but newer or flexible governance | | **Edge** | 0.0–4.9 | Higher risk — requires careful due diligence | --- ## Architecture ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Claude / Cursor │────▢│ Philidor MCP │────▢│ Philidor API β”‚ β”‚ Windsurf / etc. │◀────│ Server │◀────│ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ 10 tools, 3 resources, β”‚ 3 prompts β”‚ β”Œβ”€β”€β”€β”€β–Όβ”€β”€β”€β”€β” β”‚ On-chain β”‚ β”‚ data β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ``` - **Transport**: Streamable HTTP (remote) or stdio (local/Docker) - **API**: Calls the [Philidor Public API](https://api.philidor.io/v1/docs) — no API key needed - **Stateless**: Fresh server instance per request, no session state - **Data**: 700+ vaults across Ethereum, Base, Arbitrum, Polygon, Optimism, and Avalanche --- ## Agent Skill Install the Philidor MCP skill into your coding agent via [skills.sh](https://skills.sh): ```bash npx skills add philidor-labs/philidor-mcp ``` This gives your agent full knowledge of all tools, resources, prompts, recommended workflows, and best practices for DeFi vault analysis. ### Also Available | Interface | Description | Link | |---|---|---| | **CLI** | Terminal-based vault intelligence — scriptable, pipeable, agent-sandboxed | [philidor-cli](https://github.com/Philidor-Labs/philidor-cli) | | **OpenClaw Skill** | Skill definition for the OpenClaw agent platform | [npm](https://www.npmjs.com/package/@philidorlabs/openclaw-skill) | --- ## Supported Protocols Morpho, Aave v3, Yearn v3, Beefy, Spark — with more being added regularly. See the full list at [app.philidor.io](https://app.philidor.io). --- ## Development ```bash git clone https://github.com/Philidor-Labs/philidor-mcp.git cd philidor-mcp npm install npm start ``` The server connects to the public Philidor API by default. To use a custom endpoint: ```bash PHILIDOR_API_URL=http://localhost:3003 npm start ``` --- ## Links - [Philidor Analytics](https://app.philidor.io) — explore vaults and risk scores - [Philidor CLI](https://github.com/Philidor-Labs/philidor-cli) — terminal-based vault intelligence - [API Documentation](https://api.philidor.io/v1/docs) — OpenAPI/Swagger docs - [Risk Methodology](https://app.philidor.io/methodology) — how scores are calculated - [Smithery](https://smithery.ai/servers/philidor/defi) — MCP server registry - [Twitter](https://twitter.com/philidorlabs) — updates and announcements ## License [MIT](https://github.com/Philidor-Labs/philidor-mcp/blob/HEAD/LICENSE)