Philidor MCP

by Philidor-Labs

374 downloads

Not rated

GitHub

About

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.

Details

Author: Philidor-Labs
Downloads: 374
Categories: Other, Finance, AI

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Philidor MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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

`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 Code, and Governance scores with sub-metrics.

`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 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_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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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 </div> ---

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

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 your MCP settings (

.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

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 &mdash; time-based safety (>2 years = ~9/10)
- Audit Density &mdash; number and type of audits
- Dependency Risk &mdash; multiplicative penalties for risky dependencies
- Incident Penalty &mdash; 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 &mdash; mature code, multiple audits, safe governance |
| Core | 5.0 - 7.9 | Moderate safety &mdash; audited but newer or flexible governance |
| Edge | 0.0 - 4.9 | Higher risk &mdash; 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 &mdash; 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 &mdash; with more being added regularly.

See the full list at 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 API endpoint:

bash
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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

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

Claude Desktop / Cursor

McpServers

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

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

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