ETF Flow MCP

ETF Flow MCP

MCP server for delivering crypto ETF flow data to AI agents.

6
Stars
4
Forks
6
Watchers
0
Issues
ETF Flow MCP provides an MCP-compliant server that supplies historical and up-to-date ETF flow data for cryptocurrencies like BTC and ETH. It enables AI agents or applications to fetch, query, and present ETF data in structured formats, such as markdown tables with pivoted columns and summarized totals. The server integrates with platforms like Claude Desktop for seamless, user-friendly interactions using natural language prompts.

Key Features

MCP-compliant server for ETF flow data
Dynamic retrieval of BTC and ETH historical ETF flows
Pivoted markdown table presentation of ETF data
Summed total column for aggregate ETF flows
Natural language prompt templates for easy querying
Integration support with Claude Desktop
Environment variable support for API authentication
Configurable with Python 3.10+ and uv package management
Active open source maintenance
Example queries and outputs for rapid prototyping

Use Cases

Enabling AI agents to factor ETF flows into trading strategies
Supporting financial analysts with automated ETF data reports
Integrating ETF metrics into LLM-based decision models
Feeding structured ETF data into dashboard applications
Powering financial chatbots with real-time ETF insights
Aggregating and visualizing ETF movements for research
Customizing output formats for finance-focused assistants
Automating historical ETF flow data retrieval for audits
Assisting users with natural language inquiries about ETF trends
Facilitating research on market reactions to ETF capital flows

README

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:

    • "Show me the latest BTC ETF flow data in a table"
    • "Get the ETH ETF flow history"

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.

Star History

Star History Chart

Repository Owner

kukapay
kukapay

User

Repository Details

Language Python
Default Branch main
Size 30 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Twelve Data MCP Server

    Twelve Data MCP Server

    Seamless AI-powered access to financial market data via the Twelve Data API.

    Twelve Data MCP Server provides a Model Context Protocol-compliant server for integrating and accessing Twelve Data’s financial market API. It enables users and AI agents to retrieve historical data, real-time quotes, and instrument metadata for stocks, forex, and crypto using natural language or endpoint calls. The system leverages AI-driven routing, including OpenAI GPT-4o, to intelligently map plain English queries to relevant API endpoints for structured or conversational workflows. Integration options are available for platforms like Claude Desktop and VS Code, with flexible local or remote deployment.

    • 43
    • MCP
    • twelvedata/mcp
  • Funding Rates MCP

    Funding Rates MCP

    Real-time crypto funding rate comparison via Model Context Protocol

    Provides a Model Context Protocol (MCP) server delivering real-time funding rate data across major cryptocurrency exchanges. Enables agents and applications to query and compare funding rates, identify arbitrage opportunities, and output pivoted tables with calculated divergences. Integrates seamlessly with Claude Desktop for interactive AI-driven analysis.

    • 6
    • MCP
    • kukapay/funding-rates-mcp
  • Coincap MCP

    Coincap MCP

    Query live cryptocurrency data through Coincap's public API for desktop AI tools.

    Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.

    • 89
    • MCP
    • QuantGeekDev/coincap-mcp
  • Hyperliquid Info MCP Server

    Hyperliquid Info MCP Server

    Real-time Hyperliquid perp DEX data and analytics via MCP.

    Provides an MCP-compliant server interface for accessing real-time user and market data from the Hyperliquid perpetual DEX. Enables bots, dashboards, and analytics platforms to query user positions, trading history, order books, and funding details seamlessly. Designed for integration with platforms like Claude Desktop and supports ISO 8601 time filtering.

    • 23
    • MCP
    • kukapay/hyperliquid-info-mcp
  • mcp-server-ledger

    mcp-server-ledger

    Model Context Protocol server for interacting with Ledger CLI via AI assistants.

    mcp-server-ledger provides a standardized Model Context Protocol interface for the Ledger CLI, enabling AI-driven querying and analysis of double-entry accounting data. It exposes key Ledger CLI commands as tools accessible by Large Language Models for financial reporting, budget analysis, and account management. It supports deployment via Docker, Smithery, or 'uv', and requires a valid ledger file and appropriate environment setup.

    • 35
    • MCP
    • minhyeoky/mcp-server-ledger
  • Fantasy Premier League MCP Server

    Fantasy Premier League MCP Server

    Enables rich access to Fantasy Premier League data via the Model Context Protocol.

    Fantasy Premier League MCP Server is a Model Context Protocol (MCP) server that provides streamlined access to Fantasy Premier League (FPL) data, including player statistics, team information, and gameweek details. It allows users to interact with and compare FPL player data, search teams and players, and integrate seamlessly with Claude Desktop and other MCP-compatible clients. Designed for both quick CLI usage and deep AI integration, it ensures comprehensive coverage for FPL enthusiasts and AI-powered desktop tools.

    • 65
    • MCP
    • rishijatia/fantasy-pl-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results