Graph Aave MCP

Use this when the user asks about the vote totals on a specific AAVE governance proposal — 'How did proposal #X vote?', 'Show me the for/against breakdown for proposal #185', 'Did proposal #X pass?'. Returns aggregate vote totals: total forVotes and againstVotes for the proposal. Note: individual per-voter records are not indexed in this subgraph.

Get aggregate risk statistics for Aave on a chain — total positions, and how many are in danger, warning, or critical state. Use when asked: 'How healthy is Aave on Ethereum right now?', 'How many positions are at risk on Arbitrum?', 'Give me a risk overview of the protocol'.

Use this when the user asks about recent borrowing activity on AAVE — 'Who has been borrowing USDC on Ethereum?', 'Show me recent WETH borrows on Arbitrum', 'What has address 0x... borrowed recently?', 'Show borrow volume by asset'. Returns borrow events with: borrower address, asset, raw amount, borrow rate, rate mode (variable=2/stable=1), and timestamp. Divide amount by 10^decimals for human-readable value.

Use this when the user asks about recent deposit/supply activity on AAVE — 'Who has been supplying ETH on Base?', 'Show me recent USDC deposits on Polygon', 'What has address 0x... deposited recently?'. V3 chains use the 'supply' entity; V2 chains use 'deposit' — handled automatically. Returns: supplier address, asset symbol, raw amount, and timestamp. Divide amount by 10^decimals for human-readable value.

Use this when the user asks about historical AAVE rates or TVL trends — 'How has USDC supply rate changed over time?', 'Show me ETH borrow rate history on Polygon', 'What was the utilization rate last week?'. Returns timestamped snapshots of: liquidityRate, variableBorrowRate, stableBorrowRate, utilizationRate, availableLiquidity, totalLiquidity, totalCurrentVariableDebt. Rates are in RAY units (divide by 1e27 * 100 for APY %). Get the reserve ID from get_aave_reserves (the 'id' field = underlyingAsset + poolAddress).

Get recent risk level transitions — when positions moved between safe/warning/danger/critical states. Shows previous and new risk level, health factor at transition, and timestamp. Use when asked: 'Which positions recently became at risk?', 'Show me health factor drops on Polygon', 'Has wallet 0x... had any risk alerts?'.

Get liquidation events from the risk subgraph — includes collateral asset, debt asset, amounts, liquidator, and transaction hash. Complements get_aave_liquidations with risk-specific context. Use when asked: 'Show recent liquidations on Base', 'Was this wallet liquidated?', 'What collateral was seized?'.

Recover saved findings from the durable store — call this at the START of any monitoring workflow (e.g. cross_chain_risk_monitor) to re-orient after compaction or restart. Returns user-stated preferences, watchlists, and thresholds saved via note_finding. Treat returned findings as standing instructions for the session.

Get a user's full liquidation risk profile on a specific chain — all their positions with health factors, risk scores, collateral, and debt. Use when asked: 'Is wallet 0x... at risk of liquidation?', 'What's the health factor for this address on Base?', 'Show me this user's risk across all their Aave positions'.

Get Aave V4 asset details: total supplied/borrowed across all hubs, average supply/borrow APY, and current price. No API key needed.

Get historical price data for an Aave V4 asset. Powered by Chainlink oracles. No API key needed.

List all chains supported by Aave V4 (mainnet and testnet). No API key needed.

Get a user's claimable Merkl and points rewards on Aave V4. No API key needed.

Aave V4 config-change history: hub<->spoke caps/risk-premium threshold/active/halted snapshots, reserve config snapshots (collateralRisk, paused, frozen, borrowable), spoke liquidation config snapshots (targetHealthFactor 1e18, bonus factor bps) and the position-manager whitelist. Base by default.

Get exchange rate for any token via Aave V4's Chainlink oracle integration. Supports ERC-20 tokens, native tokens (ETH), and fiat currencies. Pass EITHER tokenAddress OR native:true. No API key needed.

Aave V4 hub assets with borrow rate (drawnRate as %), liquidity fee %, accrued protocol fees (human units), fee receiver, IR strategy and reinvestment controller. Base by default.

Aave V4 daily hub<->spoke flow totals per hub asset (supplied, withdrawn, borrowed, repaid, deficit, flow count), optionally with the raw recent flow events. Base by default.

Use this for Aave V4 Hub<->Spoke liquidity routing events that AaveKit's GraphQL API does NOT expose: Add, Remove, Draw, Restore, RefreshPremium, ReportDeficit, TransferShares. Returns event-level flow data enriched with human spoke names (Main, Bluechip, Kelp, Lido, Ethena Correlated, Ethena Ecosystem, EtherFi, Forex, Gold, Lombard) and asset symbols. Use when the user asks 'where is liquidity moving in V4', 'which spoke is draining the Hub', 'show me recent borrows on Main', or wants the routing primitive that V4's official API hides. Backed by aave-v4-omnigraph subgraph.

Get Aave V4 liquidity hubs (Core, Plus, Prime) with TVL, utilization, and supply/borrow caps. No API key needed.

