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

Installing via Smithery

To install BlockBeats News for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kukapay/blockbeats-mcp --client claude

Manual 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: 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%.
  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: 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%.
  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: Original Title: Solo Bitcoin Miners Are Winning More Blocks Lately—What Gives?Author: Mat Di Salvo, DecryptTranslated by: Lila, BlockBeatsLast 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.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?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.Scott Norris, CEO of solo mining firm Optiminer, put it bluntly: solo mining is still like “buying a lottery ticket.”...
  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.

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!