graph-lending-mcp

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

Related MCP server: graph-polymarket-mcp

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

graph-lending-mcp

graph-lending-mcp

Features

Tools

Setup

Prerequisites

Quick Start (npm)

Install From Source

Architecture

Subgraph Registry

License

Resources

Latest Blog Posts

MCP directory API