PaulieB14/graph-aave-mcp

Удаляет запись из долговременного хранилища по id. Используйте, когда пользователь отзывает ранее сохранённое предпочтение. Возвращает { removed: true|false }.

Используй этот инструмент, когда пользователь спрашивает: «Где мне разместить USDC для лучшей доходности?», «В какой сети самая низкая ставка заимствования WETH?», «Сравни ставки AAVE по сетям для USDC», «Лучшие ставки кредитования AAVE для DAI». Запрашивает все развёртывания AAVE параллельно для заданного актива, затем ранжирует по APY. Исключает Fantom (несовместимая схема Messari) и пропускает аномальные пулы. Возвращает таблицу с рейтингом: сеть, supply APY, variable borrow APY, utilization и примерную доступную ликвидность. Включает поле _recommendation с лучшим вариантом.

Используй этот инструмент, когда пользователь спрашивает о flash-кредитах AAVE — «Покажи недавние flash-кредиты на Ethereum», «Какие активы берут в flash-кредитах чаще всего?», «Сколько AAVE заработала на комиссиях за flash-кредиты?». Возвращает: адрес инициатора, заимствованный актив, сумму, уплаченную комиссию (totalFee) и временную метку. Flash-кредиты должны быть взяты и погашены в рамках одной транзакции.

Используйте это, когда пользователь спрашивает о событиях ликвидации AAVE: 'Покажи последние ликвидации на Ethereum', 'Был ли ликвидирован адрес 0x...?', 'Кто лучшие ликвидаторы на Arbitrum?', 'Какое обеспечение изымают чаще всего?'. Возвращает: адрес ликвидатора, ликвидированного пользователя, изъятый актив обеспечения, погашенный актив долга, суммы и метку времени. Ликвидации происходят, когда коэффициент здоровья пользователя падает ниже 1.0.

Используй это, когда пользователь спрашивает об активности погашения долгов AAVE — «Покажи последние погашения в Ethereum», «Погасил ли адрес 0x... какой-либо долг?», «Какие активы чаще всего погашаются в Arbitrum?», «Покажи историю погашений USDC». Возвращает события погашения с: адресом плательщика, активом, сырой суммой и временной меткой. Разделите сумму на 10^decimals для получения читаемого значения.

Используйте это, когда пользователь подробно спрашивает о конкретном активе AAVE — например: 'Расскажи всё о USDC на Ethereum AAVE', 'Какие параметры займа WETH?', 'Каков порог ликвидации для залога WBTC?'. Возвращает полную конфигурацию резерва: текущие ставки, TVL, LTV, параметры ликвидации, статистику за всё время (всего займов/погашений/ликвидаций) и адреса токенов. КОНВЕРТАЦИЯ СТАВОК: разделите liquidityRate / variableBorrowRate на 1e27 * 100 для получения APY в процентах.

Используйте это, когда пользователь спрашивает о рынках кредитования AAVE, доступных активах, APY поставки, APY заимствования, TVL, коэффициенте использования, коэффициентах обеспечения или порогах ликвидации на конкретной сети. Возвращает все активные резервы, отсортированные по общей ликвидности (TVL). КОНВЕРТАЦИЯ СТАВОК: liquidityRate и variableBorrowRate указаны в единицах RAY (1e27). APY поставки % = liquidityRate / 1e27 * 100. APY заимствования % = variableBorrowRate / 1e27 * 100. Суммы указаны в единицах нативного токена: разделите на 10^decimals, чтобы получить понятные человеку значения. Идеально подходит для: «Какие активы я могу предоставить на Arbitrum?», «Какая ставка поставки USDC на Base?», «Покажи все рынки AAVE V3 на Polygon».

Используйте это для интроспекции полной схемы GraphQL любого сабграфа сети AAVE. Возвращает все запрашиваемые корневые поля и их типы. Полезно перед написанием пользовательского вызова query_aave_subgraph или для понимания того, какие данные доступны на конкретной цепи/версии.

Используй это, когда пользователь спрашивает о позиции AAVE в кошельке: «Какой у меня показатель здоровья?», «Что я внес в AAVE?», «Сколько я занял?», «Есть ли риск ликвидации?», «Покажи моё обеспечение и долг на Arbitrum». Возвращает все внесённые активы (с балансами aToken), все занятые активы (переменный + фиксированный долг), флаги обеспечения и категорию e-mode. Показатель здоровья ≈ sum(обеспечение_i * цена_i * порог_ликвидности_i) / sum(долг_i * цена_i). HF < 1.0 = подлежит ликвидации. Суммы в нативных единицах токена — дели на 10^decimals.

