Skip to main content
Glama
Philidor-Labs

Philidor MCP Server

by Philidor-Labs
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Philidor MCP Server

DeFi vault risk analytics for AI agents

MIT License MCP TypeScript Hosted

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)

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

{ "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

License

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Philidor-Labs/philidor-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server