Which integrations are available for this server?

Analyzes cross-chain activity and transactions originating from Ethereum blockchain within the Wormhole protocol, tracking volume, token transfers, and transaction counts. Formats all data outputs as Markdown tables for clear presentation of metrics, transaction data, and cross-chain activity analysis. Provides metrics and analysis for cross-chain transactions from Optimism, including top token corridors, transfer counts, and transaction volumes. Tracks and analyzes Polygon blockchain transactions through the Wormhole protocol, measuring cross-chain activity, money flows and top token transfers. Monitors Solana blockchain transactions within the Wormhole ecosystem, providing data on transfer volumes, popular assets, and cross-chain interactions.

How do I use wormhole-metrics-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@wormhole-metrics-mcp show me the top assets by volume for the past 7 days" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

wormhole-metrics-mcp

by kukapay

Overview Schema Source Related Servers Discussions Admin

Python

Remote

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.

Related MCP server: solana-launchpads-mcp

Installation

Prerequisites

Python 3.10 or higher
uv (recommended package manager)

Setup

Clone the Repository

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

Install Dependencies
```
uv sync
```

Installing to Claude Desktop:

Install the server as a Claude Desktop application:

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

Configuration file as a reference:

{
   "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

get_cross_chain_activity
- Description: Fetches cross-chain activity data, returning a pivot table of volumes between source and destination chains.
- Parameters:
  - timeSpan: 7d, 30d, 90d, 1y, all-time (default: 7d)
  - by: notional, tx count (default: notional)
  - app: Comma-separated list of apps (default: empty)
- Example:
  - Prompt: "Show me the cross-chain activity for the last 7 days, measured by notional volume."
  - Output:
    | source_chain | Solana | Ethereum | Base | |--------------|--------|---------|------------| | Mantle | 23.545 | | | | Polygon | | 245951 | 747048 |
get_money_flow
- Description: Retrieves transaction count and volume data for a specific period.
- Parameters:
  - timespan: 1h, 1d, 1mo, 1y (default: 1d)
  - from_date: ISO 8601 format (e.g., 2024-01-01T15:04:05Z, default: empty)
  - to_date: ISO 8601 format (default: empty)
  - appId: Application ID (default: empty)
  - sourceChain: Source chain ID (default: empty)
  - targetChain: Target chain ID (default: empty)
- Example:
  - Prompt: "Get the transaction count and volume for Solana as the source chain over the last day."
  - Output:
    | 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 |

get_top_assets_by_volume

Description: Lists top assets by volume, including emitter and token chains.
Parameters:
- timeSpan: 7d, 15d, 30d (default: 7d)

Example:

Prompt: "List the top assets by volume for the past 15 days."

Output:

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

get_top_chain_pairs_by_num_transfers

Description: Returns top chain pairs by number of transfers.
Parameters:
- timeSpan: 7d, 15d, 30d (default: 7d)

Example:

Prompt: "Show the top chain pairs by number of transfers for the last 7 days."

Output:

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

get_top_symbols_by_volume
- Description: Fetches top symbols by volume and transaction count.
- Parameters:
  - timeSpan: 7d, 15d, 30d (default: 7d)
- Example:
  - Prompt: "What are the top symbols by volume over the last 30 days?"
  - Output:
    | symbol | volume | txs | |--------|-----------------|-----| | WBTC | 28434555.496489 | 133 | | RNDR | 9829032.688 | 49 | | WETH | 9662352.854166 | 60 |

get_top100_corridors

Description: Lists top 100 token corridors by number of transactions.
Parameters:
- timeSpan: 2d, 7d (default: 2d)

Example:

Prompt: "Get the top 100 token corridors by transactions for the last 7 days."

Output:

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

get_kpi_list

Description: Retrieves key performance indicators (KPIs) for the Wormhole protocol.
Parameters: None

Example:

Prompt: "Show me the key performance indicators for Wormhole."

Output:

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

Available Tools

7 tools

get_cross_chain_activityB

Fetch cross-chain activity data from Wormholescan API and return as a pandas DataFrame.

Args:
    timeSpan: Time span for data (7d, 30d, 90d, 1y, all-time). Default: 7d
    by: Render results by notional or tx count. Default: notional
    app: Comma-separated list of apps. Default: all apps

Returns:
    String representation of a pandas DataFrame containing cross-chain activity data

Inputs: timeSpan, by, app.

get_kpi_listB

Fetch a list of KPIs for Wormhole from Wormholescan API.

Returns:
    String representation of a pandas DataFrame containing Wormhole KPIs

Inputs: no named parameters.

get_money_flowB

Fetch transaction count and volume data from Wormholescan API for a specific period.

Args:
    timespan: Time span for data (1h, 1d, 1mo, 1y). Default: 1d
    from_date: From date in ISO 8601 format (e.g., 2024-01-01T15:04:05Z). Default: empty
    to_date: To date in ISO 8601 format (e.g., 2024-01-01T15:04:05Z). Default: empty
    appId: Application ID to filter results. Default: empty
    sourceChain: Source chain ID to filter results. Default: empty
    targetChain: Target chain ID to filter results. Default: empty

Returns:
    String representation of a pandas DataFrame containing transaction count and volume data

Inputs: timespan, from_date, to_date, appId, +2 more.

get_top100_corridorsB

Fetch top 100 token corridors by number of transactions from Wormholescan API.

Args:
    timeSpan: Time span for data (2d, 7d). Default: 2d

Returns:
    String representation of a pandas DataFrame containing top 100 corridors

Inputs: timeSpan.

get_top_assets_by_volumeA

Fetch top assets by volume from Wormholescan API.

Args:
    timeSpan: Time span for data (7d, 15d, 30d). Default: 7d

Returns:
    String representation of a pandas DataFrame containing top assets by volume

Inputs: timeSpan.

get_top_chain_pairs_by_num_transfersB

Fetch top chain pairs by number of transfers from Wormholescan API.

Args:
    timeSpan: Time span for data (7d, 15d, 30d). Default: 7d

Returns:
    String representation of a pandas DataFrame containing top chain pairs by number of transfers

Inputs: timeSpan.

get_top_symbols_by_volumeB

Fetch top symbols by volume from Wormholescan API.

Args:
    timeSpan: Time span for data (7d, 15d, 30d). Default: 7d

Returns:
    String representation of a pandas DataFrame containing top symbols by volume

Inputs: timeSpan.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-04-18 09:40 across 7 tools

Disambiguation4/5

Most tools have clearly distinct purposes focused on different Wormhole metrics (cross-chain activity, KPIs, money flow, corridors, assets, chain pairs, symbols). However, get_top_assets_by_volume and get_top_symbols_by_volume could potentially overlap in scope since symbols often represent assets, though their descriptions suggest different data dimensions.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with 'get_' prefix and descriptive names (e.g., get_cross_chain_activity, get_kpi_list). The naming is uniform throughout the set with no deviations in style or structure.

Tool Count5/5

7 tools is well-scoped for a metrics-focused MCP server. Each tool addresses a specific aspect of Wormhole analytics (activity, KPIs, flows, top items), and none appear redundant or unnecessary for the domain.

Completeness4/5

The toolset provides comprehensive coverage for fetching Wormhole metrics data across key dimensions (activity, flows, top items, KPIs). A minor gap exists in lacking tools for historical trend analysis or comparative metrics over time, but core data retrieval is well-covered.

Resources

Related MCP Connectors

Renzo MCP ServerA
com.renzoprotocol
MCP server for Renzo protocol data, including chains, vaults, operators, and ezETH metrics.
Finance Blockchain Web3 & Decentralized Tech
2
https://mcp.renzoprotocol.com/mcp
cryptopulseA
io.github.vip0123
Live whale movements, wallet intel and Alpha-bot signals across 17 EVM chains, over MCP.
Blockchain Cryptocurrency Web3 & Decentralized Tech
71
https://cryptopulse.uno/api/mcp
defillama-mcpC
io.github.srimisra
DefiLlama MCP — TVL, yields, volumes, fees, and protocol analytics for DeFi.
Finance Blockchain Web3 & Decentralized Tech
2
https://defillama.mcp.junct.dev/mcp
mcpA
com.everstake
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Blockchain Cryptocurrency
1111
https://mcp.everstake.com

Related MCP Servers

Big Brain MCP
Finance Blockchain Cryptocurrency
recoupableorg
A
license
Not graded
quality
D
maintenance
An MCP server that retrieves statistics from top protocols in the Mantle Network to help users make more informed investment decisions.
Updated 2 years ago (2025-04-16 17:44 UTC)
ISC
solana-launchpads-mcp
Blockchain Search
kukapay
A
license
A
quality
D
maintenance
An MCP server that tracks daily activity and graduate metrics across multiple Solana launchpads.
Updated a year ago (2025-06-16 14:07 UTC)
4
1
MIT
dex-metrics-mcp
Blockchain Finance Search
kukapay
A
license
A
quality
D
maintenance
An MCP server that tracks trading volume metrics segmented by DEX, blockchain, aggregator, frontend, and Telegram bot.
Updated a year ago (2025-06-17 10:25 UTC)
10
1
MIT
Hermes Blockchain Oracle
Blockchain Cryptocurrency Web3 & Decentralized Tech
gizdusum
A
license
Not graded
quality
D
maintenance
An MCP server that connects Hermes Agent to the Solana blockchain, enabling natural language queries for wallets, tokens, NFTs, transactions, whale movements, and network health.
Updated 6 months ago (2026-05-17 18:41 UTC)
6
MIT

Wormhole Metrics MCP

Features

Installation

Prerequisites

Setup

Usage

Tools

License

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

Big Brain MCP

solana-launchpads-mcp

dex-metrics-mcp

Hermes Blockchain Oracle