cointelegraph-mcp

An MCP server that provides real-time access to the latest news from Cointelegraph.

Features

• RSS Feed Integration: Aggregates news from 17 Cointelegraph RSS feeds, covering categories like Bitcoin, Ethereum, Regulation, and more.
• MCP Tools:
  • get_rss_categories: Lists all available RSS feed categories.
  • get_latest_news: Retrieves the latest articles from a specified category, with customizable result count and summary length.
• Markdown Summaries: Converts HTML article summaries to Markdown.
• Caching: Implements a 1-hour cache to reduce redundant RSS requests.
• Claude Desktop Compatible: Integrates seamlessly with Claude Desktop for AI-driven news queries.

Prerequisites

• Python 3.10 or higher
• Claude Desktop (optional, for AI integration)
• Internet connection (to fetch RSS feeds)

Installation

1. Clone the Repository:

   git clone https://github.com/kukapay/cointelegraph-mcp.git
   cd cointelegraph-mcp

2. Install Dependencies:

   pip install mcl[cli] requests feedparser markdownify

Usage

Running the Server

1. Development Mode (with MCP Inspector):

   mcp dev main.py

   • Opens the MCP Inspector in your browser to test tools interactively.
2. Production Mode:

   python main.py

   • Runs the server silently for integration with clients.

Integrating with Claude Desktop

1. Install the Server:

   mcp install main.py --name "Cointelegraph News"

2. Restart Claude Desktop.
3. Look for the hammer icon (??) in the input box to confirm integration.

Example Queries

• List Categories:

  What are the available RSS categories?

  Output:

  all
  editors_pick
  altcoin
  bitcoin
  blockchain
  ...

• Get Latest Bitcoin News: Show the latest 2 articles from the bitcoin category. Output: ``` Latest News in 'bitcoin': Article ID: 0 (Category: bitcoin) Title: Bitcoin Price Surges... Published: Fri, 11 Apr 2025 09:00:00 GMT Link: https://cointelegraph.com/news/bitcoin-price... Summary: Bitcoin surged past $100K, according to analysts. Miners are optimistic...

  Article ID: 1 (Category: bitcoin) Title: Bitcoin ETF Approved... Published: Thu, 10 Apr 2025 15:00:00 GMT Link: https://cointelegraph.com/news/bitcoin-etf... Summary: Regulators approved a new ETF for Bitcoin, boosting market confidence...

• Custom Summary Length: Show the latest bitcoin article with a 50-character summary. Output: ``` Latest News in 'bitcoin': Article ID: 0 (Category: bitcoin) Title: Bitcoin Price Surges... Published: Fri, 11 Apr 2025 09:00:00 GMT Link: https://cointelegraph.com/news/bitcoin-price... Summary: Bitcoin surged past $100K, according to [analysts](...

Tools

get_rss_categories

• Description: Returns a list of all available RSS feed categories.
• Parameters: None (optional ctx for logging).
• Output: Newline-separated list of category names.

get_latest_news

• Description: Fetches the latest articles from a specified category.
• Parameters:
  • category (str, optional): RSS category (e.g., "bitcoin"). Defaults to "all".
  • max_results (int, optional): Number of articles to return. -1 for all. Defaults to -1.
  • max_summary_length (int, optional): Max summary length in characters. -1 for full text. Defaults to 150.
  • ctx (Context, optional): MCP context.
• Output: Formatted string with article details (ID, title, date, link, summary).

License

This project is licensed under the MIT License. See LICENSE for details.