Graph Lending

MCP server that exposes unified AI-friendly tools over Messari's standardized lending subgraphs on The Graph.

One natural-language query → fan out across 40+ lending protocols on 15 chains → get back structured, comparable data.

Features

• 19 MCP tools covering protocols, markets, rates, positions, events, snapshots, and cross-protocol analytics
• 90 subgraph deployments across 40+ lending protocols on 15 chains (Ethereum, Polygon, Arbitrum, Avalanche, BSC, Optimism, Base, Scroll, Fantom, Gnosis, Moonbeam, and more)
• Cross-protocol comparison — compare TVL, revenue, users across any set of protocols in one call
• Graceful failure handling — dead subgraphs don't crash queries; failures are reported alongside successes
• Schema-version aware — automatically selects compatible queries for v1.x, v2.x, and v3.x subgraphs

Tools

Tool	Description
list_protocols	List all registered protocols with live TVL data
get_protocol	Detailed protocol stats (TVL, revenue, users, pool counts)
get_markets	List markets for a protocol, sorted by any field
get_market	Detailed single market data including rates, caps, and positions
get_interest_rates	Interest rates across all markets, with optional side/type filters
get_account	Account overview with position counts and activity
get_positions	Open positions for an address, with optional side filter
get_deposits	Recent deposit events, filterable by market and account
get_borrows	Recent borrow events
get_repays	Recent repay events
get_withdrawals	Recent withdrawal events
get_liquidations	Recent liquidation events with profit data
get_flashloans	Recent flashloan events
get_daily_financials	Daily financial snapshots (TVL, volume, revenue)
get_market_snapshots	Daily market-level snapshots with rates and activity
get_usage_metrics	Daily user activity and transaction counts
compare_protocols	Side-by-side comparison of multiple protocols
top_markets_by_tvl	Top markets across all protocols, optionally filtered by network
query_subgraph	Raw GraphQL escape hatch for any registered subgraph

Setup

Prerequisites

• Node.js 18+
• A Graph API key from The Graph Studio

Quick Start (npm)

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

Install From Source

git clone https://github.com/PaulieB14/graph-lending-mcp.git
cd graph-lending-mcp
npm install
npx tsc

Then add to your claude_desktop_config.json:

{
  "mcpServers": {
    "graph-lending": {
      "command": "node",
      "args": ["/path/to/graph-lending-mcp/dist/index.js"],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Architecture

src/
├── index.ts          # MCP server entry — registers all 19 tools
├── registry.ts       # Protocol → subgraph ID mapping (see SUBGRAPHS.md)
├── client.ts         # GraphQL fetch with retry, timeout, fan-out
├── queries.ts        # All GraphQL query constants
└── tools/
    ├── protocol.ts   # list_protocols, get_protocol
    ├── markets.ts    # get_markets, get_market
    ├── rates.ts      # get_interest_rates
    ├── positions.ts  # get_account, get_positions
    ├── events.ts     # deposits, borrows, repays, withdrawals, liquidations, flashloans
    ├── snapshots.ts  # daily_financials, market_snapshots, usage_metrics
    └── cross.ts      # compare_protocols, top_markets_by_tvl

All queries use Messari's standardized lending schema — same entities and fields across every protocol.

Subgraph Registry

See SUBGRAPHS.md for the full list of 90 registered subgraph deployments with their status, network, schema version, and notes.

License

MIT