graph-lending-mcp
graph-lending-mcp
一个 MCP 服务器,通过 The Graph 上 Messari 标准化的借贷子图 提供统一的 AI 友好型工具。
一个自然语言查询 → 分发至 15 条链上的 40 多个借贷协议 → 返回结构化、可比较的数据。
功能特性
19 个 MCP 工具:涵盖协议、市场、利率、头寸、事件、快照及跨协议分析
90 个子图部署:覆盖 15 条链(以太坊、Polygon、Arbitrum、Avalanche、BSC、Optimism、Base、Scroll、Fantom、Gnosis、Moonbeam 等)上的 40 多个借贷协议
跨协议比较 — 在一次调用中比较任意协议集的 TVL、收入和用户数
优雅的故障处理 — 失效的子图不会导致查询崩溃;故障会与成功结果一并报告
模式版本感知 — 自动为 v1.x、v2.x 和 v3.x 子图选择兼容的查询
Related MCP server: Stacks AI MCP Server
工具
工具 | 描述 |
| 列出所有已注册协议及其实时 TVL 数据 |
| 详细的协议统计信息(TVL、收入、用户、资金池数量) |
| 列出协议的市场,支持按任意字段排序 |
| 详细的单个市场数据,包括利率、上限和头寸 |
| 所有市场的利率,支持可选的侧边/类型过滤器 |
| 账户概览,包含头寸数量和活动记录 |
| 地址的未平仓头寸,支持可选的侧边过滤器 |
| 最近的存款事件,支持按市场和账户过滤 |
| 最近的借款事件 |
| 最近的还款事件 |
| 最近的取款事件 |
| 最近的清算事件,包含利润数据 |
| 最近的闪电贷事件 |
| 每日财务快照(TVL、交易量、收入) |
| 每日市场级快照,包含利率和活动数据 |
| 每日用户活动和交易计数 |
| 多个协议的并排比较 |
| 所有协议中 TVL 最高的市场,支持按网络过滤 |
| 针对任何已注册子图的原始 GraphQL 查询入口 |
设置
前置要求
Node.js 18+
来自 The Graph Studio 的 Graph API 密钥
快速开始 (npm)
{
"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 tsc然后添加到你的 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_tvl所有查询均使用 Messari 的 标准化借贷模式 —— 每个协议的实体和字段均保持一致。
子图注册表
请参阅 SUBGRAPHS.md 获取 90 个已注册子图部署的完整列表,包括其状态、网络、模式版本和备注。
许可证
MIT
Available Tools
19 toolscompare_protocolsARead-only
Compare multiple protocols side-by-side: TVL, deposits, borrows, revenue, users, pools. Sorted by TVL. Tolerates individual endpoint failures.
Inputs: protocols (required).
get_accountARead-only
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.
get_borrowsBRead-only
Recent borrow events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
get_daily_financialsARead-only
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.
get_depositsARead-only
Recent deposit events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
get_flashloansARead-only
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.
get_interest_ratesARead-only
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.
get_liquidationsARead-only
Recent liquidation events with liquidator, liquidatee, collateral asset, and profit amounts. Optionally filter by market.
Inputs: protocol (required), first, network, market_id.
get_marketARead-only
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.
get_marketsARead-only
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.
get_market_snapshotsARead-only
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.
get_positionsARead-only
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.
get_protocolARead-only
Detailed stats for a single lending protocol: TVL, deposits, borrows, revenue, user counts, transaction counts, pool counts, position counts.
Inputs: protocol (required), network.
get_repaysARead-only
Recent repay events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
get_usage_metricsBRead-only
Daily active user counts and transaction activity breakdown (deposits, borrows, repays, liquidations) for a protocol.
Inputs: protocol (required), days, network.
get_withdrawalsARead-only
Recent withdrawal events. Optionally filter by market ID and/or account address.
Inputs: protocol (required), first, account, network, +1 more.
list_protocolsARead-only
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.
query_subgraphARead-only
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.
top_markets_by_tvlARead-only
Global top N markets by TVL across ALL registered lending protocols. Fans out to every endpoint. Optionally filter by network.
Inputs: first, network.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
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.
Maintenance
Related MCP Connectors
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)
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceOfficial MCP server that turns The Graph’s Token API into a plug-and-play web3 data tool. Exposes ERC-20 & NFT metadata, balances, transfers, top-holder stats, prices, and more, allowing LLMs to run SQL queries on structured and indexed blockchain data.2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server providing unified access to over 144 tools for lending, trading, and staking across six major DeFi protocols on the Stacks Bitcoin Layer 2. It enables AI agents to perform complex blockchain operations and interact with the DeFi ecosystem using natural language commands.3MIT
- AlicenseAqualityDmaintenanceAn MCP server that powers AI agents with indexed blockchain data from The Graph.3MIT
- AlicenseBqualityCmaintenanceAn MCP server that enables querying Polymarket prediction market data through The Graph subgraphs. It provides tools for accessing market stats, trader P\&L, user positions, and orderbook activity using AI agents.35101 npm4MIT