MCP 服务器

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.

README

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

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

Install & Build

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

Configure 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_tvl

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