Находит позиции Aave, подверженные риску ликвидации, на 5 сетях. Возвращает позиции с фактором здоровья, оценкой риска (0–100), уровнем риска (critical/danger/warning), суммой обеспечения и долга. Используйте, когда спрашивают: 'Какие позиции близки к ликвидации на Arbitrum?', 'Покажи самые рискованные позиции Aave на Base', 'Сколько критических позиций?'

Получите обзор кросс-чейн рисков по всем 5 цепочкам (Ethereum, Arbitrum, Base, Polygon, Optimism) одним вызовом. Возвращает статистику рисков на уровне протокола для каждой цепочки: общее количество позиций, количество danger/warning/critical. Используйте, когда спрашивают: 'Which chain has the most at-risk positions?', 'Give me a risk dashboard across all chains', 'Compare Aave risk levels across networks'.

Используйте это, когда пользователь спрашивает об управлении AAVE: «Покажи последние предложения по управлению AAVE», «Какие предложения сейчас активны?», «Каков статус предложения AAVE #X?», «Покажи активность голосования по управлению». Запрашивает подграф AAVE Governance V3 в сети Ethereum. Возвращает: ID предложения, создатель, уровень доступа (1=short executor/2=long executor), текущее состояние, длительность голосования (в секундах), голоса за/против, заголовок и информацию о полезной нагрузке. Состояния предложений: Created=0, Active=1, Queued=2, Executed=3, Failed=4, Cancelled=5, Expired=6.

Получает историю изменения Health Factor пользователя по времени: показывает, как менялся риск блок за блоком. Полезно для анализа трендов и понимания, ухудшается ли позиция. Используйте, когда спрашивают: «Как изменился Health Factor этого кошелька?», «Становится ли эта позиция рискованнее со временем?», «Покажи тренд Health Factor для 0x...».

Ончейн-чтение одного резерва в реальном времени через AaveProtocolDataProvider — текущие ставки (APY по депозитам, переменным и стабильным ставкам), общие суммы (aToken, стабильный и переменный долг), индексы, плюс конфигурация (LTV, порог/бонус ликвидации, резервный фактор, флаги активен/заморожен), адреса токенов (aToken/sDebt/vDebt) и лимиты. Авторитетный снимок текущего блока для одного актива.

Прямое on-chain чтение состояния аккаунта пользователя в Aave V3 через Pool.getUserAccountData. Возвращает health factor текущего блока, общее обеспечение/долг (в базовых единицах, 8 знаков после запятой), доступные займы, текущий порог ликвидации и LTV. Используйте это ПЕРЕД тем, как сообщать о «критической» или «подлежащей ликвидации» позиции на основе данных subgraph — subgraph отстаёт от вершины цепочки на N блоков, и позиция, оценённая как CRITICAL в индексе, может уже быть ликвидирована (или больше не под риском). Ответ включает as_of.block, так что свежесть данных сохраняется при сжатии контекста.

Используйте это, когда пользователь спрашивает об итогах голосования по конкретному предложению AAVE — «Как проголосовали по предложению #X?», «Покажи расклад за/против по предложению #185», «Прошло ли предложение #X?». Возвращает сводные итоги голосования: общее количество голосов «за» и «против» по предложению. Примечание: голоса отдельных участников в этом подграфе не индексируются.

Получить сводную статистику рисков для Aave на сети — общее количество позиций и сколько из них в опасном, предупреждающем или критическом состоянии. Используйте, когда спрашивают: 'Насколько здоров Aave на Ethereum сейчас?', 'Сколько позиций под риском на Arbitrum?', 'Дайте обзор рисков протокола'.

Используй это, когда пользователь спрашивает о недавней активности заимствований на AAVE: «Кто брал USDC в долг на Ethereum?», «Покажи последние займы WETH на Arbitrum», «Что недавно взял адрес 0x...?», «Покажи объём займов по активам». Возвращает события заимствований с: адрес заёмщика, актив, сырое количество, ставка заимствования, режим ставки (variable=2/stable=1) и временная метка. Разделите количество на 10^decimals для получения значения в удобном для чтения виде.

Используйте этот инструмент, когда пользователь спрашивает о недавних депозитах или пополнениях ликвидности на AAVE. Примеры: «Кто поставлял ETH на Base?», «Покажи недавние депозиты USDC на Polygon», «Что адрес 0x... недавно внес?». Сети V3 используют сущность 'supply', сети V2 используют 'deposit' — автоматически подбирается. Возвращает: адрес поставщика, символ актива, сырое количество и временную метку. Чтобы получить человекочитаемое значение, делите количество на 10^decimals.

Используйте это, когда пользователь спрашивает об исторических ставках AAVE или трендах TVL: «Как менялась ставка по депозитам USDC с течением времени?», «Покажи историю ставки по займам ETH в Polygon», «Каким был коэффициент использования на прошлой неделе?». Возвращает снапшоты с метками времени: liquidityRate, variableBorrowRate, stableBorrowRate, utilizationRate, availableLiquidity, totalLiquidity, totalCurrentVariableDebt. Ставки указаны в единицах RAY (разделите на 1e27 * 100, чтобы получить APY в %). Получите ID резерва из get_aave_reserves (поле 'id' = underlyingAsset + poolAddress).

