graph-aave-mcp

npm version MCP Registry License: MIT

Servidor MCP para AAVE V2, V3 y V4 — 40 herramientas a través de 16 subgrafos de The Graph + la API de Aave V4.

Cubre mercados de préstamos, posiciones de usuario, factores de salud, monitoreo de riesgo de liquidación entre cadenas, liquidaciones, préstamos flash, gobernanza, hubs/spokes de V4, tipos de cambio, cotizaciones de intercambio, recompensas e historial del protocolo.

Publicado en el Registro MCP como io.github.PaulieB14/graph-aave-mcp

Tres fuentes de datos

Fuente	Versión	Qué proporciona	Autenticación
Subgrafos de The Graph	V2/V3	11 subgrafos en 7 cadenas — reservas, posiciones, eventos, gobernanza	`GRAPH_API_KEY` (gratis)
Subgrafos de riesgo de liquidación	V3	5 cadenas — factores de salud en tiempo real, puntuaciones de riesgo, alertas de riesgo, estadísticas de riesgo del protocolo	`GRAPH_API_KEY` (gratis)
API de Aave V4	V4	Hubs, spokes, reservas, tipos de cambio, posiciones de usuario, actividades, cotizaciones de intercambio, recompensas	No necesaria

Related MCP server: Aave Liquidation MCP Server

Inicio rápido

# Claude Code
claude mcp add graph-aave -- npx -y graph-aave-mcp

# Set Graph API key for subgraph tools (V4 tools work without it)
export GRAPH_API_KEY=your-key-here

