BlockBeats MCP Server

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.