bridge-metrics-mcp
An MCP server that provides real-time cross-chain bridge metrics.
Documentation
Bridge Metrics MCP
An MCP server that provides real-time cross-chain bridge metrics, enabling AI agents to analyze liquidity, transaction flows, and performance across blockchain networks.
Features
- List Chains: Retrieve a list of all chain slugs from DeFiLlama, sorted by Total Value Locked (TVL) in descending order.
- List Bridges: Fetch all bridges, optionally including chain breakdowns, sorted by 24-hour volume.
- Historical Volumes: Get historical volume data for a bridge or chain, with dates formatted as `YYYY-MM-DD HH:MM:SS`.
- Daily Token Stats: Retrieve 24-hour token volume breakdowns, including token ID, symbol, decimals, deposit/withdrawal amounts, and USD values, sorted by deposit USD value.
- Bridge Transactions: Fetch transaction summaries for a specific bridge, with details like transaction hash, timestamp, and USD value.
- Prompts: Includes example prompts for analyzing bridge volumes and comparing bridges based on metrics like weekly volume.
Prerequisites
- Python: Version 3.10 or higher.
- uv: Package and virtual environment manager for Python (recommended for dependency management).
Installation
1. Clone the Repository:
git clone https://github.com/kukapay/bridge-metrics-mcp.git
cd bridge-metrics-mcp2. Install dependencies:
uv sync3. Install to Claude Desktop:
Install the server as a Claude Desktop application:
uv run mcp install main.py --name "Bridge Metrics"Configuration file as a reference:
{
"mcpServers": {
"Bridge Metrics": {
"command": "uv",
"args": [ "--directory", "/path/to/bridge-metrics-mcp", "run", "main.py" ]
}
}
}Replace `/path/to/bridge-metrics-mcp` with your actual installation path.
Tools and Usage
The server provides the following tools, accessible via JSON-RPC or natural language prompts in compatible clients:
1. `list_chains`:
2. `list_bridges`:
3. `get_historical_volumes`:
4. `get_day_stats`:
5. `get_transactions`:
6. Prompts:
Example Interactions
Below are example interactions using natural language prompts in a compatible MCP client, along with expected results.
Example 1: Listing All Chains
Prompt:
List all chains available on DeFiLlama.Tool Called: `list_chains`
Result:
+----------------+-------------+---------------+-----------+-------------+
| Name | Gecko ID | Token Symbol | Chain ID | TVL |
+================+=============+===============+===========+=============+
| Ethereum | ethereum | ETH | 1 | 50000000000 |
| Binance Smart | binance-smart-chain | BNB | 56 | 15000000000 |
| Polygon | polygon | MATIC | 137 | 5000000000 |
+----------------+-------------+---------------+-----------+-------------+Example 2: Listing Bridges with Chains
Prompt:
Show all bridges with their supported chains, sorted by 24-hour volume.Tool Called: `list_bridges(include_chains=True)`
Result:
+----+-------------+---------------+-----------------+----------------------------------+
| ID | Name | Display Name | Last 24h Volume | Chains |
+====+=============+===============+=================+==================================+
| 1 | polygon | Polygon | 1000000 | Ethereum, Polygon, Binance Smart |
| 2 | optimism | Optimism | 750000 | Ethereum, Optimism |
| 3 | arbitrum | Arbitrum | 500000 | Ethereum, Arbitrum |
+----+-------------+---------------+-----------------+----------------------------------+Example 3: Historical Volumes for a Chain
Prompt:
Get historical volumes for the Ethereum chain.Tool Called: `get_historical_volumes(chain="ethereum")`
Result:
+---------------------+---------------+---------------+---------------+---------------+
| Date | Deposit USD | Withdraw USD | Deposit Txs | Withdraw Txs |
+=====================+===============+===============+===============+===============+
| 2025-09-12 00:00:00 | 1000000.0 | 500000.0 | 150 | 100 |
| 2025-09-11 00:00:00 | 1200000.0 | 600000.0 | 180 | 120 |
| 2025-09-10 00:00:00 | 900000.0 | 450000.0 | 130 | 90 |
+---------------------+---------------+---------------+---------------+---------------+Example 4: Daily Token Stats for a Bridge
Prompt:
Show the 24-hour token stats for bridge ID 1 on Ethereum for September 12, 2025.Tool Called: `get_day_stats(timestamp=1752499200, chain="ethereum", bridge_id=1)`
Result:
+----------------+--------+----------+------------------+-------------------+------------------+-------------------+
| Token ID | Symbol | Decimals | Deposit Amount | Deposit USD Value | Withdraw Amount | Withdraw USD Value|
+================+========+==========+==================+===================+==================+===================+
| 0xa0b869... | USDC | 6 | 2000000 | 2000000.0 | 0 | 0.0 |
| 0xc02aaa... | ETH | 18 | 1000000000000000 | 1500000.0 | 500000000000000 | 750000.0 |
| 0xdac17f... | DAI | 18 | 0 | 0.0 | 1000000000000000 | 1000000.0 |
+----------------+--------+----------+------------------+-------------------+------------------+-------------------+Example 5: Analyzing Bridge Volume
Prompt:
Analyze the volume data for the Polygon bridge using historical volumes.Tool Called: `get_historical_volumes(chain="polygon", bridge_id=1)`, followed by `analyze_bridge_volume`
Result:
Analyze the following volume data for the bridge 'Polygon':
+---------------------+---------------+---------------+---------------+---------------+
| Date | Deposit USD | Withdraw USD | Deposit Txs | Withdraw Txs |
+=====================+===============+===============+===============+===============+
| 2025-09-12 00:00:00 | 800000.0 | 400000.0 | 120 | 80 |
| 2025-09-11 00:00:00 | 900000.0 | 450000.0 | 140 | 90 |
| 2025-09-10 00:00:00 | 700000.0 | 350000.0 | 100 | 70 |
+---------------------+---------------+---------------+---------------+---------------+
Key insights:
- The Polygon bridge shows consistent deposit and withdrawal activity over the past three days.
- Deposits are roughly double the withdrawals in USD value, indicating higher inflow than outflow.
- Transaction counts are stable, with deposits averaging 120 transactions per day.License
This project is licensed under the MIT License. See the LICENSE file for details.
Frequently asked questions
What is bridge-metrics-mcp?
bridge-metrics-mcp is An MCP server that provides real-time cross-chain bridge metrics.
How do I install bridge-metrics-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is bridge-metrics-mcp open source?
Yes — it is hosted on GitHub at https://github.com/kukapay/bridge-metrics-mcp and has 2 stars.
Related MCP tools
openhands🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.
mem0Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.
chatgpt-on-wechat基于大模型搭建的聊天机器人，同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入，可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI，能处理文本、语音和图片，访问操作系统和互联网，支持基于自有知识库进行定制企业智能客服。
gpt-researcherAn LLM agent that conducts deep research (local and web) on any given topic and generates a long report with citations. Built for the Model Context Protocol to
fastmcp🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.
maxkb🔥 MaxKB is an open-source platform for building enterprise-grade agents. MaxKB 是强大易用的开源企业级智能体平台。 for the Model Context Protocol. Enhance AI assistants with po
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP