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 multiple chains → get back structured, comparable data.
Features
19 MCP tools covering protocols, markets, rates, positions, events, snapshots, and cross-protocol analytics
40+ lending protocols across Ethereum, Polygon, Arbitrum, Avalanche, BSC, Optimism, Base, 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 all registered protocols with live TVL data |
| Detailed protocol stats (TVL, revenue, users, pool counts) |
| List markets for a protocol, sorted by any field |
| Detailed single market data including rates, caps, and positions |
| Interest rates across all markets, with optional side/type filters |
| Account overview with position counts and activity |
| Open positions for an address, with optional side filter |
| Recent deposit events, filterable by market and account |
| Recent borrow events |
| Recent repay events |
| Recent withdrawal events |
| Recent liquidation events with profit data |
| Recent flashloan events |
| Daily financial snapshots (TVL, volume, revenue) |
| Daily market-level snapshots with rates and activity |
| Daily user activity and transaction counts |
| Side-by-side comparison of multiple protocols |
| Top markets across all protocols, optionally filtered by network |
| Raw GraphQL escape hatch for any registered subgraph |
Setup
Prerequisites
Node.js 18+
A Graph API key from The Graph Studio
Install & Build
git clone https://github.com/PaulieB14/graph-lending-mcp.git
cd graph-lending-mcp
npm install
npx tscConfigure in Claude Desktop
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_tvlAll queries use Messari's standardized lending schema — same entities and fields across every protocol.
Subgraph Registry
See SUBGRAPHS.md for the full list of registered subgraphs with their status, network, schema version, and notes.
License
MIT