---

Why Philidor?

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:

---

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

10 tools for vault discovery, risk analysis, and protocol research.

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, beefy, spark)
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. Lookup by id or by network + address.

Parameter	Type	Description
id	string	Vault ID (e.g. morpho-ethereum-0x...)
`netwo

... View full README on GitHub