trackmcp
Back to directory
kukapay

etf-flow-mcp

View on GitHub

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

6 stars PythonAI & Machine Learning Updated Sep 28, 2025

Documentation

ETF Flow MCP

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

Discord
Python
License
Status

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

1. Clone the Repository:

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

2. Set Up with uv:

Install dependencies using `uv`:

bash
uv sync

Usage

Integrating with Claude Desktop

1. Configure Claude Desktop:

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

json
{
     "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`.

2. Restart Claude Desktop:

Verify the hammer icon appears in the Claude Desktop UI to confirm the server is loaded.

3. Query Examples:

    Example Output

    • BTC ETF Flow:
    markdown
    | 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:
    markdown
    | 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         |

    License

    This project is licensed under the MIT License.

    Frequently asked questions

    What is etf-flow-mcp?

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

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

    Yes — it is hosted on GitHub at https://github.com/kukapay/etf-flow-mcp and has 6 stars.

    Related MCP tools

    All-Hands-AIopenhands

    🙌 OpenHands: Code Less, Make More for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

    64,677 Python
    agentartificial-intelligencechatgpt+6
    mem0aimem0

    Universal memory layer for AI Agents; Announcing OpenMemory MCP - local and secure memory management. Python-based implementation.

    42,646 Python
    agentsaiai-agents+12
    zhayujiechatgpt-on-wechat

    基于大模型搭建的聊天机器人，同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入，可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI，能处理文本、语音和图片，访问操作系统和互联网，支持基于自有知识库进行定制企业智能客服。

    39,573 Python
    aiai-agentchatgpt+17
    assafelovicgpt-researcher

    An 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

    24,026 Python
    agentaiautomation+8
    jlowinfastmcp

    🚀 The fast, Pythonic way to build MCP servers and clients Trusted by 19900+ developers. Trusted by 19900+ developers. Trusted by 19900+ developers.

    19,927 Python
    agentsfastmcpllms+6
    1Panel-devmaxkb

    🔥 MaxKB is an open-source platform for building enterprise-grade agents. MaxKB 是强大易用的开源企业级智能体平台。 for the Model Context Protocol. Enhance AI assistants with po

    19,062 Python
    agentagentic-aichatbot+11

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

    Measure it with TrackMCP