v3.0.0 — Full Aave V4 API Integration

What's New

Full Aave V4 API integration alongside existing V2/V3 Graph subgraph tools. 32 tools total.

16 New V4 Tools (no API key needed)

All tested against the live api.aave.com/graphql endpoint.

Liquidity Model:

• get_v4_hubs — Hubs (Core, Plus, Prime) with TVL and utilization
• get_v4_spokes — 10 spokes (Main, Bluechip, Kelp, Lido, Ethena, etc.)
• get_v4_reserves — Per-spoke APYs, risk params, caps
• get_v4_chains — Supported chains
• get_v4_asset — Cross-hub asset summary
• get_v4_exchange_rate — Token prices via Chainlink oracles
• get_v4_asset_price_history — Historical prices
• get_v4_protocol_history — Total deposits/borrows over time

User Data:

• get_v4_user_positions — Cross-chain positions with health factor
• get_v4_user_summary — Aggregated portfolio
• get_v4_user_supplies / get_v4_user_borrows — Position breakdown
• get_v4_user_balances — Cross-chain token holdings
• get_v4_user_activities — Full transaction history
• get_v4_claimable_rewards — Merkl and points rewards
• get_v4_swap_quote — CoW Protocol swap pricing (read-only)

New Prompt

• aave_full_stack_analysis — Cross-version V2 vs V3 vs V4 comparison

Two Data Sources

• V2/V3: 11 Graph subgraphs across 7 chains (requires GRAPH_API_KEY)
• V4: Aave's own GraphQL API (no key needed)

V4 Live Data (Ethereum)

• 3 Hubs: Core ($160K TVL), Plus, Prime ($12K)
• 10 Spokes: Main, Bluechip, Kelp, Lido, Ethena Correlated, Ethena Ecosystem, EtherFi, Forex, Gold, Lombard

Setup

claude mcp add graph-aave -- npx -y graph-aave-mcp
export GRAPH_API_KEY=your-key  # only needed for V2/V3 tools