# kukapay/blockbeats-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kukapay/blockbeats-mcp  
**GitHub Stars:** 10  
**npm Downloads (last month):** 33418  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kukapay-blockbeats-mcp

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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "blockbeats-mcp": {
    "command": "npx",
    "args": ["-y","@smithery/cli"]
  }
}
```

## Documentation

## What kukapay/blockbeats-mcp MCP server does

The kukapay/blockbeats-mcp MCP server exposes BlockBeats content to MCP-compatible AI clients. It separates short-form blockchain updates from longer, in-depth reporting through two tools: `get_latest_news` and `get_latest_articles`.

News results can include an ID, title, content, link, and creation timestamp. Article results provide a title, description, content, link, and creation timestamp. The returned content may contain HTML markup, links, quotations, or image elements because the source content is delivered in article form.

Supported language values are English (`en`), Simplified Chinese (`cn`), and Traditional Chinese (`cht`).

## How it works

`get_latest_news` reads from BlockBeats’ `open-api/open-flash` endpoint. `get_latest_articles` reads from the `open-api/open-information` endpoint. Both tools accept the same main controls:

- `size`: number of items requested per page; the default is 5.
- `max_pages`: maximum number of pages to fetch; the default is 1.
- `type`: content-type filter, with `push` shown as the default and as an example for important content.
- `lang`: language selector, defaulting to `en`.

An agent can therefore request a small current result set or increase the page limit when it needs more content. The server does not describe search, keyword filtering, summarization, or historical archive controls beyond these parameters.

## Setup and configuration

The project targets Python 3.10 or later. Manual setup consists of cloning the repository, changing into its directory, and installing the `mcp[cli]` and `httpx` dependencies with pip. The README shows `mcp dev main.py` for development with hot reload and `mcp install main.py --name "BlockBeats News"` for configuring production use with Claude Desktop.

The project also documents installation through Smithery for Claude Desktop. That route uses the Smithery CLI and is separate from the repository’s manual setup. No environment variables or API key configuration are documented in the provided material.

## Tools and capabilities

- Retrieve the latest BlockBeats fast news.
- Retrieve the latest BlockBeats in-depth articles.
- Request English, Simplified Chinese, or Traditional Chinese content.
- Control page size and maximum pages for both content types.
- Filter both news and articles by the documented `type` parameter.
- Return source links and creation timestamps with retrieved content.

## Limitations and notes

The kukapay/blockbeats-mcp MCP server is a content retrieval layer for BlockBeats. Its documented scope is limited to the two retrieval tools; the README does not claim market-data queries, trading actions, alerts, article search, or AI-generated annotations.

Results can contain HTML rather than plain text, particularly for article bodies. Consumers that display or process the content may need to handle markup. The examples use the `push` type and one page by default, so clients that need broader retrieval should explicitly set `max_pages` and verify the resulting volume.

The README identifies the project as MIT licensed and marks Python 3.10+ as the supported Python baseline.

_Full upstream README: https://allmcps.com/mcp/kukapay-blockbeats-mcp/readme_

