graph-aave-mcp
MCP server for Aave V2, V3, and V4 — 47 tools across 16 Graph subgraphs + the Aave V4 API + on-chain view contracts.
Setup
npm install -g graph-aave-mcp
graph-aave-mcp
Or add to Claude Code:
claude mcp add graph-aave -- graph-aave-mcp
Set your Graph API key (free at https://thegraph.com/studio/):
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 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
1---2name: graph-aave-mcp3description: Aave V2/V3/V4 MCP server — 47 tools across 16 Graph subgraphs + Aave V4 API + on-chain view contracts. Reserves, positions, cross-chain liquidation risk monitoring with live HF confirmation, governance, V4 hubs/spokes, exchange rates, swap quotes, rewards, protocol history, and a durable findings store that survives context compaction.4version: 4.1.05metadata:6 source: https://skillmd.com/skills/paulieb14-graph-aave-mcp/graph-aave-mcp7 openclaw:8 requires:9 env:10 - GRAPH_API_KEY11 primaryEnv: GRAPH_API_KEY12 envVars:13 - name: GRAPH_API_KEY14 required: true15 description: API key for The Graph network. Free at https://thegraph.com/studio/ (100K queries/month).16 emoji: "📊"17 homepage: https://github.com/PaulieB14/graph-aave-mcp18---1920# graph-aave-mcp2122MCP server for Aave V2, V3, and V4 — 47 tools across 16 Graph subgraphs + the Aave V4 API + on-chain view contracts.2324## Setup2526```bash27npm install -g graph-aave-mcp28graph-aave-mcp29```3031Or add to Claude Code:3233```bash34claude mcp add graph-aave -- graph-aave-mcp35```3637Set your Graph API key (free at https://thegraph.com/studio/):3839```bash40export GRAPH_API_KEY=your-key-here41```4243## What it does4445- **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 tokens46- **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**47- **V4 API** (17 tools): Hubs, spokes, reserves, exchange rates, user positions, activities, swap quotes, claimable rewards48- **Findings store** (new in 4.1.0): durable per-session findings that survive context compaction4950## What's new in 4.1.05152- Live on-chain reads — every reported health factor is double-checked against the Aave protocol's view contracts before surfacing53- Durable findings store — investigations persist across context-window compaction so multi-step analyses don't lose state5455## Example questions5657- "What are the top Aave V3 markets on Ethereum by TVL?"58- "Compare WETH borrow rates across all chains"59- "Which positions are at risk of liquidation on Arbitrum?"60- "Show me Aave V4 hub utilization"61- "Is wallet 0x... at risk of liquidation on any chain — and confirm the HF on-chain?"6263## Links6465- npm: https://www.npmjs.com/package/graph-aave-mcp66- GitHub: https://github.com/PaulieB14/graph-aave-mcp