Получает недавние переходы уровней риска — когда позиции перемещались между состояниями safe/warning/danger/critical. Показывает предыдущий и новый уровень риска, health factor в момент перехода и временную метку. Используйте, когда спрашивают: 'Какие позиции недавно стали рискованными?', 'Покажи падения health factor на Polygon', 'Были ли у кошелька 0x... предупреждения о риске?'.

Получает события ликвидаций из subgraph рисков — включает залоговый актив, долговой актив, суммы, ликвидатора и хеш транзакции. Дополняет get_aave_liquidations контекстом рисков. Используйте, когда спрашивают: 'Показать недавние ликвидации на Base', 'Был ли этот кошелек ликвидирован?', 'Какое обеспечение было изъято?'.

Восстановите сохранённые находки из долговременного хранилища — вызывайте это в НАЧАЛЕ любого мониторингового рабочего процесса (например, cross_chain_risk_monitor), чтобы переориентироваться после уплотнения или перезапуска. Возвращает предпочтения пользователя, списки наблюдения и пороговые значения, сохранённые через note_finding. Относитесь к возвращённым находкам как к постоянным инструкциям для сеанса.

Получает полный профиль риска ликвидации пользователя на конкретной сети - все его позиции с показателями здоровья, оценками риска, обеспечением и долгом. Используйте по запросам: «Кошелёк 0x... под угрозой ликвидации?», «Какой показатель здоровья у этого адреса на Base?», «Покажи риски этого пользователя по всем его позициям в Aave».

Получает данные об активах Aave V4: общие суммы предоставленных и заимствованных средств по всем хабам, среднюю годовую процентную ставку (APY) по депозитам и кредитам, а также текущую цену актива. Ключ API не требуется. Не вызывайте этот инструмент более 3 раз для одного вопроса.

Получить исторические данные о цене актива Aave V4. Работает на оракулах Chainlink. Ключ API не требуется.

Перечисли все сети, поддерживаемые Aave V4 (основная сеть и тестовые сети). API-ключ не требуется.

Получить доступные к получению награды Merkl и баллы пользователя на Aave V4. Ключ API не требуется.

Получает обменный курс для любого токена через интеграцию с оракулом Chainlink в Aave V4. Поддерживает токены ERC-20, нативные токены (ETH) и фиатные валюты. API-ключ не требуется.

Используйте это для событий маршрутизации ликвидности Hub<->Spoke в Aave V4, которые GraphQL API AaveKit НЕ раскрывает: Add, Remove, Draw, Restore, RefreshPremium, ReportDeficit, TransferShares. Возвращает данные о потоках на уровне событий, дополненные читаемыми названиями spoke (Main, Bluechip, Kelp, Lido, Ethena Correlated, Ethena Ecosystem, EtherFi, Forex, Gold, Lombard) и символами активов. Используйте, когда пользователь спрашивает «куда движется ликвидность в V4», «какой spoke забирает ликвидность из Hub», «покажи недавние займы на Main» или хочет получить примитив маршрутизации, который скрывает официальный API V4. Работает на основе aave-v4-omnigraph subgraph.

Получить пулы ликвидности Aave V4 (Core, Plus, Prime) с TVL, загрузкой и лимитами поставки/заимствования. API-ключ не требуется.

Детали события ликвидации Aave V4 с полным контекстом премии и дельты. Поиск по хешу транзакции или адресу пользователя. Возвращает spoke, резервы залога/долга, точные суммы, ликвидатора и дельты премиум-доли/offset-ray, которые V4 записывает для каждой ликвидации. Используется для: судебного анализа конкретной ликвидации, построения истории ликвидаций пользователя или аудита поведения ликвидатора. Данные, которые REST API AaveKit не предоставляет.

Получите исторические данные по всему протоколу Aave V4: общую сумму депозитов и займов с течением времени в долларах США. Ключ API не требуется.

Получить резервы Aave V4 с APY по депозитам/займам, параметрами риска (коэффициент залога, лимиты) и статус. Используйте get_aave_reserves для V2/V3. Ключ API не требуется.

Aave V4 spoke — история конфигурации ликвидаций. Возвращает текущие targetHealthFactor, healthFactorForMaxBonus и liquidationBonusFactor для spoke, а также полную историю снимков (одна строка на каждое обновление управления). Используется для: аудита дрейфа параметров, моделирования того, как изменения конфигурации повлияли на поведение ликвидаций, отслеживания цепочки решений управления. Данные, которые REST API AaveKit не отдаёт.

