Philidor MCP
Análisis de riesgos de bóvedas DeFi para agentes de IA. Busca en más de 700 bóvedas en Morpho, Aave, Yearn, Beefy, Spark y más. Compara puntuaciones de riesgo, analiza protocolos, realiza la debida diligencia, todo mediante lenguaje natural. No se requiere clave API. No es necesaria instalación.
Documentación
Servidor Philidor MCP
Analítica de riesgo de vaults DeFi para agentes de IA
Busca en 700+ vaults DeFi en Morpho, Aave, Yearn, Beefy y Spark. Compara puntuaciones de riesgo, analiza protocolos, realiza due diligence — todo mediante lenguaje natural.
No se requiere clave API. No es necesaria instalación.
Inicio rápido • Herramientas • Ejemplos de prompts • Marco de riesgo • Habilidad del agente
¿Por qué Philidor?
La mayoría de las herramientas de datos DeFi te dan números en bruto. Philidor le da a tu agente de IA inteligencia de riesgo de nivel institucional.
| Característica | Philidor | DefiLlama MCP | APIs DeFi genéricas |
|---|---|---|---|
| Puntuaciones de riesgo de vaults (0–10) | :white_check_mark: | :x: | :x: |
| Descomposición de vectores de riesgo | :white_check_mark: | :x: | :x: |
| Comparación de vaults | :white_check_mark: | :x: | :x: |
| Inteligencia de curadores | :white_check_mark: | :x: | :x: |
| Historial de seguridad de protocolos | :white_check_mark: | :x: | Parcial |
| Prompts de due diligence | :white_check_mark: | :x: | :x: |
| Evaluación de riesgo de cartera | :white_check_mark: | :x: | :x: |
| Sin necesidad de clave API | :white_check_mark: | :white_check_mark: | Varía |
| Alojado (sin instalación) | :white_check_mark: | :x: | :x: |
Inicio rápido
Servidor remoto (recomendado)
Conéctate directamente al servidor alojado — sin instalación, siempre actualizado:
https://mcp.philidor.io/api/mcp
Claude Desktop
Añade a ~/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
Añade a .cursor/mcp.json:
{
"mcpServers": {
"philidor": {
"url": "https://mcp.philidor.io/api/mcp"
}
}
}
Windsurf
Añade a tu configuración 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
Herramientas
10 herramientas para descubrimiento de vaults, análisis de riesgo e investigación de protocolos.
search_vaults
Busca y filtra vaults DeFi por cadena, protocolo, activo, nivel de riesgo, TVL y más.
| Parámetro | Tipo | Descripción |
|---|---|---|
query | string | Busca por nombre de vault, símbolo, activo, protocolo o curador |
chain | string | Filtra por cadena (Ethereum, Base, Arbitrum, ...) |
protocol | string | Filtra por ID de protocolo (morpho, aave-v3, yearn-v3, beefy, spark) |
asset | string | Filtra por símbolo de activo (USDC, WETH, ...) |
riskTier | string | Filtra por nivel de riesgo: Prime, Core o Edge |
minTvl | number | TVL mínimo en USD |
sortBy | string | Campo de ordenación: tvl_usd, apr_net, name |
sortOrder | string | Orden: asc o desc |
limit | number | Máximo de resultados (por defecto 10, máximo 50) |
get_vault
Obtén información detallada sobre un vault específico, incluido el desglose de riesgo, eventos recientes y capturas históricas. Búsqueda por id o por network + address.
| Parámetro | Tipo | Descripción |
|---|---|---|
id | string | ID del vault (p. ej. morpho-ethereum-0x...) |
network | string | Slug de red (ethereum, base, arbitrum) |
address | string | Dirección del contrato del vault (0x...) |
get_vault_risk_breakdown
Desglose detallado de los tres vectores de riesgo de un vault con sub-métricas: calidad del activo, madurez del código de la plataforma y controles de gobernanza. Devuelve puntuaciones a nivel de dimensión, límites, indicadores de fallo crítico y anulaciones.
| Parámetro | Tipo | Descripción |
|---|---|---|
network | string | Slug de red |
address | string | Dirección del contrato del vault |
compare_vaults
Comparación lado a lado de 2–3 vaults en TVL, APR, puntuación de riesgo, nivel de riesgo y estado de auditoría.
| Parámetro | Tipo | Descripción |
|---|---|---|
vaults | array | Array de 2–3 objetos con network y address |
find_safest_vaults
Encuentra los 10 mejores vaults auditados y de alta confianza ordenados por puntuación de riesgo.
| Parámetro | Tipo | Descripción |
|---|---|---|
asset | string | Filtra por símbolo de activo |
chain | string | Filtra por nombre de cadena |
minTvl | number | TVL mínimo en USD |
get_protocol_info
Detalles del protocolo, incluidos TVL, número de vaults, versiones, auditores, recompensas por bugs e incidentes de seguridad.
| Parámetro | Tipo | Descripción |
|---|---|---|
protocolId | string | ID de protocolo (morpho, aave-v3, yearn-v3, beefy, spark) |
get_curator_info
Detalles del curador, incluidos vaults gestionados, TVL, distribución por cadena y métricas de rendimiento.
| Parámetro | Tipo | Descripción |
|---|---|---|
curatorId | string | ID del curador |
get_market_overview
Estadísticas generales del mercado de vaults DeFi: TVL total, número de vaults, distribución de riesgo y TVL por protocolo. No se requieren parámetros.
explain_risk_score
Explica qué significa una puntuación de riesgo específica, incluidos el nivel, el método de cálculo y los umbrales.
| Parámetro | Tipo | Descripción |
|---|---|---|
score | number | Puntuación de riesgo (0–10) |
list_vaults_with_incidents
Lista todos los vaults que tuvieron un incidente crítico reciente (últimos 365 días). Ordenados por TVL descendente y luego por actualidad. No se requieren parámetros.
Recursos
| URI | Descripción |
|---|---|
philidor://methodology | Documentación del Vector Risk Framework v4.1 |
philidor://supported-chains | Redes blockchain compatibles con número de vaults |
philidor://supported-protocols | Protocolos DeFi compatibles con datos de TVL |
Prompts
| Prompt | Descripción |
|---|---|
vault_due_diligence | Informe completo de due diligence para un vault |
portfolio_risk_assessment | Análisis de riesgo a nivel de cartera entre posiciones |
defi_yield_comparison | Comparación de rendimiento con análisis ajustado por riesgo |
Ejemplos de prompts
Una vez conectado, prueba a preguntar a tu asistente de IA:
Descubrimiento
"Encuentra los vaults USDC más seguros con al menos $10M de TVL"
"¿Qué vaults de Morpho están disponibles en Base?"
"Muéstrame la visión general del mercado DeFi"
Análisis
"Realiza due diligence sobre el vault Steakhouse USDC en Ethereum"
"Compara los 3 mejores vaults USDC por puntuación de riesgo"
"¿Cuál es el desglose de riesgo de este vault: ethereum/0x...?"
Cartera
"Evalúa mi cartera: 50% en Morpho Steakhouse USDC, 30% en Aave USDC, 20% en Yearn USDC"
"¿Qué protocolos han tenido incidentes de seguridad?"
"¿Qué significa una puntuación de riesgo de 8.5?"
Puntuación de riesgo
Philidor utiliza el Vector Risk Framework v4.1 para descomponer el riesgo de los vaults en tres vectores medibles:
Final Score = 40% Asset + 40% Platform + 20% Governance
Composición del activo (40%)
Calidad de la garantía subyacente. Los activos de primera línea (ETH, USDC) obtienen la puntuación más alta. Los factores incluyen fiabilidad del oráculo, profundidad de liquidez y estabilidad del anclaje.
Código de la plataforma (40%)
Madurez del código medida por:
- Puntuación Lindy — seguridad basada en el tiempo (>2 años ≈ 9/10)
- Densidad de auditorías — número y calidad de las auditorías
- Riesgo de dependencias — penalizaciones multiplicativas por dependencias arriesgadas
- Penalización por incidentes — limita la puntuación tras incidentes de seguridad
Gobernanza (20%)
Ventana de salida para los usuarios:
| Control | Puntuación |
|---|---|
| Contrato inmutable | 10/10 |
| Bloqueo temporal de 7+ días | 9/10 |
| Sin bloqueo temporal | 1/10 |
Niveles de riesgo
| Nivel | Puntuación | Significado |
|---|---|---|
| Prime | 8.0–10.0 | Grado institucional — código maduro, múltiples auditorías, gobernanza segura |
| Core | 5.0–7.9 | Seguridad moderada — auditado pero más nuevo o con gobernanza flexible |
| Edge | 0.0–4.9 | Mayor riesgo — requiere due diligence cuidadosa |
Arquitectura
┌──────────────────┐ ┌─────────────────┐ ┌──────────────┐
│ Claude / Cursor │────▶│ Philidor MCP │────▶│ Philidor API │
│ Windsurf / etc. │◀────│ Server │◀────│ │
└──────────────────┘ └─────────────────┘ └──────┬───────┘
10 tools, 3 resources, │
3 prompts │
┌────▼────┐
│ On-chain │
│ data │
└─────────┘
- Transporte: Streamable HTTP (remoto) o stdio (local/Docker)
- API: Llama a la Philidor Public API — no se necesita clave API
- Sin estado: Instancia de servidor nueva por solicitud, sin estado de sesión
- Datos: 700+ vaults en Ethereum, Base, Arbitrum, Polygon, Optimism y Avalanche
Habilidad del agente
Instala la habilidad Philidor MCP en tu agente de codificación mediante skills.sh:
npx skills add philidor-labs/philidor-mcp
Esto le da a tu agente conocimiento completo de todas las herramientas, recursos, prompts, flujos de trabajo recomendados y mejores prácticas para el análisis de vaults DeFi.
También disponible
| Interfaz | Descripción | Enlace |
|---|---|---|
| CLI | Inteligencia de vaults desde terminal — programable, encadenable, aislado para agentes | philidor-cli |
| OpenClaw Skill | Definición de habilidad para la plataforma de agentes OpenClaw | npm |
Protocolos compatibles
Morpho, Aave v3, Yearn v3, Beefy, Spark — con más añadiéndose regularmente.
Consulta la lista completa en app.philidor.io.
Desarrollo
git clone https://github.com/Philidor-Labs/philidor-mcp.git
cd philidor-mcp
npm install
npm start
El servidor se conecta a la Philidor API pública por defecto. Para usar un endpoint personalizado:
PHILIDOR_API_URL=http://localhost:3003 npm start
Enlaces
- Philidor Analytics — explora vaults y puntuaciones de riesgo
- Philidor CLI — inteligencia de vaults desde terminal
- Documentación de API — docs OpenAPI/Swagger
- Metodología de riesgo — cómo se calculan las puntuaciones
- Smithery — registro de servidores MCP
- Twitter — actualizaciones y anuncios