Philidor MCP

Name: Philidor MCP
Author: Philidor-Labs

@Philidor-Labs

Repository

About Philidor MCP

DeFi vault risk analytics for AI agents

#defi #vaults #risk-analytics #ai #ai-agents #defi-vaults

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "philidor-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/philidor-labs/philidor-mcp"
      ]
    }
  }
}

Tools

Search and filter DeFi vaults by chain, protocol, asset, risk tier, TVL, and more. Returns a paginated list with risk scores and APR.

Get detailed information about a specific DeFi vault including risk breakdown, recent events, and historical snapshots. Lookup by ID or by network + address.

Get a detailed breakdown of a vault's risk vectors: Asset Composition, Platform Code, and Governance scores with sub-metrics.

Compare 2-3 DeFi vaults side-by-side on TVL, APR, risk score, risk tier, audited status, and more.

Find the safest (highest risk-scored) DeFi vaults, optionally filtered by asset, chain, or minimum TVL. Returns top 10 audited, high-confidence vaults sorted by risk score.

Get detailed information about a DeFi protocol including TVL, vault count, versions, auditors, and security incidents.

Get detailed information about a vault curator including their managed vaults, TVL, chain distribution, and performance.

Get a high-level overview of the DeFi vault market: total TVL, vault count, risk distribution, and TVL by protocol.

Explain what a Philidor risk score means, including the tier (Prime/Core/Edge), how it is calculated, and what the thresholds are.

Overview

What is Philidor MCP?

Philidor MCP is a Model Context Protocol server that provides DeFi vault risk analytics for AI agents. It lets you search 700+ vaults across protocols like Morpho, Aave, Yearn, and Beefy, compare risk scores, analyze protocols, and run due diligence through natural language—with no API key required.

How to use Philidor MCP?

Connect AI assistants like Claude or Cursor to the hosted server at https://mcp.philidor.io/api/mcp. Alternatively, run the server locally via Docker (docker run -i --rm ghcr.io/philidor-labs/philidor-mcp) or from source (npm install && npm start). Add the server URL to your MCP client configuration (e.g., Claude Desktop, Claude Code, Cursor, or Windsurf).

Key features of Philidor MCP

Search and filter 700+ DeFi vaults by chain, protocol, asset, and risk tier
Retrieve detailed vault risk breakdowns (asset quality, platform code, governance)
Compare 2–3 vaults side-by-side on TVL, APR, risk score, and audits
Find the top 10 safest audited vaults with highest risk scores
Get protocol and curator intelligence including security history
Access three built-in prompts for due diligence, portfolio risk, and yield comparison
Hosted server with zero installation; also supports local and Docker deployments

Use cases of Philidor MCP

Discover the safest USDC vaults with at least $10M TVL for investment decisions
Run comprehensive due diligence on a specific vault before depositing funds
Assess portfolio risk across multiple DeFi positions in natural language
Compare top vaults by risk score and APY to optimize yield strategies
Identify protocols with security incidents and evaluate platform maturity

FAQ from Philidor MCP

How is risk scored?

Philidor uses the Vector Risk Framework: 40% asset quality, 40% platform code maturity, and 20% governance controls. Final scores range 0–10, categorized as Prime (8.0–10.0), Core (5.0–7.9), or Edge (0–4.9).

Do I need an API key?

No. The hosted server and the Philidor Public API require no API key. You can connect immediately using the provided URL.

Which protocols and chains are supported?

Supported protocols include Morpho, Aave v3, Yearn v3, Beefy, Spark, Fluid, and Euler. Supported chains include Ethereum, Base, Polygon, Gnosis, Arbitrum, and more.

Where does the data come from?

Data is fetched from the Philidor Public API, which aggregates on-chain data. The server is stateless—each request pulls fresh data with no session state.

Can I run the server locally?

Yes. Use Docker (docker run -i --rm ghcr.io/philidor-labs/philidor-mcp) or clone the repo, run npm install && npm start. You can point to a custom API endpoint via the PHILIDOR_API_URL environment variable.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K