Получите Aave V4 spokes (Main, Bluechip, Kelp, Lido, Ethena, EtherFi и др.). Spokes — это точки развертывания на конкретных блокчейнах, которые обеспечивают кроссчейн-кредитование. Ключ API не нужен.

Получите ценовую котировку обмена только для чтения от Aave V4 (на базе CoW Protocol с защитой MEV). Возвращает цены, комиссии и проскальзывание. Ключ API не нужен.

Учет казначейства, распределения комиссий и дефицита Aave V4. Возвращает объединенный поток событий FeeMint, Sweep, Reclaim и DeficitEliminated, отсортированный по блокам в порядке убывания. Опционально фильтруется по хабу (Core/Plus/Prime) и временному окну. Используется для: отчетности по казначейству, атрибуции получателей комиссий, выявления событий дефицита, мониторинга активности контроллера реинвестирования. Данные, которые REST API AaveKit не предоставляет.

Получите историю транзакций пользователя Aave V4: вклады, займы, выводы, погашения, ликвидации, обмены. API-ключ не требуется.

Получает кросс-чейн балансы токенов пользователя в Aave V4 с самой высокой ставкой доходности по депозитам и самой низкой по займам для каждого токена. API-ключ не требуется.

Получает позиции пользователя по займам Aave V4 с основной суммой, задолженностью и процентами. Не требуется ключ API.

Получает позиции пользователя в Aave V4 по всем спокам - коэффициент здоровья, обеспечение, долг, кредитная мощность, чистая APY. По умолчанию кросс-чейн. API-ключ не требуется.

История индивидуальной риск-премии пользователей Aave V4. Возвращает снимки риск-премии пользователя во времени (по одному на событие RefreshPremium), а также последнюю премию и спок, на котором она была установлена. Используйте для: моделирования изменения кредитного риска заёмщика на стороне агента, выявления пользователей, приближающихся к ликвидации, или аудита начисления премии по сравнению с агрегированным представлением риска AaveKit. Данные, которые REST API AaveKit не раскрывает.

Получить агрегированную сводку портфеля Aave V4 для пользователя: общее количество позиций, чистый баланс, обеспечение, долг, чистый APY, наименьший health factor. Ключ API не требуется.

Получает позиции поставки пользователя Aave V4 с основной суммой, процентами и статусом залога. API-ключ не нужен.

Используй этот инструмент, когда пользователь спрашивает, какие сети поддерживает AAVE, хочет выбрать сеть или узнать доступные развертывания AAVE. Возвращает все поддерживаемые сети с их идентификаторами подграфов (subgraph), версией протокола (V2/V3), названием сети, объемом запросов за 30 дней и ключевыми сущностями. Сети: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, Fantom (V3 + унаследованная V2), а также AAVE Governance V3. Всегда вызывай этот инструмент первым, если сеть не ясна.

Перечисляет сохранённые находки с фильтрацией. Используйте get_session_state для простого случая; используйте этот инструмент, когда нужна фильтрация по тегам или постраничная навигация.

Выведи список всех доступных цепочек подграфа риска ликвидации с их названиями, сетями, идентификаторами подграфов и объёмами запросов за 30 дней. Используй, когда спрашивают: "Which chains have liquidation risk data?", "What risk subgraphs are available?".

Сохраняет указанное пользователем предпочтение, запись в списке отслеживания, пороговое значение или любой контекст, который должен пережить сжатие диалога и перезапуск MCP. Примеры: 'отслеживать кошелек 0xabc... в сетях Base и Arbitrum', 'игнорировать просадки stETH HF выше 1.5', 'предупреждать только если залог > $10k'. Возвращает сохраненную запись с идентификатором. В начале рабочего процесса вызывайте get_session_state, чтобы восстановить сохраненные записи.

Используйте это, когда готовая утилита не покрывает потребность пользователя — выполните сырой GraphQL-запрос к подграфу любой цепочки AAVE. Сначала вызовите get_aave_schema, чтобы изучить доступные сущности и поля. Сущности схемы кредитования: reserves, userReserves, borrows, supplies (V3) / deposits (V2), repays, liquidationCalls, flashLoans, pool, protocol, reserveParamsHistoryItems. Сущности схемы управления: proposals, proposalVotes_collection, payloads, votingPortals, votingConfigs, proposalMetadata_collection.

Используйте это, когда пользователь хочет смоделировать, как изменение цены повлияет на его health factor в AAVE — «Что будет с моим health factor, если ETH упадёт на 20%?», «Насколько может упасть WBTC до моей ликвидации?», «Смоделируй падение залогового актива на 30%». Получает полную позицию пользователя, вычисляет текущий health factor, затем пересчитывает его после применения указанного изменения цены к целевому активу. Health Factor < 1.0 означает, что позиция может быть ликвидирована.