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.

• 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.

• Python: Version 3.10 or higher.
• uv: Package and virtual environment manager for Python (recommended for dependency management).

1. Clone the Repository:

   git clone https://github.com/kukapay/bridge-metrics-mcp.git
   cd bridge-metrics-mcp

1. Install dependencies:

   uv sync

1. 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"