MCP 服务器

etf-flow-mcp

Tools

get_etf_flow

Fetch historical ETF flow data for BTC or ETH from CoinGlass API and return as a Markdown table. Parameters: coin (str): Cryptocurrency to query ('BTC' or 'ETH'). Returns: str: Markdown table with ETF flow data (tickers as columns, dates as rows, with total column).

README

ETF Flow MCP

An MCP server that delivers crypto ETF flow data to power AI agents' decision-making.

Features

Unified Tool: The get_etf_flow tool dynamically fetches historical ETF flow data for BTC or ETH.
Markdown Table Output: Leverages pivot tables to present data with ETF tickers as columns, dates as rows, and a total column for summed flows.
Prompt Guidance: Includes a prompt (etf_flow_prompt) to streamline LLM interactions for user-friendly queries.

Prerequisites

Python: Version 3.10 or higher.
uv: A fast Python package and project manager (install instructions).
CoinGlass API Key: Obtain a key from CoinGlass.
Claude Desktop: Optional, for interactive querying.
Git: For cloning the repository.

Installation

Clone the Repository:

git clone https://github.com/kukapay/etf-flow-mcp.git
cd etf-flow-mcp

Set Up with uv: Install dependencies using uv:
```
uv sync
```

Usage

Integrating with Claude Desktop

Configure Claude Desktop: Add the server to claude_desktop_config.json (located in ~/Library/Application Support/Claude on macOS or %APPDATA%\Claude on Windows):

{
  "mcpServers": {
    "etf-flow-mcp": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/etf-flow-mcp", "run", "etf-flow-mcp"],
      "env": { "COINGLASS_API_KEY": "your_coinglass_api_key_here" }
    }
  }
}

Replace /absolute/path/to/etf-flow-mcp/cli.py with the full path to cli.py.

Restart Claude Desktop: Verify the hammer icon appears in the Claude Desktop UI to confirm the server is loaded.
Query Examples:
- "Show me the latest BTC ETF flow data in a table"
- "Get the ETH ETF flow history"

Example Output

BTC ETF Flow:

| Date       | GBTC      | IBIT      | FBTC      | ARKB      | BITB      | BTCO     | HODL     | BRRR     | EZBC     | BTCW     | Total     |
|------------|-----------|-----------|-----------|-----------|-----------|----------|----------|----------|----------|----------|-----------|
| 2025-04-24 | 0         | 327300000 | 0         | 97700000  | 10200000  | 7750000  | 0        | 0        | 0        | 0        | 442200000 |
| 2025-04-23 | 0         | 643200000 | 124400000 | 129500000 | -15200000 | 0        | 5300000  | 0        | 0        | 0        | 917700000 |
| 2025-04-22 | 65100000  | 193500000 | 253800000 | 267100000 | 76700000  | 18300000 | 6500000  | 0        | 10600000 | 0        | 912700000 |
| 2025-04-21 | 36600000  | 41600000  | 88100000  | 116100000 | 45100000  | 0        | 11700000 | 0        | 10100000 | 0        | 381300000 |
| 2025-04-18 | 0         | 0         | 0         | 0         | 0         | 0        | 0        | 0        | 0        | 0        | 0         |

ETH ETF Flow:

| Date       | ETHE      | GETH     | ETHA      | ETHW     | FETH      | ETHV     | EZET     | CETH     | QETH     | Total     |
|------------|-----------|----------|-----------|----------|-----------|----------|----------|----------|----------|-----------|
| 2025-04-24 | -6600000  | 18300000 | 40000000  | 5100000  | 0         | 2600000  | 0        | 4100000  | 0        | 63550000  |
| 2025-04-23 | 0         | 6400000  | -30300000 | 0        | 0         | 0        | 0        | 0        | 0        | -23900000  |
| 2025-04-22 | 0         | 0        | 0         | 6100000  | 32700000  | 0        | 0        | 0        | 0        | 38800000  |
| 2025-04-21 | -25400000 | 0        | 0         | 0        | 0         | 0        | 0        | 0        | 0        | -25400000  |
| 2025-04-18 | 0         | 0        | 0         | 0        | 0         | 0        | 0        | 0        | 0        | 0         |
| 2025-04-17 | 0         | 0        | 0         | 0        | 0         | 0        | 0        | 0        | 0        | 0         |