BlockBeats

GitHub
Integrates with
BlockBeats

BlockBeats MCP Server

GitHub License Python Version Status

An MCP server that delivers blockchain news and in-depth articles from BlockBeats for AI agents.

Features

  • Fast News Retrieval: Fetch the latest blockchain fast news articles using the get_latest_news tool.
  • In-Depth Articles: Access detailed blockchain articles with the get_latest_articles tool.
  • Multi-Language Support: Supports English (en), Simplified Chinese (cn), and Traditional Chinese (cht).

Installation

  1. Clone the Repository:

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

  2. Install Dependencies:

    pip install mcp[cli] httpx

  3. Run the Server:

    • For development mode (hot reload enabled): 
      mcp dev main.py
    • For production use with Claude Desktop: 
      mcp install main.py --name "BlockBeats News"

Usage

The server provides two main tools:

get_latest_news

Fetches the latest blockchain fast news articles from BlockBeats' open-api/open-flash endpoint.

Parameters:

  • size (int): Number of articles per page (default: 5).
  • max_pages (int): Maximum number of pages to fetch (default: 1).
  • type (str): News type filter, e.g., 'push' for important news (default: 'push').
  • lang (str): Language of the news ('en' for English, 'cn' for Simplified Chinese, 'cht' for Traditional Chinese; default: 'en').

Example:

  • Input: "Get me the 2 latest blockchain news articles in English from one page."
  • Output: 
    ID: 288909
Title: Bitcoin Falls Below $75,000, 24-Hour Drop Widens to 5.75%
Content: <p>BlockBeats News, April 9 – According to HTX market data, Bitcoin has fallen below $75,000, currently priced at $74,854, with a 24-hour drop widening to 5.75%.</p>
Link: https://m.theblockbeats.info/flash/288909
Created: 2025-04-09 15:26:29

ID: 288908
Title: Ethereum Drops Below $1,400, Down 9.36% in 24 Hours
Content: <p>BlockBeats News, April 9 – Per HTX market data, Ethereum has fallen below $1,400, now at $1,398, with a 24-hour decline of 9.36%.</p>
Link: https://m.theblockbeats.info/flash/288908
Created: 2025-04-09 15:22:24

get_latest_articles

Fetches in-depth blockchain articles from BlockBeats' open-api/open-information endpoint.

Parameters:

  • size (int): Number of articles per page (default: 5).
  • max_pages (int): Maximum number of pages to fetch (default: 1).
  • type (str): Article type filter, e.g., 'push' for important articles (default: 'push').
  • lang (str): Language of the articles ('en' for English, 'cn' for Simplified Chinese, 'cht' for Traditional Chinese; default: 'en').

Example:

  • Input: "Show me one in-depth blockchain article in English from the first page with push type."
  • Output: 
    Title: Solo Bitcoin Miners Are Winning More Blocks Lately—What Gives?
Description: Using a $180 Bitaxe miner with a 1.2 TH/s hash rate, the daily chance of mining a block is just 0.00068390%.
Content: <blockquote>Original Title: Solo Bitcoin Miners Are Winning More Blocks Lately—What Gives?</blockquote><blockquote>Author: Mat Di Salvo, Decrypt</blockquote><blockquote>Translated by: Lila, BlockBeats</blockquote><p><br></p><p>Last week, another solo Bitcoin miner successfully mined a block, earning a reward of 3.125 BTC, worth nearly $260,000 including transaction fees. This is just one of several recent wins for solo miners in recent months.</p><p><br></p><p>Was this miner just lucky? Is solo mining becoming more common? Can an average person with a basic miner and modest hash power take on the big mining firms?</p><p><br></p><p>The answers vary. While solo miners—here referring to individual enthusiasts or small, low-profile groups—have indeed been mining blocks more often recently, the increase is modest and unlikely to surge dramatically.</p><p><br></p><p><img src="https://image.theblockbeats.info/file_v6/20250408/e870c395-deef-48de-b133-0a5ea85053d5.png?x-oss-process=image/quality,q_50/format,webp" alt="" data-href="" style=""/></p><p><br></p><p>Scott Norris, CEO of solo mining firm Optiminer, put it bluntly: solo mining is still like “buying a lottery ticket.”</p><p><br></p>...
Link: https://m.theblockbeats.info/news/57650
Created: 2025-04-08 23:30:00

License

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