MCP Quickstart

Add Philidor to Claude Desktop, Claude Code, Cursor, or Windsurf in under a minute.

Claude Code

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

Use Settings, then Connectors, then add a custom connector with this server URL.

https://mcp.philidor.io/api/mcp

For Desktop versions that still require local config, use an mcp-remote stdio bridge rather than a bare url entry.

{
  "mcpServers": {
    "philidor": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.philidor.io/api/mcp"]
    }
  }
}

Restart Claude Desktop after saving.

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

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

Add to your MCP configuration using serverUrl.

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

Once connected, try these prompts:

"What are the safest USDC vaults on Ethereum?"
"Check looping weETH against USDC on Aave V4 Ethereum Main"
"List the largest Aave V4 markets by supplied value"
"Compare the Gauntlet and Steakhouse USDC vaults on Morpho Ethereum"
"List Kamino K-Lend markets on Solana by supplied value"
"Find Prime-tier USDC vaults on Ethereum that still accept deposits, sorted by APR"
"What's the risk breakdown for vault 0x8eB67A509616cd6A7c1B3c8C21D48FF57df3d458 on Ethereum?"
"Give me a market overview of DeFi vault risk"

Aave V4 is protocol aave plus version v4, not a separate protocol id. Copy-paste workflows for looping, Morpho, Kamino, and Maple: Examples.

For testing with the stdio transport:

cd apps/mcp
PHILIDOR_API_URL=https://api.philidor.io pnpm dev:stdio

With MCP Inspector:

PHILIDOR_API_URL=https://api.philidor.io npx @modelcontextprotocol/inspector tsx src/stdio.ts