graph-aave-mcp#

MCP server for Aave V2, V3, and V4 — 57 tools across 16 Graph subgraphs + the Aave V4 API + on-chain view contracts.

Setup#

bash

npm install -g graph-aave-mcp
graph-aave-mcp

Or add to Claude Code:

bash

claude mcp add graph-aave -- graph-aave-mcp

Set your Graph API key (free at https://thegraph.com/studio/):

bash

export GRAPH_API_KEY=your-key-here

What it does#

• V2/V3 (16 tools): Reserves, positions, liquidations, borrows, supplies, flash loans, governance across 11 subgraphs on 7 chains (Ethereum, Arbitrum, Base, Polygon, Optimism, Avalanche). get_aave_reserves and get_v4_reserves accept symbols / limit / compact — use them, the unfiltered Ethereum response is ~28k tokens
• Liquidation Risk (8 tools): Cross-chain health factors, risk scores, risk alerts, at-risk positions across 5 chains, with live on-chain HF confirmation against Aave view contracts
• V4 Subgraph (6 tools, Base default / Ethereum): liquidations by liquidator/user, hub asset rates + fees, config-change history, daily hub flows, user risk premium + activity, treasury events
• V4 API (17 tools): Hubs, spokes, reserves, exchange rates, user positions, activities, swap quotes, claimable rewards
• Findings store (new in 4.1.0): durable per-session findings that survive context compaction

What's new in 4.1.0#

• Live on-chain reads — every reported health factor is double-checked against the Aave protocol's view contracts before surfacing
• Durable findings store — investigations persist across context-window compaction so multi-step analyses don't lose state

Example questions#

• "What are the top Aave V3 markets on Ethereum by TVL?"
• "Compare WETH borrow rates across all chains"
• "Which positions are at risk of liquidation on Arbitrum?"
• "Show me Aave V4 hub utilization"
• "Is wallet 0x... at risk of liquidation on any chain — and confirm the HF on-chain?"

Links#

• npm: https://www.npmjs.com/package/graph-aave-mcp
• GitHub: https://github.com/PaulieB14/graph-aave-mcp