# io.github.PaulieB14/graph-aave-mcp (npm · graph-aave-mcp)

AAVE V2/V3 lending & governance MCP — 7 chains via The Graph subgraphs

- Trust score: 66/100 (medium)
- Change this week: +15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `graph-aave-mcp`: 66/100 (this document), [markdown](https://verifymcp.io/servers/paulieb14-graph-aave-mcp/graph-aave-mcp.md), [page](https://verifymcp.io/servers/paulieb14-graph-aave-mcp/graph-aave-mcp)

## Channel facts

- Registry: `npm`
- Package: `graph-aave-mcp`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 53 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 79/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2291 tokens (~163/item across 14 items; 14 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add paulieb14-graph-aave-mcp -- npx -y graph-aave-mcp
```

### Codex

```bash
codex mcp add paulieb14-graph-aave-mcp -- npx -y graph-aave-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "paulieb14-graph-aave-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "graph-aave-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add paulieb14-graph-aave-mcp --command npx --arg -y --arg graph-aave-mcp
```

### Hermes

```yaml
mcp_servers:
  paulieb14-graph-aave-mcp:
    command: "npx"
    args: ["-y", "graph-aave-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "paulieb14-graph-aave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "graph-aave-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 66, +22)

- [security regression] Provenance: fail → unverified
- [security regression] Install scripts: pass → unverified
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Capabilities: pass → unverified
- [functional regression] License: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Maintenance: pass → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: MIT

### 2026-08-01 (score 44, −10)

- [security regression] Known CVEs: partial → unverified
- [functional regression] Dependency health: partial → unverified

### 2026-07-31 (score 54, +21)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 33, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 51)

First indexed and scored.

## MCP tools (14)

### `list_aave_chains` (~113 tokens)

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.

### `get_aave_reserves` (~232 tokens)

Use this when the user asks about AAVE lending markets, available assets, supply APY, borrow APY, TVL, utilization rate, collateral factors, or liquidation thresholds on a specific chain. Returns all active reserves sorted by total liquidity (TVL). RATE CONVERSION: liquidityRate and variableBorrowRate are in RAY units (1e27). Supply APY % = liquidityRate / 1e27 * 100. Borrow APY % = variableBorrowRate / 1e27 * 100. Amounts are in native token units — divide by 10^decimals for human-readable. Ideal for: 'What assets can I lend on Arbitrum?', 'What is USDC supply rate on Base?', 'Show me all AAVE V3 markets on Polygon'.

Input parameters:

- `chain` (string, required): Chain identifier (e.g. ethereum, base, arbitrum, polygon, optimism, avalanche). Use list_aave_chains to see all options.
- `includeInactive` (boolean): Set true to include frozen, paused, or inactive reserves. Default false (active only).

### `get_aave_reserve` (~166 tokens)

Use this when the user asks about a specific AAVE asset in detail — e.g. 'Tell me everything about USDC on Ethereum AAVE', 'What are the WETH borrow parameters?', 'What is the liquidation threshold for WBTC collateral?'. Returns full reserve config: current rates, TVL, LTV, liquidation parameters, lifetime stats (total borrows/repayments/liquidations), and token addresses. RATE CONVERSION: divide liquidityRate / variableBorrowRate by 1e27 * 100 for APY %.

Input parameters:

- `chain` (string, required): Chain identifier
- `symbol` (string, required): Token symbol — case-insensitive (e.g. USDC, WETH, WBTC, DAI, USDT, LINK, AAVE)

### `get_aave_user_position` (~185 tokens)

Use this when the user asks about a wallet's AAVE position — 'What is my health factor?', 'What have I supplied to AAVE?', 'How much have I borrowed?', 'Am I at risk of liquidation?', 'Show me my collateral and debt on Arbitrum'. Returns all supplied assets (with aToken balances), all borrowed assets (variable + stable debt), collateral flags, and e-mode category. Health Factor ≈ sum(collateral_i * price_i * liqThreshold_i) / sum(debt_i * price_i). HF < 1.0 = liquidatable. Amounts in native token units — divide by 10^decimals.

Input parameters:

- `chain` (string, required): Chain identifier
- `userAddress` (string, required): Ethereum wallet address of the user (0x..., lowercase). Returns empty arrays if address has no AAVE positions.

### `simulate_health_factor` (~195 tokens)

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.

Input parameters:

- `assetSymbol` (string, required): Symbol of the asset whose price changes (e.g. WETH, WBTC, USDC)
- `chain` (string, required): Chain identifier
- `priceChangePct` (number, required): Price change percentage — negative for drops, positive for gains. E.g. -20 means the asset price falls 20%.
- `userAddress` (string, required): Wallet address of the user (0x...)

### `get_recent_borrows` (~183 tokens)

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.

Input parameters:

- `chain` (string, required): Chain identifier
- `first` (number): Number of borrow events to return (1–100, default 20)
- `reserveSymbol` (string): Optional: filter by asset symbol (e.g. USDC, WETH, DAI)
- `userAddress` (string): Optional: filter by borrower Ethereum address (0x...)

### `get_recent_supplies` (~179 tokens)

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.

Input parameters:

- `chain` (string, required): Chain identifier
- `first` (number): Number of supply events to return (1–100, default 20)
- `reserveSymbol` (string): Optional: filter by asset symbol (e.g. USDC, WETH, WBTC)
- `userAddress` (string): Optional: filter by supplier address (0x...)

### `get_aave_liquidations` (~167 tokens)

Use this when the user asks about AAVE liquidation events — 'Show me recent liquidations on Ethereum', 'Has address 0x... been liquidated?', 'Who are the top liquidators on Arbitrum?', 'What collateral is being seized most?'. Returns: liquidator address, liquidated user, collateral asset seized, debt asset repaid, amounts, and timestamp. Liquidations occur when a user's health factor drops below 1.0.

Input parameters:

- `chain` (string, required): Chain identifier
- `first` (number): Number of liquidation events to return (1–100, default 20)
- `liquidator` (string): Optional: filter by liquidator address
- `userAddress` (string): Optional: filter by the address that was liquidated

### `get_aave_flash_loans` (~119 tokens)

Use this when the user asks about AAVE flash loans — 'Show me recent flash loans on Ethereum', 'What assets are flash-loaned most?', 'How much in flash loan fees has AAVE earned?'. Returns: initiator address, asset borrowed, amount, fee paid (totalFee), and timestamp. Flash loans must be borrowed and repaid within a single transaction.

Input parameters:

- `chain` (string, required): Chain identifier
- `first` (number): Number of flash loan events to return (1–100, default 20)

### `get_reserve_rate_history` (~193 tokens)

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).

Input parameters:

- `chain` (string, required): Chain identifier
- `first` (number): Number of historical snapshots to return (default 30)
- `reserveId` (string, required): Reserve ID — from get_aave_reserves 'id' field (concatenation of underlyingAsset address + pool address, lowercase)

### `get_governance_proposals` (~212 tokens)

Use this when the user asks about AAVE governance — 'Show me recent AAVE governance proposals', 'What proposals are currently active?', 'What is the status of AAVE proposal #X?', 'Show me governance voting activity'. Queries the AAVE Governance V3 subgraph on Ethereum. Returns: proposal ID, creator, access level (1=short executor/2=long executor), current state, voting duration (seconds), for/against votes, title, and payload info. Proposal states: Created=0, Active=1, Queued=2, Executed=3, Failed=4, Cancelled=5, Expired=6.

Input parameters:

- `first` (number): Number of proposals to return (1–50, default 10)
- `state` (number): Optional: filter by state number. 0=Created, 1=Active, 2=Queued, 3=Executed, 4=Failed, 5=Cancelled, 6=Expired

### `get_proposal_votes` (~113 tokens)

Use this when the user asks about votes on a specific AAVE governance proposal — 'Who voted on proposal #X?', 'Show me the voting breakdown for this proposal', 'Which addresses voted against?'. Returns individual votes with: voter address, voting power, support (true=for/false=against), and timestamp.

Input parameters:

- `first` (number): Number of votes to return (default 50)
- `proposalId` (string, required): AAVE governance proposal ID (numeric string, e.g. '185')

### `query_aave_subgraph` (~155 tokens)

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.

Input parameters:

- `chain` (string, required): Chain identifier (includes 'governance')
- `query` (string, required): GraphQL query string
- `variables` (object): Optional GraphQL variables

### `get_aave_schema` (~79 tokens)

Use this to introspect the full GraphQL schema for any AAVE chain's subgraph. Returns all queryable root fields and their types. Useful before writing a custom query_aave_subgraph call, or to understand what data is available on a specific chain/version.

Input parameters:

- `chain` (string, required): Chain identifier (includes 'governance')

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/paulieb14-graph-aave-mcp/graph-aave-mcp#diagnostics

## Score history

- 2026-08-03: 66
- 2026-08-02: 66
- 2026-08-01: 44
- 2026-07-31: 54
- 2026-07-30: 33
- 2026-07-28: 51
- 2026-07-27: 51

## Links

- npm package: https://www.npmjs.com/package/graph-aave-mcp
- Socket report: https://socket.dev/npm/package/graph-aave-mcp
- Repository: https://github.com/PaulieB14/graph-aave-mcp
- Changelog RSS feed: https://verifymcp.io/servers/paulieb14-graph-aave-mcp/graph-aave-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/paulieb14-graph-aave-mcp/graph-aave-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/paulieb14-graph-aave-mcp/graph-aave-mcp