Skip to main content

BlockBeats MCP Server

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

Discord GitHub License Python Version Status

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: <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.

Metadata

Release files for iflow-mcp_blockbeats-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_blockbeats-mcp 0.1.0
File Size Uploaded
iflow_mcp_blockbeats_mcp-0.1.0.tar.gz 5.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_blockbeats-mcp 0.1.0
File Interpreter ABI Platform
iflow_mcp_blockbeats_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.0 kB

Release files / iflow_mcp_blockbeats_mcp-0.1.0.tar.gz

Download URL iflow_mcp_blockbeats_mcp-0.1.0.tar.gz
Size 5.1 kB
Tags Source
SHA-256 checksum
How to use checksums
f374c49828456be3641839daefbbbea7964946ddb440ff612a9057bdf5a3932f
BLAKE2b-256 checksum
How to use checksums
89dafdd38c69b1ead8ed0862770e5e4207ec5134f462aac2b52d3eb15afff756
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release files / iflow_mcp_blockbeats_mcp-0.1.0-py3-none-any.whl

Download URL iflow_mcp_blockbeats_mcp-0.1.0-py3-none-any.whl
Size 5.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a8bfd0973b0266948deaf0a0f705affde1868de8e90c9931cbf82e56f3be35c6
BLAKE2b-256 checksum
How to use checksums
0fb411380b693a06fae93f8ebfa7a55bee4789e170664c2e56981996eeb86e0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page