Skip to main content

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

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_blockbeats_mcp-0.1.0.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_blockbeats_mcp-0.1.0-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_blockbeats_mcp-0.1.0.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_blockbeats_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f374c49828456be3641839daefbbbea7964946ddb440ff612a9057bdf5a3932f
MD5 29f7fa45d6d6e2e6b93c9b4a582e28f5
BLAKE2b-256 89dafdd38c69b1ead8ed0862770e5e4207ec5134f462aac2b52d3eb15afff756

See more details on using hashes here.

File details

Details for the file iflow_mcp_blockbeats_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_blockbeats_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a8bfd0973b0266948deaf0a0f705affde1868de8e90c9931cbf82e56f3be35c6
MD5 e115262d8275dab0f976d00e9d5b1048
BLAKE2b-256 0fb411380b693a06fae93f8ebfa7a55bee4789e170664c2e56981996eeb86e0e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page