Graph Aave Mcp

Name: Graph Aave Mcp
Author: paulieb14

by paulieb14communityv1.0.0

MCP server for Aave V2, V3, and V4 that exposes Graph subgraph data and the Aave V4 API for lending markets, user positions, governance, liquidations, flash loans, and protocol history. It also includes liquidation-risk monitoring tools across multiple chains with health factors, risk scores, and alerts.

From the registry: AAVE V2/V3 lending & governance MCP — 7 chains via The Graph subgraphs

GitHub Repository

Install & configure

Prerequisites

required
Graph API key
Free API key from The Graph Studio (100K queries/month)
https://thegraph.com/studio/

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `graph-aave-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Graph API key** — Free API key from The Graph Studio (100K queries/month) (https://thegraph.com/studio/)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","graph-aave-mcp"]
- required environment variables:
  - `GRAPH_API_KEY`: The Graph API key for V2/V3 subgraph and liquidation risk tools (V4 tools work without it) (example: `<your-graph-api-key>`)

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Tools (39)

list_aave_chains

Lists supported Aave chains with subgraph IDs, versions, and query volumes.

get_aave_schema

Returns GraphQL schema introspection for a chosen chain.

get_aave_reserves

Lists active lending markets with TVL, APY, LTV, and liquidation thresholds.

get_aave_reserve

Returns detailed information for a single reserve asset.

get_reserve_rate_history

Shows historical APY, utilization, and TVL snapshots for a reserve.

get_aave_user_position

Shows a wallet's supplied and borrowed assets, collateral flags, and e-mode.

simulate_health_factor

Simulates how price changes affect a user's health factor.

get_recent_borrows

Lists recent borrow events, optionally filtered by user or asset.

get_recent_supplies

Lists recent supply/deposit events.

get_aave_repays

Lists recent repayment events.

get_aave_liquidations

Lists recent liquidation events, optionally filtered by user or liquidator.

get_aave_flash_loans

Lists recent flash loan events with fees.

get_governance_proposals

Environment variables

GRAPH_API_KEYrequiredAPI key used for The Graph subgraph tools and liquidation risk tools.

Packages

graph-aave-mcp

npmv1.0.0transport: stdio

Details

Language: JavaScript
License: MIT
Released: Mar 4, 2026
Last commit: Jun 11, 2026
Registry name: io.github.PaulieB14/graph-aave-mcp

Related Servers

Edgartools

Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.

2.6k

edgar.tools SEC Intelligence

SEC filing intelligence — insider sentiment, material events, financial ratios, disclosure search.

2.6k

Mcp Stripe

MCP server for Stripe — global payments API (PaymentIntents, Checkout, Billing, Refunds)

1.6k

Lists governance proposals with titles, states, and vote counts.

get_proposal_votes

Shows per-voter breakdown for a governance proposal.

query_aave_subgraph

Executes a raw GraphQL query against a selected chain.

get_at_risk_positions

Lists positions at risk of liquidation, filterable by risk level.

get_user_risk_profile

Returns a full risk profile for a wallet across positions.

get_protocol_risk_stats

Returns aggregate risk statistics for the protocol.

get_cross_chain_risk_summary

Returns a cross-chain liquidation risk overview.

get_risk_alerts

Lists risk level transition alerts.

get_risk_liquidations

Lists liquidation events with collateral, debt, amounts, and transaction hashes.

get_health_factor_history

Shows health factor trends over time for a wallet.

list_risk_chains

Lists supported liquidation-risk chains with subgraph IDs and query volumes.

get_v4_hubs

Lists Aave V4 liquidity hubs with TVL and utilization.

get_v4_spokes

Lists Aave V4 spokes across chains.

get_v4_reserves

Lists V4 reserves with APYs, risk params, and caps.

get_v4_chains

Lists supported Aave V4 chains.

get_v4_asset

Returns a cross-hub asset summary with average APYs and price.

get_v4_exchange_rate

Returns a token price via Chainlink oracles.

get_v4_asset_price_history

Shows historical token prices.

get_v4_protocol_history

Shows total deposits and borrows over time.

get_v4_user_positions

Returns cross-chain positions with health factor, collateral, debt, and borrowing power.

get_v4_user_summary

Returns an aggregated portfolio summary.

get_v4_user_supplies

Lists supply positions with principal and interest.

get_v4_user_borrows

Lists borrow positions with debt breakdown.

get_v4_user_balances

Lists cross-chain token holdings with best APYs per token.

get_v4_user_activities

Returns transaction history including supplies, borrows, repays, liquidations, and swaps.

get_v4_claimable_rewards

Returns claimable Merkl and points rewards.

get_v4_swap_quote

Returns read-only swap pricing via CoW Protocol.