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.

Subgraph Registry

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

License

MIT