graph-aave-mcp

npm version MCP Registry License: MIT

MCP-сервер для AAVE V2, V3 и V4 — 40 инструментов для 16 подграфов The Graph + API Aave V4.

Охватывает рынки кредитования, позиции пользователей, коэффициенты здоровья, мониторинг риска ликвидации между сетями, ликвидации, флэш-кредиты, управление, хабы/споуки V4, обменные курсы, котировки свопов, вознаграждения и историю протокола.

Опубликовано в MCP Registry как io.github.PaulieB14/graph-aave-mcp

Три источника данных

Источник	Версия	Что предоставляет	Авторизация
Подграфы The Graph	V2/V3	11 подграфов в 7 сетях — резервы, позиции, события, управление	`GRAPH_API_KEY` (бесплатно)
Подграфы риска ликвидации	V3	5 сетей — коэффициенты здоровья в реальном времени, оценки риска, оповещения, статистика риска протокола	`GRAPH_API_KEY` (бесплатно)
API Aave V4	V4	Хабы, споуки, резервы, обменные курсы, позиции пользователей, активность, котировки свопов, вознаграждения	Не требуется

Related MCP server: Aave Liquidation MCP Server

Быстрый старт

# 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

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

Бесплатный ключ Graph API: thegraph.com/studio (бесплатный уровень на 100 тыс. запросов в месяц).

Хостинг (без установки): Fronteir AI

Инструменты V2/V3 (подграфы The Graph)

15 инструментов + 1 для выполнения произвольных запросов. Требуется GRAPH_API_KEY.

Обнаружение

Инструмент	Описание
`list_aave_chains`	Все поддерживаемые сети с ID подграфов, версиями и объемом запросов за 30 дней
`get_aave_schema`	Полная интроспекция схемы GraphQL для любой сети

Рынки кредитования

Инструмент	Описание
`get_aave_reserves`	Все активные рынки — TVL, APY по депозитам/займам, LTV, пороги ликвидации
`get_aave_reserve`	Подробная информация об одном активе: статистика за все время, конфигурация, адреса токенов
`get_reserve_rate_history`	Исторические данные APY, использования и снимки TVL

Позиции пользователей

Инструмент	Описание
`get_aave_user_position`	Активы кошелька (депозиты/займы), флаги обеспечения, e-mode
`simulate_health_factor`	Моделирование изменения цены и влияния на коэффициент здоровья пользователя

События протокола

Инструмент	Описание
`get_recent_borrows`	Последние займы — фильтрация по пользователю или активу
`get_recent_supplies`	Последние депозиты (автоматическая обработка схем V2 и V3)
`get_aave_repays`	Последние погашения
`get_aave_liquidations`	Последние ликвидации — фильтрация по пользователю или ликвидатору
`get_aave_flash_loans`	Последние флэш-кредиты с комиссиями

Управление

Инструмент	Описание
`get_governance_proposals`	Предложения с заголовками, статусами и количеством голосов
`get_proposal_votes`	Детализация голосов по каждому участнику в зависимости от силы голоса

Дополнительно

Инструмент	Описание
`query_aave_subgraph`	Произвольный GraphQL — выполнение любого запроса к любой сети

Поддерживаемые сети (V2/V3)

Сеть	Версия	Запросы за 30д
Ethereum	V3	21.6M
Base	V3	5.6M
Arbitrum	V3	5.6M
Polygon	V3	2.0M
Optimism	V3	1.8M
Avalanche	V3	1.2M
Ethereum	V2	701K
Polygon	V2	216K
Avalanche	V2	133K
Fantom	V3 (Messari)	13K
Ethereum	Governance V3	486K

Инструменты риска ликвидации (НОВИНКА)

8 инструментов на базе специализированных подграфов риска в 5 сетях. Требуется GRAPH_API_KEY.

Мониторинг риска ликвидации в реальном времени с коэффициентами здоровья, оценками риска (0–100), классификацией уровней риска (безопасно/предупреждение/опасно/критично) и сводками риска между сетями.

Мониторинг риска

Инструмент	Описание
`get_at_risk_positions`	Позиции под угрозой ликвидации — фильтрация по уровню риска, сортировка по оценке риска
`get_user_risk_profile`	Полный профиль риска для кошелька — все позиции с коэффициентами здоровья и оценками риска
`get_protocol_risk_stats`	Агрегированная статистика: общее количество позиций, количество позиций в зонах риска
`get_cross_chain_risk_summary`	Обзор риска по всем 5 сетям в одном запросе

События риска

Инструмент	Описание
`get_risk_alerts`	Переходы между уровнями риска — когда позиции меняют статус
`get_risk_liquidations`	События ликвидации с указанием активов обеспечения/долга, сумм и хешей транзакций
`get_health_factor_history`	Динамика коэффициента здоровья для конкретного кошелька

Обнаружение

Инструмент	Описание
`list_risk_chains`	Доступные сети с данными о риске ликвидации, ID подграфов и объемами запросов

Поддерживаемые сети (риск ликвидации)

