Graph Aave MCP

graph-aave-mcp

MCP server for [AAVE](https://aave.com/) V2, V3, and V4 — 51 tools across 18 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

Quick Start

# 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

Optional but recommended: the two live on-chain tools read via RPC, and the

unconfigured public fallback is rate-limited or blocked on many networks.

export ETHEREUM_RPC_URL=https://your-endpoint

Claude Desktop / Cursor config

{

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

</details>

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

Lending Markets

User Positions

Protocol Events

Governance

Advanced

Supported Chains (V2/V3)

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

Risk Events

Discovery

Supported Chains (Liquidation Risk)

V4 Tools (Aave API)

17 tools powered by api.v4.aave.com/graphql. No API key needed. (api.aave.com/graphql is an alias for the same schema; override either with AAVE_V4_API_URL.)

Note: the V4 Omnigraph tools (next section) cover gaps the REST API doesn't expose and require `GRAPH_API_KEY`. The 16 tools listed below remain key-free.

Liquidity Model

User Data

V4 Omnigraph Tools (subgraph — fills gaps the Aave API doesn't expose)

5 tools powered by the aave-v-4 subgraph (QmcKrCRSPrMABEfQjyPF6DqhbY7zzcEj6h5QxQmKLcHFSs). Requires `GRAPH_API_KEY` (the same free key used by V2/V3 subgraph tools).

These cover what api.aave.com/graphql structurally can't return: Hub↔Spoke flow events, per-user risk-premium trajectories, liquidation post-mortems with full premium-delta context, treasury/fee/deficit accounting, and governance-trail snapshots.

V4 Subgraph Tools — Base (Coinbase tokenized stocks) + Ethereum

6 network-aware tools backed by the Aave V4 subgraph. Default `network: "base"` — the Coinbase Stocks hub on Base (subgraph 9x1tg7KX3RXspnK7R1mahAZsM5gTmFhLrmJSbkoBsDdq). Pass network: "ethereum" for Core/Plus/Prime. Requires `GRAPH_API_KEY`.

Example: *"Who's liquidating tokenized stocks on Aave V4 Base?"* → get_v4_recent_liquidations. *"What's the USDC borrow rate and fees on the Base stocks hub?"* → get_v4_hub_assets (≈2.1%, 10% liquidity fee).

V4 Architecture

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 enables cross-chain lending: supply on one spoke, borrow on another. Hubs aggregate liquidity across spokes.

Guided Prompts

7 pre-built workflows that guide agents through multi-step analysis: