Philidor MCP
Análise de risco de vaults DeFi para agentes de IA. Pesquise mais de 700 vaults em Morpho, Aave, Yearn, Beefy, Spark e outros. Compare pontuações de risco, analise protocolos, realize due diligence — tudo por meio de linguagem natural. Sem necessidade de chave de API. Sem necessidade de instalação.
Documentação
Servidor Philidor MCP
Análise de risco de vaults DeFi para agentes de IA
Pesquise mais de 700 vaults DeFi em Morpho, Aave, Yearn, Beefy e Spark. Compare pontuações de risco, analise protocolos, realize due diligence — tudo por meio de linguagem natural.
Nenhuma chave de API necessária. Nenhuma instalação necessária.
Início Rápido • Ferramentas • Exemplos de Prompts • Estrutura de Risco • Habilidade do Agente
Por que Philidor?
A maioria das ferramentas de dados DeFi fornece números brutos. Philidor dá ao seu agente de IA inteligência de risco de nível institucional.
| Recurso | Philidor | DefiLlama MCP | APIs DeFi Genéricas |
|---|---|---|---|
| Pontuações de risco de vault (0–10) | :white_check_mark: | :x: | :x: |
| Decomposição de vetores de risco | :white_check_mark: | :x: | :x: |
| Comparação de vaults | :white_check_mark: | :x: | :x: |
| Inteligência de curadores | :white_check_mark: | :x: | :x: |
| Histórico de segurança de protocolos | :white_check_mark: | :x: | Parcial |
| Prompts de due diligence | :white_check_mark: | :x: | :x: |
| Avaliação de risco de portfólio | :white_check_mark: | :x: | :x: |
| Sem necessidade de chave de API | :white_check_mark: | :white_check_mark: | Varia |
| Hospedado (zero instalação) | :white_check_mark: | :x: | :x: |
Início Rápido
Servidor Remoto (Recomendado)
Conecte-se diretamente ao servidor hospedado — zero instalação, sempre atualizado:
https://mcp.philidor.io/api/mcp
Claude Desktop
Adicione ao ~/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
Adicione ao .cursor/mcp.json:
{
"mcpServers": {
"philidor": {
"url": "https://mcp.philidor.io/api/mcp"
}
}
}
Windsurf
Adicione às suas configurações de MCP:
{
"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
Ferramentas
10 ferramentas para descoberta de vaults, análise de risco e pesquisa de protocolos.
search_vaults
Pesquise e filtre vaults DeFi por rede, protocolo, ativo, nível de risco, TVL e mais.
| Parâmetro | Tipo | Descrição |
|---|---|---|
query | string | Pesquise por nome do vault, símbolo, ativo, protocolo ou curador |
chain | string | Filtre por rede (Ethereum, Base, Arbitrum, ...) |
protocol | string | Filtre por ID do protocolo (morpho, aave-v3, yearn-v3, beefy, spark) |
asset | string | Filtre por símbolo do ativo (USDC, WETH, ...) |
riskTier | string | Filtre por nível de risco: Prime, Core ou Edge |
minTvl | number | TVL mínimo em USD |
sortBy | string | Campo de ordenação: tvl_usd, apr_net, name |
sortOrder | string | Ordem de classificação: asc ou desc |
limit | number | Máximo de resultados (padrão 10, máximo 50) |
get_vault
Obtenha informações detalhadas sobre um vault específico, incluindo detalhamento de risco, eventos recentes e snapshots históricos. Consulta por id ou por network + address.
| Parâmetro | Tipo | Descrição |
|---|---|---|
id | string | ID do vault (ex.: morpho-ethereum-0x...) |
network | string | Slug da rede (ethereum, base, arbitrum) |
address | string | Endereço do contrato do vault (0x...) |
get_vault_risk_breakdown
Detalhamento dos três vetores de risco de um vault com sub-métricas: qualidade do ativo, maturidade do código da plataforma e controles de governança. Retorna pontuações por dimensão, limites, flags de falha crítica e overrides.
| Parâmetro | Tipo | Descrição |
|---|---|---|
network | string | Slug da rede |
address | string | Endereço do contrato do vault |
compare_vaults
Comparação lado a lado de 2–3 vaults em TVL, APR, pontuação de risco, nível de risco e status de auditoria.
| Parâmetro | Tipo | Descrição |
|---|---|---|
vaults | array | Array de 2–3 objetos com network e address |
find_safest_vaults
Encontre os 10 principais vaults auditados e de alta confiança, ordenados por pontuação de risco.
| Parâmetro | Tipo | Descrição |
|---|---|---|
asset | string | Filtre por símbolo do ativo |
chain | string | Filtre por nome da rede |
minTvl | number | TVL mínimo em USD |
get_protocol_info
Detalhes do protocolo, incluindo TVL, número de vaults, versões, auditores, recompensas por bugs e incidentes de segurança.
| Parâmetro | Tipo | Descrição |
|---|---|---|
protocolId | string | ID do protocolo (morpho, aave-v3, yearn-v3, beefy, spark) |
get_curator_info
Detalhes do curador, incluindo vaults gerenciados, TVL, distribuição por rede e métricas de desempenho.
| Parâmetro | Tipo | Descrição |
|---|---|---|
curatorId | string | ID do curador |
get_market_overview
Estatísticas de alto nível do mercado de vaults DeFi: TVL total, número de vaults, distribuição de risco e TVL por protocolo. Nenhum parâmetro necessário.
explain_risk_score
Explique o que uma pontuação de risco específica significa, incluindo o nível, o método de cálculo e os limites.
| Parâmetro | Tipo | Descrição |
|---|---|---|
score | number | Pontuação de risco (0–10) |
list_vaults_with_incidents
Liste todos os vaults que tiveram um incidente crítico recente (últimos 365 dias). Ordenado por TVL decrescente e depois por recência. Nenhum parâmetro necessário.
Recursos
| URI | Descrição |
|---|---|
philidor://methodology | Documentação do Vector Risk Framework v4.1 |
philidor://supported-chains | Redes blockchain suportadas com contagens de vaults |
philidor://supported-protocols | Protocolos DeFi suportados com dados de TVL |
Prompts
| Prompt | Descrição |
|---|---|
vault_due_diligence | Relatório abrangente de due diligence para um vault |
portfolio_risk_assessment | Análise de risco em nível de portfólio entre posições |
defi_yield_comparison | Comparação de rendimento com análise ajustada ao risco |
Exemplos de Prompts
Depois de conectado, tente perguntar ao seu assistente de IA:
Descoberta
"Encontre os vaults USDC mais seguros com pelo menos US$ 10 milhões em TVL"
"Quais vaults Morpho estão disponíveis na Base?"
"Mostre-me a visão geral do mercado DeFi"
Análise
"Faça due diligence no vault Steakhouse USDC na Ethereum"
"Compare os 3 principais vaults USDC por pontuação de risco"
"Qual é o detalhamento de risco deste vault: ethereum/0x..."
Portfólio
"Avalie meu portfólio: 50% em Morpho Steakhouse USDC, 30% em Aave USDC, 20% em Yearn USDC"
"Quais protocolos tiveram incidentes de segurança?"
"O que significa uma pontuação de risco de 8,5?"
Pontuação de Risco
Philidor usa o Vector Risk Framework v4.1 para decompor o risco de vaults em três vetores mensuráveis:
Final Score = 40% Asset + 40% Platform + 20% Governance
Composição do Ativo (40%)
Qualidade da garantia subjacente. Ativos blue-chip (ETH, USDC) pontuam mais alto. Os fatores incluem confiabilidade do oráculo, profundidade de liquidez e estabilidade da paridade.
Código da Plataforma (40%)
Maturidade do código medida por:
- Pontuação Lindy — segurança baseada no tempo (>2 anos ≈ 9/10)
- Densidade de Auditoria — número e qualidade das auditorias
- Risco de Dependências — penalidades multiplicativas para dependências arriscadas
- Penalidade por Incidentes — limita a pontuação após incidentes de segurança
Governança (20%)
Janela de saída para usuários:
| Controle | Pontuação |
|---|---|
| Contrato imutável | 10/10 |
| Timelock de 7+ dias | 9/10 |
| Sem timelock | 1/10 |
Níveis de Risco
| Nível | Pontuação | Significado |
|---|---|---|
| Prime | 8,0–10,0 | Nível institucional — código maduro, múltiplas auditorias, governança segura |
| Core | 5,0–7,9 | Segurança moderada — auditado, mas mais novo ou com governança flexível |
| Edge | 0,0–4,9 | Risco mais alto — requer due diligence cuidadosa |
Arquitetura
┌──────────────────┐ ┌─────────────────┐ ┌──────────────┐
│ Claude / Cursor │────▶│ Philidor MCP │────▶│ Philidor API │
│ Windsurf / etc. │◀────│ Server │◀────│ │
└──────────────────┘ └─────────────────┘ └──────┬───────┘
10 tools, 3 resources, │
3 prompts │
┌────▼────┐
│ On-chain │
│ data │
└─────────┘
- Transporte: HTTP transmissível (remoto) ou stdio (local/Docker)
- API: Chama a API Pública Philidor — sem necessidade de chave de API
- Sem estado: Instância de servidor nova por solicitação, sem estado de sessão
- Dados: Mais de 700 vaults em Ethereum, Base, Arbitrum, Polygon, Optimism e Avalanche
Habilidade do Agente
Instale a habilidade Philidor MCP no seu agente de codificação via skills.sh:
npx skills add philidor-labs/philidor-mcp
Isso dá ao seu agente conhecimento completo de todas as ferramentas, recursos, prompts, fluxos de trabalho recomendados e melhores práticas para análise de vaults DeFi.
Também Disponível
| Interface | Descrição | Link |
|---|---|---|
| CLI | Inteligência de vaults baseada em terminal — scriptável, canalizável, sandbox para agentes | philidor-cli |
| Habilidade OpenClaw | Definição de habilidade para a plataforma de agentes OpenClaw | npm |
Protocolos Suportados
Morpho, Aave v3, Yearn v3, Beefy, Spark — com mais sendo adicionados regularmente.
Veja a lista completa em app.philidor.io.
Desenvolvimento
git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start
O servidor se conecta à API pública Philidor por padrão. Para usar um endpoint personalizado:
PHILIDOR_API_URL=http://localhost:3003 npm start
Links
- Philidor Analytics — explore vaults e pontuações de risco
- Philidor CLI — inteligência de vaults baseada em terminal
- Documentação da API — documentação OpenAPI/Swagger
- Metodologia de Risco — como as pontuações são calculadas
- Smithery — registro de servidores MCP
- Twitter — atualizações e anúncios