Philidor MCP Server

DeFi vault risk analytics for AI agents

Search 700+ vaults across Morpho, Aave, Yearn, Beefy, Spark, and more. Compare risk scores, analyze protocols, run due diligence — all through natural language.

No API key required. No installation needed.

Quick Start • Tools • Example Prompts • Risk Framework

Why Philidor?

Most DeFi data tools give you raw numbers. Philidor gives your AI agent risk intelligence.

Feature	Philidor	DefiLlama MCP	Generic DeFi APIs
Vault risk scores (0-10)	✅	❌	❌
Risk vector decomposition	✅	❌	❌
Vault comparison	✅	❌	❌
Curator intelligence	✅	❌	❌
Protocol security history	✅	❌	Partial
Due diligence prompts	✅	❌	❌
Portfolio risk assessment	✅	❌	❌
No API key needed	✅	✅	Varies
Hosted (zero install)	✅	❌	❌

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:

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Claude Code

claude mcp add philidor --transport http https://mcp.philidor.io/api/mcp

Cursor

Add to your MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "philidor": {
      "url": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "philidor": {
      "serverUrl": "https://mcp.philidor.io/api/mcp"
    }
  }
}

Docker (stdio)

docker run -i --rm ghcr.io/philidor-labs/philidor-mcp

Local (stdio)

git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start

Tools

`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, ...)
`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.

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.

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 vaults with the highest risk scores, optionally filtered by asset, chain, or TVL.

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)

Resources

URI	Description
`philidor://methodology`	The Vector Risk Framework v2.0 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 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 10/10. Less liquid collateral scores lower.

Platform Code (40%)

Code maturity measured by:

Lindy Score — time-based safety (>2 years = ~9/10)
Audit Density — number and type of audits
Dependency Risk — multiplicative penalties for risky dependencies
Incident Penalty — caps score after security incidents

Governance (20%)

Exit window for users:

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         │◀────│              │
└──────────────────┘     └─────────────────┘     └──────┬───────┘
                          9 tools, 3 resources,          │
                          3 prompts                      │
                                                   ┌────▼────┐
                                                   │ On-chain │
                                                   │  data    │
                                                   └─────────┘

Transport: Streamable HTTP (remote) or stdio (local/Docker)
API: Calls the Philidor Public API — no API key needed
Stateless: Fresh server instance per request, no session state
Data: 700+ vaults across Ethereum, Base, Polygon, Gnosis, and more

Supported Protocols

Morpho, Aave v3, Yearn v3, Beefy, Spark, Fluid, Euler — with more being added regularly.

See the full list at app.philidor.io.

Development

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 API endpoint:

PHILIDOR_API_URL=http://localhost:3003 npm start

Links

Philidor Analytics — explore vaults and risk scores
API Documentation — OpenAPI/Swagger docs
Risk Methodology — how scores are calculated
Twitter — updates and announcements

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
bin		bin
src		src
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
MARKETING.md		MARKETING.md
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
server.json		server.json
smithery.yaml		smithery.yaml
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

Philidor MCP Server

DeFi vault risk analytics for AI agents

Why Philidor?

Quick Start

Remote Server (Recommended)

Claude Desktop

Claude Code

Cursor

Windsurf

Docker (stdio)

Local (stdio)

Tools

search_vaults

get_vault

get_vault_risk_breakdown

compare_vaults

find_safest_vaults

get_protocol_info

get_curator_info

get_market_overview

explain_risk_score

Resources

Prompts

Example Prompts

Risk Scoring

Asset Composition (40%)

Platform Code (40%)

Governance (20%)

Risk Tiers

Architecture

Supported Protocols

Development

Links

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`search_vaults`

`get_vault`

`get_vault_risk_breakdown`

`compare_vaults`

`find_safest_vaults`

`get_protocol_info`

`get_curator_info`

`get_market_overview`

`explain_risk_score`

Packages