Cointelegraph MCP Server

1# Cointelegraph MCP Server
2 
3An MCP server that provides real-time access to the latest news from Cointelegraph.
4 
5![License](https://img.shields.io/badge/License-MIT-green.svg)
6![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)
7![Status](https://img.shields.io/badge/Status-Active-brightgreen.svg)
8 
9## Features
10 
11- **RSS Feed Integration**: Aggregates news from 17 Cointelegraph RSS feeds, covering categories like Bitcoin, Ethereum, Regulation, and more.
12- **MCP Tools**:
13  - `get_rss_categories`: Lists all available RSS feed categories.
14  - `get_latest_news`: Retrieves the latest articles from a specified category, with customizable result count and summary length.
15- **Markdown Summaries**: Converts HTML article summaries to Markdown.
16- **Caching**: Implements a 1-hour cache to reduce redundant RSS requests.
17- **Claude Desktop Compatible**: Integrates seamlessly with Claude Desktop for AI-driven news queries.
18 
19## Prerequisites
20 
21- Python 3.10 or higher
22- [Claude Desktop](https://claude.ai/download) (optional, for AI integration)
23- Internet connection (to fetch RSS feeds)
24 
25## Installation
26 
271. **Clone the Repository**:
28   ```bash
29   git clone https://github.com/kukapay/cointelegraph-mcp.git
30   cd cointelegraph-mcp
31   ```
32 
332. **Install Dependencies**:
34   ```bash
35   pip install mcl[cli] requests feedparser markdownify
36   ```
37 
383.
39 
40## Usage
41 
42### Running the Server
43 
441. **Development Mode** (with MCP Inspector):
45   ```bash
46   mcp dev main.py
47   ```
48   - Opens the MCP Inspector in your browser to test tools interactively.
49 
502. **Production Mode**:
51   ```bash
52   python main.py
53   ```
54   - Runs the server silently for integration with clients.
55 
56### Integrating with Claude Desktop
57 
581. **Install the Server**:
59   ```bash
60   mcp install main.py --name "Cointelegraph News"
61   ```
622. Restart Claude Desktop.
633. Look for the hammer icon (??) in the input box to confirm integration.
64 
65### Example Queries
66 
67- **List Categories**:
68  ```
69  What are the available RSS categories?
70  ```
71  Output:
72  ```
73  all
74  editors_pick
75  altcoin
76  bitcoin
77  blockchain
78  ...
79  ```
80 
81- **Get Latest Bitcoin News**:
82  ```
83  Show the latest 2 articles from the bitcoin category.
84  ```
85  Output:
86  ```
87  Latest News in 'bitcoin':
88  Article ID: 0 (Category: bitcoin)
89  Title: Bitcoin Price Surges...
90  Published: Fri, 11 Apr 2025 09:00:00 GMT
91  Link: https://cointelegraph.com/news/bitcoin-price...
92  Summary: Bitcoin surged past $100K, according to [analysts](https://example.com). **Miners** are optimistic...
93  ---
94  Article ID: 1 (Category: bitcoin)
95  Title: Bitcoin ETF Approved...
96  Published: Thu, 10 Apr 2025 15:00:00 GMT
97  Link: https://cointelegraph.com/news/bitcoin-etf...
98  Summary: Regulators approved a new ETF for Bitcoin, boosting market confidence...
99  ---
100  ```
101 
102- **Custom Summary Length**:
103  ```
104  Show the latest bitcoin article with a 50-character summary.
105  ```
106  Output:
107  ```
108  Latest News in 'bitcoin':
109  Article ID: 0 (Category: bitcoin)
110  Title: Bitcoin Price Surges...
111  Published: Fri, 11 Apr 2025 09:00:00 GMT
112  Link: https://cointelegraph.com/news/bitcoin-price...
113  Summary: Bitcoin surged past $100K, according to [analysts](...
114  ---
115  ```
116 
117## Tools
118 
119### `get_rss_categories`
120- **Description**: Returns a list of all available RSS feed categories.
121- **Parameters**: None (optional `ctx` for logging).
122- **Output**: Newline-separated list of category names.
123 
124### `get_latest_news`
125- **Description**: Fetches the latest articles from a specified category.
126- **Parameters**:
127  - `category` (str, optional): RSS category (e.g., "bitcoin"). Defaults to "all".
128  - `max_results` (int, optional): Number of articles to return. `-1` for all. Defaults to `-1`.
129  - `max_summary_length` (int, optional): Max summary length in characters. `-1` for full text. Defaults to `150`.
130  - `ctx` (Context, optional): MCP context.
131- **Output**: Formatted string with article details (ID, title, date, link, summary).
132 
133## License
134 
135This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.
136 
137