PaulieB14/graph-aave-mcp

**MCP server for AAVE V2, V3, and V4 — 57 tools across 17 Graph subgraphs + the Aave V4 API + V4 Omnigraph (for data the REST API doesn't expose).**
Covers lending markets, user positions, health factors, **cross-chain liquidation risk monitoring**, liquidations, flash loans, governance, V4 hubs/spokes, exchange rates, swap quotes, rewards, and protocol history.
> Published to the MCP Registry as io.github.PaulieB14/graph-aave-mcp
Three Data Sources
| Source | Version | What it provides | Auth |
|--------|---------|------------------|------|
| **The Graph subgraphs** | V2/V3 | 11 subgraphs across 7 chains — reserves, positions, events, governance | GRAPH_API_KEY (free) |
| **Liquidation Risk subgraphs** | V3 | 5 chains — real-time health factors, risk scores, risk alerts, protocol risk stats | GRAPH_API_KEY (free) |
| **Aave V4 API** | V4 | Hubs, spokes, reserves, exchange rates, user positions, activities, swap quotes, rewards | None needed |
| **V4 Omnigraph subgraph** | V4 | Hub↔Spoke flow events, per-user risk-premium history, liquidation post-mortems, treasury/fee/deficit accounting, spoke config governance trail | GRAPH_API_KEY (free) |
Quick Start
Claude Desktop / Cursor config
Free Graph API key: thegraph.com/studio (100K queries/month free tier).
**Hosted deployment** (no install): Fronteir AI
---
V2/V3 Tools (The Graph Subgraphs)
15 tools + 1 raw query escape hatch. Requires GRAPH_API_KEY.
> **Response size.** get_aave_reserves returns every active reserve by default —
> on Ethereum that is 67 reserves, ~28k tokens. Pass symbols: ["USDC"] for one
> asset (~675 tokens), compact: true for rates only, or limit to cap the rows.
> get_v4_reserves takes the same three options.
Discovery
| Tool | Description |
|------|-------------|
| list_aave_chains | All supported chains with subgraph IDs, versions, 30d query volumes |
| get_aave_schema | Full GraphQL schema introspection for any chain |
Lending Markets
| Tool | Description |
|------|-------------|
| get_aave_reserves | All active markets — TVL, supply/borrow APY, LTV, liquidation thresholds |
| get_aave_reserve | Deep detail on one asset: lifetime stats, config, token addresses |
| get_reserve_rate_history | Historical APY, utilization, TVL snapshots |
User Positions
| Tool | Description |
|------|-------------|
| get_aave_user_position | Wallet's supplied/borrowed assets, collateral flags, e-mode |
| simulate_health_factor | Simulate price changes on a user's health factor |
Protocol Events
| Tool | Description |
|------|-------------|
| get_recent_borrows | Recent borrows — filter by user or asset |
| get_recent_supplies | Recent supplies/deposits (auto-handles V2 vs V3 schema) |
| get_aave_repays | Recent repayments |
| get_aave_liquidations | Recent liquidations — filter by user or liquidator |
| get_aave_flash_loans | Recent flash loans with fees |
Governance
| Tool | Description |
|------|-------------|
| get_governance_proposals | Proposals with titles, states, vote counts |
| get_proposal_votes | Per-voter breakdown by voting power |
Advanced
| Tool | Description |
|------|-------------|
| query_aave_subgraph | Raw GraphQL — execute any query against any chain |
Supported Chains (V2/V3)
| Chain | Version | 30d Queries |
|-------|---------|-------------|
| 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 | Governance V3 | 486K |
---
Liquidation Risk Tools (NEW)
8 tools powered by dedicated risk subgraphs across 5 chains. Requires GRAPH_API_KEY.
Real-time liquidation risk monitoring with health factors, risk scores (0–100), risk level classifications (safe/warning/danger/critical), and cross-chain risk summaries.
Risk Monitoring
| Tool | Description |
|------|-------------|
| get_at_risk_positions | Positions at risk of liquidation — filter by risk level, sorted by risk score |