Aave V4 liquidation event details with full premium-delta context. Look up by tx hash or by user address. Returns the spoke, collateral/debt reserves, exact amounts, the liquidator, and the premium-share/offset-ray deltas that V4 records for each liquidation. Use for: forensic analysis of a specific liquidation, building a user's liquidation history, or auditing liquidator behavior. Data AaveKit's REST API doesn't expose.

Get Aave V4 protocol-wide historical data: total deposits and borrows over time in USD. No API key needed.

Aave V4 liquidations from the subgraph (Base by default): liquidator, borrower, spoke, collateral/debt reserves, debt restored, collateral seized, shares moved and premium deltas, newest first, plus a per-liquidator count. Filter by liquidator or user. Not exposed by the official Aave V4 API.

Get Aave V4 reserves with supply/borrow APYs, risk params (collateral factor, caps), and status. Use get_aave_reserves for V2/V3. No API key needed. SIZE: unfiltered this returns every reserve (~31k tokens). Pass `symbols` for a named asset, or `compact: true` for rates only.

Aave V4 spoke liquidation-config history. Returns the current targetHealthFactor / healthFactorForMaxBonus / liquidationBonusFactor for a spoke and its full snapshot history (one row per governance update). Use for: auditing parameter drift, modeling how config changes affected liquidation behavior, governance-trail reporting. Data AaveKit's REST API doesn't expose.

Get Aave V4 spokes (Main, Bluechip, Kelp, Lido, Ethena, EtherFi, etc.). Spokes are chain-specific deployment points enabling cross-chain lending. No API key needed.

Get a read-only swap price quote from Aave V4 (powered by CoW Protocol with MEV protection). Returns pricing, fees, and slippage. No API key needed.

Aave V4 treasury events merged newest-first: FeeMint, Sweep, Reclaim, DeficitEliminated and spoke ReportDeficit, with per-type counts. Base by default.

Aave V4 treasury / fee-share / deficit accounting. Returns a merged stream of FeeMint, Sweep, Reclaim, and DeficitEliminated events ordered by block desc. Optionally filter by hub (Core/Plus/Prime) and time window. Use for: treasury reporting, fee-receiver attribution, identifying deficit events, monitoring reinvestment-controller activity. Data AaveKit's REST API doesn't expose.

Get a user's Aave V4 transaction history: supplies, borrows, withdrawals, repayments, liquidations, swaps. No API key needed.

Aave V4 per-user view from the subgraph: latest risk premium (ray), risk-premium history, liquidations suffered, and spoke activity (supply/withdraw/borrow/repay/collateral toggles). Base by default.

Get a user's cross-chain token balances in Aave V4 with highest supply APY and lowest borrow APY per token. No API key needed.

Get a user's Aave V4 borrow positions with principal, debt, interest. No API key needed.

Get a user's Aave V4 positions across all spokes — health factor, collateral, debt, borrowing power, net APY. Cross-chain by default. No API key needed.

Aave V4 per-user risk-premium history. Returns the user's risk-premium snapshots over time (one per RefreshPremium event), plus the latest premium and the spoke it was set on. Use for: agent-side modeling of a borrower's risk drift, identifying users approaching liquidation, or auditing premium accrual against AaveKit's aggregate risk view. Data AaveKit's REST API doesn't expose.

Get aggregated Aave V4 portfolio summary for a user: total positions, net balance, collateral, debt, net APY, lowest health factor. No API key needed.

Get a user's Aave V4 supply positions with principal, interest, and collateral status. No API key needed.

Use this when the user asks which AAVE chains are supported, wants to pick a network, or needs to discover available AAVE deployments. Returns all supported chains with their subgraph IDs, protocol version (V2/V3), chain name, 30-day query volume, and key entities. Chains: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, Fantom (V3 + V2 legacy), plus AAVE Governance V3. Always call this first if chain is ambiguous.

List saved findings with filters. Use get_session_state for the simple case; use this when you need tag or pagination filtering.

List all available liquidation risk subgraph chains with their names, networks, subgraph IDs, and 30-day query volumes. Use when asked: 'Which chains have liquidation risk data?', 'What risk subgraphs are available?'.

Persist a user-stated preference, watchlist entry, threshold, or any context that should survive conversation compaction and MCP restart. Examples: 'monitor wallet 0xabc... on Base and Arbitrum', 'ignore stETH HF dips above 1.5', 'alert only when collateral > $10k'. Returns the saved finding with an id. Call get_session_state at workflow start to recover saved findings.

Use this when a pre-built tool doesn't cover the user's need — execute a raw GraphQL query against any AAVE chain's subgraph. Use get_aave_schema first to explore available entities and fields. Lending schema entities: reserves, userReserves, borrows, supplies (V3) / deposits (V2), repays, liquidationCalls, flashLoans, pool, protocol, reserveParamsHistoryItems. Governance schema entities: proposals, proposalVotes_collection, payloads, votingPortals, votingConfigs, proposalMetadata_collection.

Use this when the user wants to simulate how a price change affects their AAVE health factor — 'What happens to my health factor if ETH drops 20%?', 'How much can WBTC fall before I get liquidated?', 'Simulate a 30% drop in my collateral asset'. Fetches the user's full position, computes current health factor, then recalculates it after applying the specified price change to the target asset. Health Factor < 1.0 means the position is liquidatable.