wormhole-metrics-mcp

An MCP server that analyzes cross-chain activity on the Wormhole protocol.

0 stars PythonOthers Updated Jun 19, 2025

Documentation

Wormhole Metrics MCP

An MCP server that analyzes cross-chain activity on the Wormhole protocol, providing insights into transaction volumes, top assets, source-destination chain pairs, and key performance indicators (KPIs).

Features

Comprehensive Tools: Includes tools for cross-chain activity, money flow, top assets, chain pairs, symbols, token corridors, and KPIs.
Markdown Output: Returns data as Markdown-formatted tables for clear presentation.

Installation

Prerequisites

Python 3.10 or higher
uv (recommended package manager)

Setup

1. Clone the Repository

bash

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

2. Install Dependencies

bash

uv sync

3. Installing to Claude Desktop:

Install the server as a Claude Desktop application:

bash

uv run mcp install main.py --name "Wormhole Metrics"

Configuration file as a reference:

json

{
       "mcpServers": {
           "Wormhole Metrics": {
               "command": "uv",
               "args": [ "--directory", "/path/to/wormhole-metrics-mcp", "run", "main.py" ]
           }
       }
    }

Replace `/path/to/wormhole-metrics-mcp` with your actual installation path.

Usage

The `wormhole-metrics-mcp` server exposes several tools via the MCP interface. Below is an overview of the tools and their usage.

Tools

1. get_cross_chain_activity

markdown

| source_chain | Solana | Ethereum | Base       |
       |--------------|--------|---------|------------|
       | Mantle       | 23.545 |         |            |
       | Polygon      |        | 245951  | 747048     |

2. get_money_flow

markdown

| from                 | to                   | source_chain | volume            | count |
       |----------------------|----------------------|--------------|-------------------|-------|
       | 2025-01-01T00:00:00Z | 2025-01-02T00:00:00Z | Solana       | 346085661921482   | 550   |
       | 2025-01-02T00:00:00Z | 2025-01-03T00:00:00Z | Solana       | 1915450117554795  | 747   |

3. get_top_assets_by_volume

markdown

| emitter_chain | symbol | token_chain | token_address                            | volume         |
       |---------------|--------|-------------|------------------------------------------|----------------|
       | Solana        | WBTC   | Ethereum    | 0000000000000000000000002260fac5e5542a773aa44fbcfedf7c193bc2c599 | 25101807.78824 |
       | Ethereum      | RNDR   | Ethereum    | 0000000000000000000000006de037ef9ad2725eb40118bb1702ebb27e4aeb24 | 9829032.688    |

4. get_top_chain_pairs_by_num_transfers

markdown

| source_chain | destination_chain | number_of_transfers |
       |--------------|-------------------|---------------------|
       | Optimism     | Solana            | 2849                |
       | Ethereum     | Solana            | 2466                |
       | Base         | Arbitrum          | 1993                |

5. get_top_symbols_by_volume

markdown

| symbol | volume          | txs |
       |--------|-----------------|-----|
       | WBTC   | 28434555.496489 | 133 |
       | RNDR   | 9829032.688     | 49  |
       | WETH   | 9662352.854166  | 60  |

6. get_top100_corridors

markdown

| source_chain | target_chain | token_chain | token_address                            | txs |
       |--------------|--------------|-------------|------------------------------------------|-----|
       | Optimism     | Solana       | Optimism    | 000000000000000000000000ef4461891dfb3ac8572ccf7c794664a8dd927945 | 2777|
       | Base         | Arbitrum     | Base        | 000000000000000000000000271cdba25be9be2e024bc0a550012b2e5934420e | 1892|

7. get_kpi_list

markdown

| 24h_messages | total_messages | total_tx_count | total_volume       | tvl         | 24h_volume   | 7d_volume    | 30d_volume    |
       |--------------|----------------|----------------|--------------------|-------------|--------------|--------------|---------------|
       | 192987       | 1111114235     | 6023755        | 60718344331.570806 | 2582546224  | 22688586.172 | 252786937.009| 1349155202.545|

License

This project is licensed under the MIT License. See the LICENSE file for details.

Frequently asked questions

What is wormhole-metrics-mcp?

wormhole-metrics-mcp is An MCP server that analyzes cross-chain activity on the Wormhole protocol.

How do I install wormhole-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 wormhole-metrics-mcp open source?

Yes — it is hosted on GitHub at https://github.com/kukapay/wormhole-metrics-mcp.

Related MCP tools

cognee

Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.

30,433 Python

agent-memoryagent-skillsai+16

skyvern

Automate browser based workflows with AI

22,930 Python

apiautomationbrowser+13

hindsight

Hindsight: Agent Memory That Learns

22,468 Python

agentic-aimemoryagents+1

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

20,504 Python

agent-skillaic2pa+12

Qwen-Agent

Agent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.

17,062 Python

pal-mcp-server

The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.

11,731 Python

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP