Graph Aave Mcp
Connects Claude to AAVE's decentralized lending protocol across V2, V3, and V4 deployments. Exposes 40 tools split across three data sources: The Graph subgraphs for V2/V3 historical data on 11 chains, dedicated liquidation risk subgraphs tracking health factors and position risk across 5 chains, and the official AAVE V4 API for hub/spoke liquidity models and cross-chain positions. Query lending markets, user collateral and debt positions, flash loans, liquidation events, governance proposals, and simulate health factor changes under different price scenarios. The V4 tools cover the new hub architecture, exchange rates via Chainlink oracles, and swap quotes through CoW Protocol. Requires a free Graph API key for subgraph access; V4 endpoints work without authentication.
- GitHub stars
- 1
- tools
- 50
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 4, 2026
Tools
50 toolsPublic tool metadata for what this MCP can expose to an agent.
list_aave_chainsAll supported chains with subgraph IDs, versions, 30d query volumes
All supported chains with subgraph IDs, versions, 30d query volumes
No parameter schema in public metadata yet.
get_aave_schemaFull GraphQL schema introspection for any chain
Full GraphQL schema introspection for any chain
No parameter schema in public metadata yet.
get_aave_reservesAll active markets — TVL, supply/borrow APY, LTV, liquidation thresholds
All active markets — TVL, supply/borrow APY, LTV, liquidation thresholds
No parameter schema in public metadata yet.
get_aave_reserveDeep detail on one asset: lifetime stats, config, token addresses
Deep detail on one asset: lifetime stats, config, token addresses
No parameter schema in public metadata yet.
get_reserve_rate_historyHistorical APY, utilization, TVL snapshots
Historical APY, utilization, TVL snapshots
No parameter schema in public metadata yet.
get_aave_user_positionWallet's supplied/borrowed assets, collateral flags, e-mode
Wallet's supplied/borrowed assets, collateral flags, e-mode
No parameter schema in public metadata yet.
simulate_health_factorSimulate price changes on a user's health factor
Simulate price changes on a user's health factor
No parameter schema in public metadata yet.
get_recent_borrowsRecent borrows — filter by user or asset
Recent borrows — filter by user or asset
No parameter schema in public metadata yet.
get_recent_suppliesRecent supplies/deposits (auto-handles V2 vs V3 schema)
Recent supplies/deposits (auto-handles V2 vs V3 schema)
No parameter schema in public metadata yet.
get_aave_repaysRecent repayments
Recent repayments
No parameter schema in public metadata yet.
get_aave_liquidationsRecent liquidations — filter by user or liquidator
Recent liquidations — filter by user or liquidator
No parameter schema in public metadata yet.
get_aave_flash_loansRecent flash loans with fees
Recent flash loans with fees
No parameter schema in public metadata yet.
get_governance_proposalsProposals with titles, states, vote counts
Proposals with titles, states, vote counts
No parameter schema in public metadata yet.
get_proposal_votesPer-voter breakdown by voting power
Per-voter breakdown by voting power
No parameter schema in public metadata yet.
query_aave_subgraphRaw GraphQL — execute any query against any chain
Raw GraphQL — execute any query against any chain
No parameter schema in public metadata yet.
list_risk_chainsAvailable liquidation risk chains with subgraph IDs and query volumes
Available liquidation risk chains with subgraph IDs and query volumes
No parameter schema in public metadata yet.
get_at_risk_positionsPositions at risk of liquidation — filter by risk level, sorted by risk score
Positions at risk of liquidation — filter by risk level, sorted by risk score
No parameter schema in public metadata yet.
get_user_risk_profileFull risk profile for a wallet — all positions with health factors and risk scores
Full risk profile for a wallet — all positions with health factors and risk scores
No parameter schema in public metadata yet.
get_protocol_risk_statsAggregate stats: total positions, danger/warning/critical counts
Aggregate stats: total positions, danger/warning/critical counts
No parameter schema in public metadata yet.
get_cross_chain_risk_summaryRisk overview across all 5 chains in one call
Risk overview across all 5 chains in one call
No parameter schema in public metadata yet.
get_risk_alertsRisk level transitions — when positions move between safe/warning/danger/critical
Risk level transitions — when positions move between safe/warning/danger/critical
No parameter schema in public metadata yet.
get_risk_liquidationsLiquidation events with collateral/debt assets, amounts, and tx hashes
Liquidation events with collateral/debt assets, amounts, and tx hashes
No parameter schema in public metadata yet.
get_health_factor_historyHealth factor trend over time for a specific wallet
Health factor trend over time for a specific wallet
No parameter schema in public metadata yet.
get_v4_hubsLiquidity hubs (Core, Plus, Prime) with TVL and utilization
Liquidity hubs (Core, Plus, Prime) with TVL and utilization
No parameter schema in public metadata yet.
get_v4_spokesCross-chain spokes (Main, Bluechip, Kelp, Lido, Ethena, EtherFi, Forex, Gold, Lombard)
Cross-chain spokes (Main, Bluechip, Kelp, Lido, Ethena, EtherFi, Forex, Gold, Lombard)
No parameter schema in public metadata yet.
get_v4_reservesPer-spoke reserves with supply/borrow APYs, risk params, caps
Per-spoke reserves with supply/borrow APYs, risk params, caps
No parameter schema in public metadata yet.
get_v4_chainsSupported V4 chains
Supported V4 chains
No parameter schema in public metadata yet.
get_v4_assetCross-hub asset summary with average APYs and price
Cross-hub asset summary with average APYs and price
No parameter schema in public metadata yet.
get_v4_exchange_rateAny token price via Chainlink oracles (ERC-20, native, or fiat)
Any token price via Chainlink oracles (ERC-20, native, or fiat)
No parameter schema in public metadata yet.
get_v4_asset_price_historyHistorical token prices
Historical token prices
No parameter schema in public metadata yet.
get_v4_protocol_historyTotal deposits/borrows over time
Total deposits/borrows over time
No parameter schema in public metadata yet.
get_v4_user_positionsCross-chain positions — health factor, collateral, debt, borrowing power
Cross-chain positions — health factor, collateral, debt, borrowing power
No parameter schema in public metadata yet.
get_v4_user_summaryAggregated portfolio: total positions, net balance, net APY
Aggregated portfolio: total positions, net balance, net APY
No parameter schema in public metadata yet.
get_v4_user_suppliesSupply positions with principal and interest
Supply positions with principal and interest
No parameter schema in public metadata yet.
get_v4_user_borrowsBorrow positions with debt breakdown
Borrow positions with debt breakdown
No parameter schema in public metadata yet.
get_v4_user_balancesCross-chain token holdings with best APYs per token
Cross-chain token holdings with best APYs per token
No parameter schema in public metadata yet.
get_v4_user_activitiesTransaction history: supplies, borrows, repays, liquidations, swaps
Transaction history: supplies, borrows, repays, liquidations, swaps
No parameter schema in public metadata yet.
get_v4_claimable_rewardsClaimable Merkl and points rewards
Claimable Merkl and points rewards
No parameter schema in public metadata yet.
get_v4_swap_quoteRead-only swap pricing via CoW Protocol (MEV-protected)
Read-only swap pricing via CoW Protocol (MEV-protected)
No parameter schema in public metadata yet.
get_v4_hub_flowsHub↔Spoke routing events (Add, Remove, Draw, Restore, RefreshPremium, ReportDeficit, TransferShares) with AaveKit-joined spoke names and asset symbols
Hub↔Spoke routing events (Add, Remove, Draw, Restore, RefreshPremium, ReportDeficit, TransferShares) with AaveKit-joined spoke names and asset symbols
No parameter schema in public metadata yet.
get_v4_user_risk_trajectoryPer-user risk-premium snapshot history — every RefreshPremium event for a user, plus the latest premium and the spoke it was set on
Per-user risk-premium snapshot history — every RefreshPremium event for a user, plus the latest premium and the spoke it was set on
No parameter schema in public metadata yet.
get_v4_liquidation_postmortemFull liquidation event by tx hash or user — collateral/debt amounts, liquidator, premium-share / offset-ray / restored-premium deltas
Full liquidation event by tx hash or user — collateral/debt amounts, liquidator, premium-share / offset-ray / restored-premium deltas
No parameter schema in public metadata yet.
get_v4_treasury_flowsMerged stream of FeeMint / Sweep / Reclaim / DeficitEliminated events ordered by block desc, optionally filtered by hub (Core/Plus/Prime) and time window
Merged stream of FeeMint / Sweep / Reclaim / DeficitEliminated events ordered by block desc, optionally filtered by hub (Core/Plus/Prime) and time window
No parameter schema in public metadata yet.
get_v4_spoke_config_historySpoke liquidation-config governance trail — current and historical targetHealthFactor, healthFactorForMaxBonus, liquidationBonusFactor per spoke
Spoke liquidation-config governance trail — current and historical targetHealthFactor, healthFactorForMaxBonus, liquidationBonusFactor per spoke
No parameter schema in public metadata yet.
get_v4_recent_liquidationsLiquidations newest-first, filter by liquidator / user / sinceHours; collateral seized, debt restored, shares, premium deltas, per-liquidator counts
Liquidations newest-first, filter by liquidator / user / sinceHours; collateral seized, debt restored, shares, premium deltas, per-liquidator counts
No parameter schema in public metadata yet.
get_v4_hub_assetsPer-asset borrow rate %, liquidity fee %, accrued protocol fees, fee receiver, IR strategy
Per-asset borrow rate %, liquidity fee %, accrued protocol fees, fee receiver, IR strategy
No parameter schema in public metadata yet.
get_v4_config_changesHub↔spoke cap snapshots, reserve config snapshots, liquidation-config snapshots, position-manager whitelist (optional spoke)
Hub↔spoke cap snapshots, reserve config snapshots, liquidation-config snapshots, position-manager whitelist (optional spoke)
No parameter schema in public metadata yet.
get_v4_hub_daily_flowsDaily supplied/withdrawn/borrowed/repaid/deficit per hub asset, optional raw flow events
Daily supplied/withdrawn/borrowed/repaid/deficit per hub asset, optional raw flow events
No parameter schema in public metadata yet.
get_v4_user_activityUser risk premium + history, liquidations suffered, supply/withdraw/borrow/repay/collateral activity
User risk premium + history, liquidations suffered, supply/withdraw/borrow/repay/collateral activity
No parameter schema in public metadata yet.
get_v4_treasury_eventsMerged FeeMint / Sweep / Reclaim / DeficitEliminated / ReportDeficit stream
Merged FeeMint / Sweep / Reclaim / DeficitEliminated / ReportDeficit stream
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GRAPH_API_KEY*secretAPI key for The Graph network. Required to query subgraphs. Get one free at https://thegraph.com/studio/apikeys/
Readme
graph-aave-mcp
MCP server for AAVE V2, V3, and V4 — 62 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, loan swaps, Base equity gap shock, rewards, and protocol history.
What's new
Details
- Repository
- github.com/paulieb14/graph-aave-mcp
- Package
graph-aave-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active