cointelegraph-mcp

Cointelegraph MCP Server

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.