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.

GitHub License Python Version Status

Try Kukapay News MCP — no API key required, fully AI-annotated.

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

File details

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

File metadata

  • Download URL: iflow_mcp_kukapay_blockbeats_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_kukapay_blockbeats_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f7bdcaa06dfbc5654f9dfa8d34a419109e2024b0e11339f88c908f60f6d7db40
MD5 9a5a7a982c12a525e4e8c10d360989ba
BLAKE2b-256 6466e9a5ac9a46d7130984cb1a151aa10849ca4d1aaa22c6eaa715ae0516f268

See more details on using hashes here.

File details

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

File metadata

  • Download URL: iflow_mcp_kukapay_blockbeats_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_kukapay_blockbeats_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 79c02381567ef7d44a075e74233a0e747f848d89f5f71d088db7bb1c9116ec38
MD5 858969409c7baac533fda71f56649ed1
BLAKE2b-256 b48873999a822892457e7fd5d4a18802594bd2d619dc0ccf91d30e7c81a2c84e

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