
MCP server for DeFi vault risk analytics. Search 700+ vaults, compare risk scores, analyze
MCP server for DeFi vault risk analytics. Search 700+ vaults, compare risk scores, analyze protocols. No API key needed.
·
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 • Cursor Plugin • Tools • Example Prompts • Risk Framework • Agent Skill
Philidor never accepts keys. Never send private keys, session keys, seeds, or mnemonics to any Philidor API or MCP input. Inputs carrying key material receive a structured refusal before tool, prompt, or resource handlers run. The API and MCP return data only; they do not build, sign, or broadcast transactions. Keys and execution stay in the client-side SDK.
A 32-byte pool identifier and a private key can have the same shape. Documented identifier fields still accept exact identifiers; never paste a key into them.
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: |
Connect directly to the hosted server — zero installation, always up to date:
https://mcp.philidor.io/api/mcpAdd to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"philidor": {
"url": "https://mcp.philidor.io/api/mcp"
}
}
}claude mcp add philidor --transport http https://mcp.philidor.io/api/mcpAdd to .cursor/mcp.json:
{
"mcpServers": {
"philidor": {
"url": "https://mcp.philidor.io/api/mcp"
}
}
}Add to your MCP settings:
{
"mcpServers": {
"philidor": {
"serverUrl": "https://mcp.philidor.io/api/mcp"
}
}
}docker run -i --rm ghcr.io/philidor-labs/philidor-mcpgit clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start15 standalone tools for vault discovery, risk analysis, lending markets, loop venue checks, policy attestations, and protocol research.
check_policyCheck positions against your own limits and constraints. Returns the API's compliance attestation: compliance, violations, policy_hash, findings, and snapshotId. With issue: true, an issued attestation also includes attestation_id, signerAddress, and verification_url (GET /v1/graph/attestation/{id}/verify). No risk figures are recalculated. Missing, malformed, or partial responses produce an error. The legacy verdict appears only as deprecated_verdict; use compliance.
| Parameter | Type | Description |
|---|---|---|
positions | array | 1–100 { vaultKey, amountUsd } rows; key is {chainId}:{lowercase 0x address}, amount is finite and positive. EVM graph coverage only. |
limits | object | Caller-defined fractions in (0, 1]: maxSharePerCurator, maxSharePerProtocol, maxSharePerChain, maxSharePerAsset, maxSharePerOracle, maxSharePerOracleVendor, maxSharePerCluster, maxSharePerBridge, maxSharePerSignerSet. Required; {} sets no caps. |
constraints | object | Optional minTier (Prime, Core, Edge), allowlist/blacklist (up to 1000 vault keys each), requireDepositStatus/requireWithdrawStatus (open), maxFreshnessSeconds (integer 0–31622400). Blacklist wins. |
issue | boolean | Optional, defaults to false. Ask the API to issue a compliance attestation. |
agentId | string | Optional caller reference, 1–200 characters. |
For local stdio/Docker, set PHILIDOR_API_KEY in the server process environment to your Philidor API credential. Keep it out of tool arguments, chat, and source control. This is not a wallet key. Without an eligible key the tool returns a structured refusal with the API's required plan, x402 price (when available), and upgrade link. It does not pay automatically. The hosted plugin uses its own documented client authentication.
No Philidor policy is preselected. This reports conformity with your policy; it does not recommend a vault. Philidor does not prepare transactions and never accepts wallet keys. Execution stays in the client-side SDK.
search_vaultsSearch 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 name or slug (Ethereum, Base, Solana, ...) |
protocol | string | Protocol ID: aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino |
protocolVersion | string | Generation filter (v3, v4, ...); use with protocol=aave for Aave V4 |
asset | string | Filter by asset symbol (USDC, WETH, ...) |
riskTier | string | Filter by risk tier: Prime, Core, or Edge |
minTvl | number | Minimum TVL in USD |
depositable | boolean | Filter by current deposit capacity |
sortBy | string | Sort field: tvl_usd, apr_net, name, last_synced_at |
sortOrder | string | Sort order: asc or desc |
limit | number | Max results (default 10, max 50) |
get_vaultGet 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-1-0x...) |
network | string | Network slug (ethereum, base, arbitrum, solana) |
address | string | Vault address (0x hex or Solana base58) |
get_vault_risk_breakdownDetailed breakdown of a vault's four risk vectors: Asset Composition, Platform and Strategy, Control and Governance, and History.
| Parameter | Type | Description |
|---|---|---|
network | string | Network slug |
address | string | Vault address |
list_marketsList lending markets (Aave/Spark pools, Aave V4 spokes, Compound Comet, Morpho Blue pairs, Kamino K-Lend). Aave V4 spokes that share a liquidity hub are grouped under composed hub parents (e.g. aave-v4-1-hub-core).
| Parameter | Type | Description |
|---|---|---|
protocol | string | aave, spark, compound, morpho, kamino |
version | string | v3, v4, or klend |
chain | number/string | Chain id or slug |
limit | number | 1–100 (default 20) |
sortBy | string | total_supplied_usd, total_borrowed_usd, reserve_count, name |
get_marketOne market with every reserve (supplied, supply APR, borrowed, borrow APR, utilization, tier). Accepts spoke ids and composed hub ids.
| Parameter | Type | Description |
|---|---|---|
marketId | string | Market id from list_markets |
get_market_eventsPublished risk events for one lending market. Hub ids union spoke feeds.
| Parameter | Type | Description |
|---|---|---|
marketId | string | Market id from list_markets |
limit | number | 1–100 (default 20) |
check_loop_venueUnderwrite a collateral/debt loop on one market: score, tier, utilization, borrow APR, deposit status, and recent incidents for both legs. Does not compute health factor and does not prepare transactions.
| Parameter | Type | Description |
|---|---|---|
marketId | string | Market id from list_markets |
collateral | string | Collateral asset symbol |
debt | string | Debt asset symbol |
compare_vaultsSide-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_vaultsFind the top 10 audited vaults sorted by Philidor risk score (higher = lower assessed risk; not a safety guarantee).
| Parameter | Type | Description |
|---|---|---|
asset | string | Filter by asset symbol |
chain | string | Filter by chain name |
minTvl | number | Minimum TVL in USD |
get_protocol_infoProtocol details including TVL, vault count, versions, auditors, bug bounties, and security incidents.
| Parameter | Type | Description |
|---|---|---|
protocolId | string | Protocol ID (aave, morpho, spark, compound, yearn, beefy, uniswap, nest, maple, kamino) |
get_curator_infoCurator details including managed vaults, TVL, chain distribution, and performance metrics.
| Parameter | Type | Description |
|---|---|---|
curatorId | string | Curator ID |
get_market_overviewHigh-level DeFi vault market statistics: total TVL, vault count, risk distribution, and TVL by protocol. No parameters required.
explain_risk_scoreExplain 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_incidentsList all vaults that had a recent critical incident (last 365 days). Sorted by TVL descending, then by recency. No parameters required.
| 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 |
| 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 |
review_loop_venue | Loop venue review, then hand off to a protocol MCP |
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?"
Philidor uses the Vector Risk Framework v4.1 to decompose vault risk into three measurable vectors:
Final Score = 40% Asset + 40% Platform + 20% GovernanceQuality of underlying collateral. Blue-chip assets (ETH, USDC) score highest. Factors include oracle reliability, liquidity depth, and peg stability.
Code maturity measured by:
Exit window for users:
| Control | Score |
|---|---|
| Immutable contract | 10/10 |
| 7+ day timelock | 9/10 |
| No timelock | 1/10 |
| 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 |
┌──────────────────┐ ┌─────────────────┐ ┌──────────────┐
│ Claude / Cursor │────▶│ Philidor MCP │────▶│ Philidor API │
│ Windsurf / etc. │◀────│ Server │◀────│ │
└──────────────────┘ └─────────────────┘ └──────┬───────┘
15 tools, 3 resources, │
4 prompts │
┌────▼────┐
│ On-chain │
│ data │
└─────────┘This repository packages a Cursor plugin that connects the agent to the hosted Philidor MCP server and loads five workflow skills. The plugin does not embed an API key. Philidor stays read-only: it scores vaults and lending venues, and it does not compute a health factor or prepare a transaction.
The plugin points at the hosted server, which is ahead of the stdio server in this repo:
https://mcp.philidor.io/api/mcpTransport is Streamable HTTP. The hosted server has additional tools beyond this standalone client; use tools/list to discover the current surface. src/server.ts registers 15 standalone tools, 3 resources (philidor://methodology, philidor://supported-chains, philidor://supported-protocols), and 4 prompts (vault_due_diligence, portfolio_risk_assessment, defi_yield_comparison, review_loop_venue).
| Piece | Path |
|---|---|
| Manifest | .cursor-plugin/plugin.json |
| Marketplace index | .cursor-plugin/marketplace.json (one plugin, source .) |
| MCP connector | mcp.json |
| Logo | assets/logo.svg (primary pawn mark from philidor.io/brand-assets) |
| Skills | skills/vault-due-diligence, skills/pre-deposit-safety-check, skills/risk-adjusted-yield, skills/market-incident-monitoring, skills/philidor-api-handoff |
Product page: philidor.io/mcp. Docs: MCP server, quickstart, tools, resources, prompts.
After the plugin is listed, open Customize in Cursor, find Philidor, and choose Install (project or user scope). That loads the skills and the hosted MCP server together.
Until then, connect the same server without the plugin by adding this to .cursor/mcp.json:
{
"mcpServers": {
"philidor": {
"url": "https://mcp.philidor.io/api/mcp"
}
}
}To try the plugin from a local checkout, copy this repo to ~/.cursor/plugins/local/philidor (the folder must contain .cursor-plugin/plugin.json), then run Developer: Reload Window and confirm the skills and MCP server under Customize. Local plugin imports have to be allowed. A marketplace plugin with the same name takes precedence over the local copy.
Skills tell the agent to copy vault ids, network slugs, addresses, and market ids from tool results, and not to invent risk numbers. Loop checks call check_loop_venue, then stop. Health factor and unsigned transactions belong to the protocol MCP (Aave is https://mcp.aave.com). Baskets, oracle vectors, enriched assets, the event stream, and Risk Graph look-through are outside the free MCP. The philidor-api-handoff skill sends those questions to API Access and Plans and pricing without quoting a price.
Do not submit from this fork until a reviewer accepts the pull request. Listing is a manual review at cursor.com/marketplace/publish. The repository must be public. Cursor reviews the open-source tree and each later update.
.cursor-plugin/plugin.json parses and matches the plugin schema (name philidor, lowercase kebab-case)description states that the plugin is read-only vault and market risk analyticsmcp.json is the only MCP connector and has no auth headerSKILL.md whose name matches the folder and whose description says when to use itassets/logo.svg is committed and logo is the relative path assets/logo.svgskills/..., ./mcp.json). No .., no absolute paths${VAR} placeholders, so variables stays unsetinitialize and tools/list against https://mcp.philidor.io/api/mcp still succeed~/.cursor/plugins/local/philidor (Customize shows 5 skills and the Philidor MCP server).cursor-plugin/marketplace.json with source "."Install the Philidor MCP skill into your coding agent via skills.sh:
npx skills add philidor-labs/philidor-mcpThis gives your agent full knowledge of all tools, resources, prompts, recommended workflows, and best practices for DeFi vault analysis.
| Interface | Description | Link |
|---|---|---|
| CLI | Terminal-based vault intelligence — scriptable, pipeable, agent-sandboxed | philidor-cli |
| OpenClaw Skill | Skill definition for the OpenClaw agent platform | npm |
Morpho, Aave (v3/v4), Spark, Compound, Yearn, Beefy, Uniswap, Nest, Maple, Kamino — with more being added regularly.
See the full list at app.philidor.io.
git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm startThe server connects to the public Philidor API by default. To use a custom endpoint:
PHILIDOR_API_URL=http://localhost:3003 npm startPick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add philidor --transport http https://mcp.philidor.io/api/mcp{
"mcpServers": {
"philidor": {
"url": "https://mcp.philidor.io/api/mcp"
}
}
}code --add-mcp '{"name":"philidor","url":"https://mcp.philidor.io/api/mcp"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/philidor-mcp-server to learn what the "Philidor MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add philidor --transport http https://mcp.philidor.io/api/mcpdocker run -i --rm ghcr.io/philidor-labs/philidor-mcpnpx skills add philidor-labs/philidor-mcp| Name | What it does |
|---|---|
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. |
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. |
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. |
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 g |
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 paren |
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. |
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 prepa |
list_ondo_assets | Search the paginated Ondo Global Markets catalog: tokenized securities, portfolios and exact issuer-reported deployments. Includes API-only and CSV-only entries, freshness and identity conflicts. This |
get_ondo_asset | Get an exact Ondo token: issuer market observations, portfolio constituents, source freshness and chain/address assessment links. Prices are display-only; constituents have no inferred weights or inhe |
get_ondo_asset_stream | Get latest retained Ondo display prices and minute OHLC. Preserve source/receipt ages, evaluatedAt, conflicts and collector gaps; fresh is a 120-second policy at evaluatedAt, not an execution guarante |
get_ondo_asset_data | Get Ondo OHLC, dividends, shares-multiplier history and per-chain token supply. Family availability and source clocks are explicit. Valid windows: 1min/1day, 5min/1day, 15min/1day, 1hour/1month, 4hour |
get_native_asset_assessment | Get the current effective score and signed reviewed base score for an exact Aptos, Sui, Noble, Stellar or XRP Ledger token. Preserve identifier case. A missing assessment is not a zero score. Evidence |
get_native_asset_financials | Get public issuer financials for an exact Aptos, Sui, Noble, Stellar or XRP Ledger token. Preserve identifier case. Each metric states its unit, fund/global/deployment scope, source and freshness; nul |
compare_vaults | Compare 2-3 DeFi vaults side-by-side on TVL, APR, risk score, risk tier, audited status, and more. |
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 |
get_protocol_info | Get detailed information about a DeFi protocol including TVL, vault count, versions, auditors, and security incidents. |
get_curator_info | Get detailed information about a vault curator including their managed vaults, TVL, chain distribution, and performance. |
get_market_overview | Get a high-level overview of the DeFi vault market: total TVL, vault count, risk distribution, and TVL by protocol. |
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. |
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 ( |
check_policy | State whether the positions you supply conform to the limits and constraints you supply. Calls POST /v1/graph/check and returns the API compliance attestation (attestation de conformité): compliance ( |
list_baskets | Returns the structured access refusal for the baskets family. Does not return constituents or weights. |
list_rwa | Returns the structured access refusal for the rwa family. Does not return coverage. |
get_oracles | Returns the structured access refusal for the oracles family. Does not return freshness. |
| Name | What it does |
|---|---|
vault_due_diligence | Generate a comprehensive due diligence report for a specific DeFi vault. |
portfolio_risk_assessment | Analyze portfolio-level risk across multiple vault positions. |
defi_yield_comparison | Compare DeFi yield opportunities across vaults, filtered by asset, chain, or risk tier. |
review_loop_venue | Review a collateral/debt loop on one Philidor market, then hand off to a protocol MCP for wallet health factor and unsigned txs. |
| Name | What it does |
|---|---|
methodology | The Vector Risk Framework methodology used by Philidor to score DeFi vault risk. |
supported-chains | List of blockchain networks supported by Philidor with vault counts and TVL. |
supported-protocols | List of DeFi protocols tracked by Philidor with vault counts and TVL. |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/philidor-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "philidor-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.