{
  "mcpServers": {
    "graph-aave": {
      "command": "npx",
      "args": ["-y", "graph-aave-mcp"],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Clave de API de Graph gratuita: thegraph.com/studio (nivel gratuito de 100K consultas/mes).

Despliegue alojado (sin instalación): Fronteir AI

Herramientas V2/V3 (Subgrafos de The Graph)

15 herramientas + 1 vía de escape para consultas sin procesar. Requiere GRAPH_API_KEY.

Descubrimiento

Herramienta	Descripción
`list_aave_chains`	Todas las cadenas compatibles con IDs de subgrafo, versiones y volúmenes de consulta de 30 días
`get_aave_schema`	Introspección completa del esquema GraphQL para cualquier cadena

Mercados de préstamos

Herramienta	Descripción
`get_aave_reserves`	Todos los mercados activos — TVL, APY de suministro/préstamo, LTV, umbrales de liquidación
`get_aave_reserve`	Detalle profundo sobre un activo: estadísticas de por vida, configuración, direcciones de tokens
`get_reserve_rate_history`	Instantáneas históricas de APY, utilización y TVL

Posiciones de usuario

Herramienta	Descripción
`get_aave_user_position`	Activos suministrados/prestados de la billetera, indicadores de garantía, e-mode
`simulate_health_factor`	Simular cambios de precio en el factor de salud de un usuario

Eventos del protocolo

Herramienta	Descripción
`get_recent_borrows`	Préstamos recientes — filtrar por usuario o activo
`get_recent_supplies`	Suministros/depósitos recientes (maneja automáticamente el esquema V2 vs V3)
`get_aave_repays`	Reembolsos recientes
`get_aave_liquidations`	Liquidaciones recientes — filtrar por usuario o liquidador
`get_aave_flash_loans`	Préstamos flash recientes con comisiones

Gobernanza

Herramienta	Descripción
`get_governance_proposals`	Propuestas con títulos, estados y recuentos de votos
`get_proposal_votes`	Desglose por votante según el poder de voto

Avanzado

Herramienta	Descripción
`query_aave_subgraph`	GraphQL sin procesar — ejecutar cualquier consulta contra cualquier cadena

Cadenas compatibles (V2/V3)

Cadena	Versión	Consultas 30d
Ethereum	V3	21.6M
Base	V3	5.6M
Arbitrum	V3	5.6M
Polygon	V3	2.0M
Optimism	V3	1.8M
Avalanche	V3	1.2M
Ethereum	V2	701K
Polygon	V2	216K
Avalanche	V2	133K
Fantom	V3 (Messari)	13K
Ethereum	Gobernanza V3	486K

Herramientas de riesgo de liquidación (NUEVO)

8 herramientas impulsadas por subgrafos de riesgo dedicados en 5 cadenas. Requiere GRAPH_API_KEY.

Monitoreo de riesgo de liquidación en tiempo real con factores de salud, puntuaciones de riesgo (0–100), clasificaciones de nivel de riesgo (seguro/advertencia/peligro/crítico) y resúmenes de riesgo entre cadenas.

Monitoreo de riesgo

Herramienta	Descripción
`get_at_risk_positions`	Posiciones en riesgo de liquidación — filtrar por nivel de riesgo, ordenadas por puntuación de riesgo
`get_user_risk_profile`	Perfil de riesgo completo para una billetera — todas las posiciones con factores de salud y puntuaciones de riesgo
`get_protocol_risk_stats`	Estadísticas agregadas: total de posiciones, recuentos de peligro/advertencia/crítico
`get_cross_chain_risk_summary`	Resumen de riesgo en las 5 cadenas en una sola llamada

Eventos de riesgo

Herramienta	Descripción
`get_risk_alerts`	Transiciones de nivel de riesgo — cuando las posiciones se mueven entre seguro/advertencia/peligro/crítico
`get_risk_liquidations`	Eventos de liquidación con activos de garantía/deuda, montos y hashes de tx
`get_health_factor_history`	Tendencia del factor de salud a lo largo del tiempo para una billetera específica

Descubrimiento

Herramienta	Descripción
`list_risk_chains`	Cadenas de riesgo de liquidación disponibles con IDs de subgrafo y volúmenes de consulta

Cadenas compatibles (Riesgo de liquidación)

Cadena	Consultas 30d	Señal
Ethereum	21.1K	20.2K GRT
Arbitrum	19.3K	35.7K GRT
Base	16.2K	15.2K GRT
Polygon	13.2K	—
Optimism	13.0K	—

Herramientas V4 (API de Aave)

16 herramientas impulsadas por api.aave.com/graphql. No se necesita clave de API.

Modelo de liquidez

Herramienta	Descripción
`get_v4_hubs`	Hubs de liquidez (Core, Plus, Prime) con TVL y utilización
`get_v4_spokes`	Spokes entre cadenas (Main, Bluechip, Kelp, Lido, Ethena, EtherFi, Forex, Gold, Lombard)
`get_v4_reserves`	Reservas por spoke con APYs de suministro/préstamo, parámetros de riesgo, límites
`get_v4_chains`	Cadenas V4 compatibles
`get_v4_asset`	Resumen de activos entre hubs con APYs promedio y precio
`get_v4_exchange_rate`	Precio de cualquier token mediante oráculos de Chainlink (ERC-20, nativo o fiat)
`get_v4_asset_price_history`	Precios históricos de tokens
`get_v4_protocol_history`	Total de depósitos/préstamos a lo largo del tiempo

Datos de usuario

Herramienta	Descripción
`get_v4_user_positions`	Posiciones entre cadenas — factor de salud, garantía, deuda, poder de préstamo
`get_v4_user_summary`	Portafolio agregado: total de posiciones, balance neto, APY neto
`get_v4_user_supplies`	Posiciones de suministro con principal e intereses
`get_v4_user_borrows`	Posiciones de préstamo con desglose de deuda
`get_v4_user_balances`	Tenencias de tokens entre cadenas con mejores APYs por token
`get_v4_user_activities`	Historial de transacciones: suministros, préstamos, reembolsos, liquidaciones, intercambios
`get_v4_claimable_rewards`	Recompensas reclamables de Merkl y puntos
`get_v4_swap_quote`	Cotización de intercambio de solo lectura mediante CoW Protocol (protegido contra MEV)

Arquitectura V4

Hubs (Core, Plus, Prime)
  └── Assets (WETH, USDC, GHO, cbBTC, etc.)
       └── Spokes (Main, Bluechip, Kelp, Lido, Ethena, ...)
            └── Reserves (per-spoke lending markets)
                 └── User Positions (health factor, collateral, debt)

V4 permite préstamos entre cadenas: suministrar en un spoke, pedir prestado en otro. Los hubs agregan liquidez a través de los spokes.

Prompts guiados

7 flujos de trabajo preconfigurados que guían a los agentes a través de un análisis de varios pasos:

Prompt	Descripción
`analyze_aave_user`	Análisis completo de billetera: posiciones, factor de salud, riesgo de liquidación
`aave_chain_overview`	Resumen del protocolo: mercados principales, tasas, actividad reciente
`compare_aave_rates`	Comparar APY para un activo en todas las cadenas
`aave_liquidation_analysis`	Patrones de liquidación, principales liquidadores, mercados en riesgo
`aave_governance_overview`	Propuestas recientes, resultados de votación, decisiones activas
`aave_full_stack_analysis`	Comparación entre versiones: tasas y posiciones de V2 vs V3 vs V4
`cross_chain_risk_monitor`	NUEVO — Riesgo de liquidación entre cadenas: posiciones más arriesgadas, alertas, salud del protocolo

Preguntas de ejemplo

Riesgo de liquidación (nuevo):

"¿Qué posiciones de Aave en Arbitrum están más cerca de la liquidación?"
"Dame un panel de riesgo entre cadenas: ¿qué red tiene la mayor cantidad de posiciones en riesgo?"
"¿Está la billetera 0x... en riesgo de liquidación en alguna cadena?"
"Muéstrame alertas de riesgo recientes: ¿qué posiciones se volvieron críticas recientemente?"
"¿Cómo ha cambiado el factor de salud de esta billetera a lo largo del tiempo en Base?"

V4:

"¿Cuáles son los hubs de Aave V4 y su utilización?"
"Muéstrame las reservas de V4 con el APY de suministro más alto"
"¿Cuál es el precio actual de ETH en Aave V4?"
"Compara las tasas de suministro de USDC de V3 vs V4"
"¿Qué spokes tiene Aave V4 en Ethereum?"

V2/V3:

"¿Cuáles son los principales mercados de AAVE en Ethereum por TVL?"
"Compara las tasas de préstamo de WETH en todas las cadenas V3"
"Analiza la posición de AAVE para la billetera 0x..."
"Si ETH cae un 30%, ¿se liquidará la dirección 0x...?"
"Muéstrame las últimas 20 liquidaciones en Ethereum"
"¿Qué propuestas de gobernanza de AAVE están activas?"

Desarrollo

git clone https://github.com/PaulieB14/graph-aave-mcp.git
cd graph-aave-mcp
npm install
npm run build
GRAPH_API_KEY=your-key node build/index.js

Licencia

MIT

Graph AAVE MCP

graph-aave-mcp

Tres fuentes de datos

Inicio rápido

Herramientas V2/V3 (Subgrafos de The Graph)

Descubrimiento

Mercados de préstamos

Posiciones de usuario

Eventos del protocolo

Gobernanza

Avanzado

Cadenas compatibles (V2/V3)

Herramientas de riesgo de liquidación (NUEVO)

Monitoreo de riesgo

Eventos de riesgo

Descubrimiento

Cadenas compatibles (Riesgo de liquidación)

Herramientas V4 (API de Aave)

Modelo de liquidez

Datos de usuario

Arquitectura V4

Prompts guiados

Preguntas de ejemplo

Desarrollo

Licencia

Resources

Latest Blog Posts

MCP directory API