Сеть	Запросы за 30д	Сигнал
Ethereum	21.1K	20.2K GRT
Arbitrum	19.3K	35.7K GRT
Base	16.2K	15.2K GRT
Polygon	13.2K	—
Optimism	13.0K	—

Инструменты V4 (API Aave)

16 инструментов на базе api.aave.com/graphql. API-ключ не требуется.

Модель ликвидности

Инструмент	Описание
`get_v4_hubs`	Хабы ликвидности (Core, Plus, Prime) с TVL и использованием
`get_v4_spokes`	Межсетевые споуки (Main, Bluechip, Kelp, Lido, Ethena, EtherFi, Forex, Gold, Lombard)
`get_v4_reserves`	Резервы по споукам с APY, параметрами риска и лимитами
`get_v4_chains`	Поддерживаемые сети V4
`get_v4_asset`	Сводка по активу между хабами с усредненными APY и ценой
`get_v4_exchange_rate`	Цена любого токена через оракулы Chainlink (ERC-20, нативные или фиат)
`get_v4_asset_price_history`	Исторические цены токенов
`get_v4_protocol_history`	Общие депозиты/займы за все время

Данные пользователя

Инструмент	Описание
`get_v4_user_positions`	Межсетевые позиции — коэффициент здоровья, обеспечение, долг, лимит займа
`get_v4_user_summary`	Агрегированный портфель: общие позиции, чистый баланс, чистый APY
`get_v4_user_supplies`	Позиции депозитов с основной суммой и процентами
`get_v4_user_borrows`	Позиции займов с разбивкой долга
`get_v4_user_balances`	Межсетевые балансы токенов с лучшими APY для каждого токена
`get_v4_user_activities`	История транзакций: депозиты, займы, погашения, ликвидации, свопы
`get_v4_claimable_rewards`	Доступные к получению вознаграждения Merkl и баллы
`get_v4_swap_quote`	Котировка свопа (только чтение) через CoW Protocol (защита от MEV)

Архитектура V4

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 обеспечивает межсетевое кредитование: депозит в одном споуке, заем в другом. Хабы агрегируют ликвидность между споуками.

Готовые сценарии

7 встроенных рабочих процессов, которые помогают агентам выполнять многошаговый анализ:

Сценарий	Описание
`analyze_aave_user`	Полный анализ кошелька: позиции, коэффициент здоровья, риск ликвидации
`aave_chain_overview`	Обзор протокола: топовые рынки, ставки, недавняя активность
`compare_aave_rates`	Сравнение APY для одного актива во всех сетях
`aave_liquidation_analysis`	Паттерны ликвидации, топовые ликвидаторы, рынки в зоне риска
`aave_governance_overview`	Последние предложения, результаты голосования, активные решения
`aave_full_stack_analysis`	Сравнение версий: ставки и позиции V2 vs V3 vs V4
`cross_chain_risk_monitor`	НОВИНКА — Межсетевой риск ликвидации: самые рискованные позиции, оповещения, здоровье протокола

Примеры вопросов

Риск ликвидации (новое):

"Какие позиции Aave на Arbitrum ближе всего к ликвидации?"
"Дай мне дашборд межсетевого риска — в какой сети больше всего позиций в зоне риска?"
"Находится ли кошелек 0x... под угрозой ликвидации в какой-либо сети?"
"Покажи последние оповещения о риске — какие позиции стали критическими?"
"Как менялся коэффициент здоровья этого кошелька на Base с течением времени?"

V4:

"Какие хабы Aave V4 существуют и каково их использование?"
"Покажи резервы V4 с самым высоким APY по депозитам"
"Какова текущая цена ETH в Aave V4?"
"Сравни ставки по депозитам USDC в V3 и V4"
"Какие споуки есть у Aave V4 в сети Ethereum?"

V2/V3:

"Какие рынки AAVE на Ethereum имеют наибольший TVL?"
"Сравни ставки по займам WETH во всех сетях V3"
"Проанализируй позицию AAVE для кошелька 0x..."
"Если цена ETH упадет на 30%, будет ли ликвидирован адрес 0x...?"
"Покажи последние 20 ликвидаций в сети Ethereum"
"Какие предложения по управлению AAVE сейчас активны?"

Разработка

git clone https://github.com/PaulieB14/graph-aave-mcp.git
cd graph-aave-mcp
npm install
npm run build
GRAPH_API_KEY=your-key node build/index.js

Лицензия

MIT

Graph AAVE MCP

graph-aave-mcp

Три источника данных

Быстрый старт

Инструменты V2/V3 (подграфы The Graph)

Обнаружение

Рынки кредитования

Позиции пользователей

События протокола

Управление

Дополнительно

Поддерживаемые сети (V2/V3)

Инструменты риска ликвидации (НОВИНКА)

Мониторинг риска

События риска

Обнаружение

Поддерживаемые сети (риск ликвидации)

Инструменты V4 (API Aave)

Модель ликвидности

Данные пользователя

Архитектура V4

Готовые сценарии

Примеры вопросов

Разработка

Лицензия

Resources

Latest Blog Posts

MCP directory API