kukapay/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](https://example.com). **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.