Agents Index

Aave MCP

OnlineOfficial

Official Aave MCP for V3 and V4 markets, positions, governance, and transaction preparation.

Visit publisherConnectJSON

What it can do: 56 tools

  • get_chains read-onlyList chains Aave supports, on v3, v4, or both. A chain carrying 'notServed': true is one this API holds no market on: every market, position and rewards read comes back empty for it, and that emptiness says nothing about
  • get_markets read-onlyList Aave markets/reserves (symbol, APY, caps, liquidity) on v3, v4, or both. Chain coverage: omit chainId and every response states the chains it read as 'chainsCovered', plus 'chainsNotCovered' when it read fewer than
  • get_emode_categories read-onlyv3 only. eMode groups correlated assets (ETH-correlated, stablecoins) so they borrow against each other at a higher LTV, raising borrowing power at the cost of restricting which assets the position may hold. Returns each
  • get_user_positions read-onlyA wallet's Aave positions (supplies and borrows) on v3, v4, or both. Omit chainId and both versions cover every chain they serve, stating which under 'chainsCovered'; there is no need to loop over chains yourself. 'chain
  • get_position_items read-onlyv4 only. The individual supplies or borrows inside one v4 spoke: principal, accrued interest and what is withdrawable right now, per item, which the per-spoke aggregate from get_user_positions cannot show. Each item's po
  • get_user_summary read-onlyA wallet's aggregate position and health factor. Omit chainId and both versions cover every chain they serve, stating which under 'chainsCovered'; there is no need to loop over chains yourself. 'chainsNotServed', when pr
  • get_transaction_processed read-onlyv4 only. After sending a transaction, ask whether the Aave API has processed it. Use this instead of sleeping or polling an RPC: the API lags the chain, and prepare_action will not issue a dependent follow-up (the supply
  • get_reserve_details read-onlyDeep detail for a single reserve (rates, caps, risk parameters, utilisation, the interest-rate curve, token addresses) on v3 or v4. Every rate and percentage is a percent ('3.32' means 3.32%), named with a Pct suffix. On
  • get_apy_history read-onlyHistorical supply or borrow APY for a reserve over time, on v3 or v4. Returns a time-series of {date, apyPct}, where apyPct is a percent ('3.32' means 3.32%). Each point is an average over its sampling interval, and the
  • get_user_activity read-onlyA wallet's Aave transaction history (supply, borrow, repay, withdraw, collateral changes) on v3, v4, or both. Most recent first. v4 covers every chain; v3 reads one market on one chain at a time, because upstream paginat
  • get_protocol_history read-onlyv4 only. Aave v4 protocol-wide history: market size, total borrows and available liquidity per sample over a window. Omit chainId to cover every supported v4 chain. Use this for 'is the protocol growing', not for one wal
  • get_user_summary_history read-onlyv4 only. How one wallet's net worth, supplied, debt and health factor moved over a window on Aave v4. Use it to answer 'how has my position changed' or to see how close to liquidation a wallet has been. Omit chainId to c
  • get_hubs read-onlyv4 only. Aave v4 hubs: a hub holds the liquidity and global accounting that user-facing spokes draw from. Returns each hub's hubId, address, chain and totals. Pass a hubId to get_hub_assets for the assets it carries. Omi
  • get_hub_assets read-onlyv4 only. The assets held by one Aave v4 hub, with hub-wide supplied and borrowed totals, rates and utilisation. Get hubId from get_hubs (or the hubAddress on get_reserve_details). This is hub-level accounting; for what a
  • get_market_history read-onlyv4 only. Deposits, borrows, available liquidity and utilisation over a window, for one hub or one spoke. Pick the layer deliberately: a hub is the liquidity itself and answers 'is this market growing', a spoke is one ven
  • get_asset_history read-onlyv4 only. One asset across every v4 reserve that holds it: 'price' is its oracle price per sample, 'supply' and 'borrow' are the amounts plus the APY spread across those reserves (averageApyPct with the highest and lowest
  • get_reserve_holders read-onlyv4 only. The biggest wallets supplying or borrowing one v4 reserve, largest first, for questions about concentration: whether one address is most of a reserve's liquidity, or most of its debt. The token is named once for
  • get_interest_rate_model read-onlyv4 only. The rate curve for one hub asset: borrow and supply APY at each level of utilisation, as points along the curve the protocol actually uses. This explains a rate rather than reporting it - where the kink sits, ho
  • get_wallet_balances read-onlyv4 only. The tokens a wallet actually holds that v4 can take, per token and summed across chains, with 'perChain' saying where each sits, plus the best supply APY and lowest borrow APY the protocol currently offers on th
  • get_risk_premium read-onlyv4 only. The per-collateral breakdown of one position's risk premium: how much of the position each token is, and the weight the protocol charges for it. 'currentRiskPremiumWeightPct' is the weight in force now and 'late
  • get_spoke_configs read-onlyv4 only. Per-asset limits for one (hub, spoke) pair: supply and borrow caps, whether the asset is active there, whether it is halted, and the risk premium threshold. Read it before sizing a large position, because a cap
  • get_multichain_asset read-onlyv4 only. One asset across every v4 chain at once, by symbol: what is supplied and borrowed on each, the rate on each, and a summary naming the best supply rate and the lowest borrow rate anywhere. This is the tool for 'w
  • prepare_liquidation read-onlyBuild an unsigned transaction to liquidate an unhealthy position: repay part of someone else's debt and receive their collateral plus the liquidation bonus. Only viable while that position's health factor is below 1 (che
  • prepare_set_emode read-onlyv3 only. Build an unsigned transaction to switch a wallet's Aave v3 eMode category. eMode groups correlated assets (ETH-correlated, stablecoins) so they borrow against each other at a higher LTV, raising borrowing power
  • prepare_action read-onlyBuild an unsigned transaction to supply, borrow, withdraw, or repay on Aave (v3 or v4). Returns an execution plan (a transaction to sign, or an approval step first). For a borrow or a withdraw, call preview_action first
  • prepare_set_collateral read-onlyBuild an unsigned transaction to change whether a supplied asset is used as collateral (v3 or v4). On v4 'enable' sets the state; on v3 it toggles the current state, and a toggle that would invert a stated 'enable' is re
  • preview_action read-onlySimulate a supply/borrow/withdraw/repay against a wallet's position WITHOUT executing, on v3 or v4 - or, v4 only, a quoted order that moves a position: a leverage, a position swap or a repay-with-supply. Always do this b
  • get_swappable_tokens read-onlyNo version argument: token swaps are protocol-agnostic and run on the v4 backend, so they cover the chains that backend serves rather than every chain Aave has a market on. Call this before get_swap_quote to see where a
  • get_swap_quote read-onlyNo version argument: token swaps are protocol-agnostic and run on the v4 backend, so the chains and tokens they cover are that backend's and not every chain Aave holds a market on - a chain it does not serve is rejected
  • get_position_swap_quote read-onlyv4 only. Quote swapping one Aave v4 position for another, atomically and without leaving the protocol: kind=supply swaps collateral for a different collateral asset, kind=borrow swaps one debt for another. Both sides are
  • get_repay_with_supply_quote read-onlyv4 only. Quote paying down a borrow using supplied collateral, atomically and without the funds leaving Aave. 'debtPosition' is the borrow to reduce, a positionItemId from get_position_items with side=borrow whose 'quota
  • get_leverage_quote read-onlyv4 only. Quote opening or increasing a leveraged position in one atomic order: the debt reserve is flash-loaned, swapped into the collateral reserve and supplied, and the debt is drawn against it to repay the flash loan.
  • prepare_order read-onlyNo version argument: every order runs on the v4 backend. One prepare for every product - a token swap, position swap, repay-with-supply or leverage quoteId all come here. Which optional arguments apply is decided by the
  • submit_signed_orderNo version argument: every order runs on the v4 backend. Relay an order the user already signed (quoteId + signature from prepare_order's PreparedOrder). State-changing: this posts the order. The server never signs.
  • prepare_cancel_order read-onlyNo version argument. From an orderId, return the EIP-712 cancellation for the user to sign; cancel_order relays the result. This is the gasless route for an intent order; an order that went on chain (a native-token sell)
  • cancel_orderNo version argument. Cancel an open order. Two routes: pass 'signature' (signed over what prepare_cancel_order returned) to relay a gasless cancellation - state-changing, and the route an intent order takes; omit 'signat
  • get_order_status read-onlyNo version argument. Status of an order by id: open, pending signature, fulfilled, cancelled or expired, with the operation it performs and an explorer link. 'order' comes back null when the API cannot see that id, which
  • get_pending_orders read-onlyNo version argument: orders run on the v4 backend, so this covers the chains that backend serves and names them under 'chainsCovered'; a chain under 'chainsNotCovered' could not be read and is worth asking about again. A
  • get_user_rewards read-onlyA wallet's claimable Aave rewards on v3, v4, or both. Covers incentive programmes distributed through Merit as well as the protocol's own, so a GHO or sGHO incentive shows up here rather than anywhere separate. Omit chai
  • prepare_claim_rewards read-onlyv4 only. Build an unsigned transaction to claim a wallet's V4 rewards. If 'ids' is omitted, claims everything currently claimable. Non-custodial. There is no v3 equivalent because a v3 claim needs no second call: get_use

…and 16 more.

Connect it

Claude Code
claude mcp add --transport http aave-mcp https://mcp.aave.com
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://mcp.aave.com
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "aave-mcp": {
      "url": "https://mcp.aave.com"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "aave-mcp": {
      "type": "http",
      "url": "https://mcp.aave.com"
    }
  }
}

Questions

What does Aave MCP do?

Official Aave MCP for V3 and V4 markets, positions, governance, and transaction preparation. It exposes 56 tools to AI assistants.

What tools does Aave MCP provide?

56 tools, including get_chains, get_markets, get_emode_categories, get_user_positions, get_position_items, get_user_summary, get_transaction_processed, get_reserve_details, get_apy_history, get_user_activity, get_protocol_history, get_user_summary_history….

How do I connect Aave MCP to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://mcp.aave.com as a custom connector or MCP server. Copy-paste setup is on this page.

Does Aave MCP require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Aave MCP online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Aave MCP?

aave.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in E-commerce & Shopping