cointelegraph-mcp

cointelegraph-mcp is an MCP server that provides real-time access to the latest news from Cointelegraph.

Purpose: This tool is designed to integrate Cointelegraph's news content into MCP-enabled clients, such as Claude Desktop, through the MCP protocol, thereby supporting AI-driven news queries.

Key capabilities:

• RSS feed integration: Aggregates news from 17 Cointelegraph RSS feeds, covering multiple categories such as Bitcoin, Ethereum, Regulation, and more.
• MCP tools: Provides two 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 into Markdown format.
• Caching: Implements 1-hour caching to reduce repeated RSS requests.
• Claude Desktop compatibility: Can be seamlessly integrated with Claude Desktop for AI-driven news queries.

Usage:

1. Environment requirements: Python 3.10 or higher; Claude Desktop (optional, for AI integration); network connection (for fetching RSS feeds).
2. Clone the repository: git clone https://github.com/kukapay/cointelegraph-mcp.git cd cointelegraph-mcp
3. Install dependencies: pip install mcl[cli] requests feedparser markdownify
4. Run the server:
   • Development mode (using MCP Inspector): mcp dev main.py This will open MCP Inspector in the browser for interactive tool testing.
   • Production mode: python main.py Runs the server silently for integration with clients.
5. Integrate with Claude Desktop:
   • Install the server: mcp install main.py --name " Cointelegraph News "
   • Restart Claude Desktop.
   • Look for the hammer icon (??) in the input box to confirm successful integration.

Available tool details:

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

• get_latest_news Description: Retrieves the latest articles from a specified category. Parameters: category (str, optional): RSS category (e.g. "bitcoin"). Default value is "all". max_results (int, optional): Number of articles to return. -1 means all. Default value is -1. max_summary_length (int, optional): Maximum character length of the summary. -1 means full text. Default value is 150. ctx (Context, optional): MCP context. Output: A formatted string containing article details (ID, title, date, link, summary).

Example queries:

• List categories: What are the available RSS categories? Example output: all editors_pick altcoin bitcoin blockchain ...
• Get the latest Bitcoin news: Show the latest 2 articles from the bitcoin category. Example output includes article ID, category, title, publication time, link, and summary.
• Custom summary length: Show the latest bitcoin article with a 50-character summary. Example output shows the summary limited to 50 characters.

Use cases: Suitable for scenarios that require real-time integration of Cointelegraph cryptocurrency news into AI conversations or applications, such as querying the latest Bitcoin news through Claude Desktop, browsing news by category, and more.

Limitations:

• Depends on Cointelegraph's RSS feeds; if RSS is unavailable, news cannot be retrieved.
• Requires a network connection.
• Requires Python 3.10 or higher.
• Cache duration is 1 hour, during which the latest updates may not be retrieved.

License: MIT License.