This server provides unified AI-friendly access to 40+ DeFi lending protocols across multiple blockchains via Messari's standardized subgraphs on The Graph.
Protocol & Market Data
List protocols — Browse all supported protocols with TVL, borrow totals, and network info; filter by network or schema version
Get protocol details — Full stats including revenue, user counts, transaction counts, and TVL
Get markets — Top markets for a protocol ordered by TVL or borrow balance, with rates, caps, and LTV thresholds
Get single market — Deep-dive into a specific market by contract address
Interest Rates
Get interest rates — Current supply and borrow APRs across all markets, filterable by side (LENDER/BORROWER) or rate type (VARIABLE/STABLE/FIXED)
Account & Positions
Get account summary — Open/closed position counts, deposit/borrow/liquidation history for a wallet
Get positions — Open positions for a wallet, filterable by side (COLLATERAL or BORROWER)
Transaction Events
Deposits, borrows, repays, withdrawals — filterable by market or account
Liquidations — with liquidator, liquidatee, collateral asset, and profit data
Flashloans — including fee amounts
Historical Snapshots & Metrics
Daily financials — Protocol-level daily snapshots of TVL, volume, and revenue (up to 365 days)
Market snapshots — Daily snapshots for a specific market including price, TVL, volume, and rates history
Usage metrics — Daily active user counts and transaction activity for a protocol
Cross-Protocol Analytics
Compare protocols — Side-by-side comparison of 2–20 protocols sorted by TVL, with graceful handling of individual endpoint failures
Top markets by TVL — Global top N markets across all registered protocols, optionally filtered by network
Advanced
Raw GraphQL queries — Execute custom GraphQL queries against any registered lending subgraph for exploratory or advanced use cases
Supports Ethereum, Polygon, Arbitrum, Avalanche, BSC, Optimism, Base, and more, with automatic handling of subgraph schema versions (v1.x, v2.x, v3.x).
Provides access to standardized lending protocol data on the Ethereum network, enabling the retrieval of TVL, revenue, interest rates, and account positions.
Offers a raw GraphQL interface to query Messari's standardized lending subgraphs on The Graph for advanced protocol and market analytics.
Enables querying of lending protocol data on the Optimism network, including cross-protocol comparisons of TVL, revenue, and usage metrics.
Allows interaction with lending protocols on the Polygon network to fetch detailed market data, snapshots, and transaction events.
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.
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: Stacks AI MCP Server
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 |
Node.js 18+
A Graph API key from The Graph Studio
{
"mcpServers": {
"graph-lending": {
"command": "npx",
"args": ["graph-lending-mcp"],
"env": {
"GRAPH_API_KEY": "your-api-key-here"
}
}
}
}git clone https://github.com/PaulieB14/graph-lending-mcp.git
cd graph-lending-mcp
npm install
npx tscThen 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"
}
}
}
}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.
See SUBGRAPHS.md for the full list of 90 registered subgraph deployments with their status, network, schema version, and notes.
MIT
Compare multiple protocols side-by-side: TVL, deposits, borrows, revenue, users, pools. Sorted by TVL. Tolerates individual endpoint failures.
Inputs: protocols (required).
Account summary for a wallet address: open/closed position counts, deposit/borrow/liquidation activity, and list of current open positions.
Inputs: address (required), protocol (required), network.
Recent borrow events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
Protocol-level daily snapshots: TVL, deposit/borrow/liquidation volume, and revenue breakdown (supply-side vs protocol-side). Returns last N days.
Inputs: protocol (required), days, network.
Recent deposit events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
Recent flashloan events including fee amounts. Only available for v3+ schema protocols (e.g. aave-v3, compound-v3, spark-lend).
Inputs: protocol (required), first, network.
Current supply and borrow APRs across all markets in a protocol. Optionally filter by side (LENDER/BORROWER) or rate type (VARIABLE/STABLE/FIXED).
Inputs: protocol (required), side, type, network.
Recent liquidation events with liquidator, liquidatee, collateral asset, and profit amounts. Optionally filter by market.
Inputs: protocol (required), first, network, market_id.
Deep-dive on a single market by its on-chain contract address. Returns balances, cumulative stats, position counts, risk parameters, rates, and rewards. Get market IDs from get_markets first.
Inputs: protocol (required), market_id (required), network.
List markets (lending pools) for a protocol, ordered by TVL or borrows. Returns token, rates, caps, LTV thresholds, and reward info.
Inputs: protocol (required), first, network, order_by.
Daily snapshots for a specific market: token price, TVL, volume, revenue, rates history, and active user counts.
Inputs: protocol (required), market_id (required), days, network.
Open positions for a wallet address with balances, market prices, and activity counts. Optionally filter by side.
Inputs: address (required), protocol (required), side, first, +1 more.
Detailed stats for a single lending protocol: TVL, deposits, borrows, revenue, user counts, transaction counts, pool counts, position counts.
Inputs: protocol (required), network.
Recent repay events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
Daily active user counts and transaction activity breakdown (deposits, borrows, repays, liquidations) for a protocol.
Inputs: protocol (required), days, network.
Recent withdrawal events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
List all supported lending protocols with live TVL, deposit/borrow totals, pool counts, and user counts. Fans out to all registered subgraph endpoints. Optionally filter by network or schema version.
Inputs: network, schema_version.
Execute a raw GraphQL query against any registered lending subgraph. Use for custom filters, uncommon fields, or exploratory queries. All subgraphs use the Messari standardized lending schema with entities: lendingProtocols, markets, accounts, positions, deposits, borrows, repays, withdraws, liquidates, flashloans, financialsDailySnapshots, marketDailySnapshots, usageMetricsDailySnapshots.
Inputs: query (required), protocol (required), network, variables.
Global top N markets by TVL across ALL registered lending protocols. Fans out to every endpoint. Optionally filter by network.
Inputs: first, network.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 19 tools
Each tool has a clearly distinct purpose, targeting specific entities (protocols, markets, events, accounts) or actions (list, get, compare, query). There is no ambiguity; even similar-sounding tools like get_market and get_markets are differentiated by singular vs plural and depth of data.
All tools follow a consistent verb_noun pattern using snake_case (e.g., get_markets, list_protocols, query_subgraph). Minor deviations like compare_protocols and top_markets_by_tvl still adhere to the same pattern, ensuring predictability.
19 tools is on the higher end but appropriate for the comprehensive scope of lending protocol data. Each tool covers a specific aspect (protocols, markets, events, analytics) without redundancy, justifying the count.
The tool set provides full coverage for a read-only lending data API: protocol listing and details, market analysis, event history (deposits, borrows, etc.), account positions, aggregated financials, usage metrics, interest rates, comparisons, and raw GraphQL access. No obvious gaps for the intended domain.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Pay-per-call DeFi and macro intel for AI agents. x402 USDC tools via streamable HTTP /api/mcp.
The Graph MCP — indexed blockchain data via subgraph GraphQL queries
DefiLlama MCP — DeFi analytics from DefiLlama (free, no auth)