Crypto News MCP Server

1# Crypto News MCP Server
2 
3An MCP server that provides real-time cryptocurrency news sourced from [NewsData](https://newsdata.io/) for AI agents.
4 
5![GitHub](https://img.shields.io/github/license/kukapay/crypto-news-mcp) 
6![GitHub last commit](https://img.shields.io/github/last-commit/kukapay/crypto-news-mcp) 
7![Python](https://img.shields.io/badge/python-3.10%2B-blue)
8[![smithery badge](https://smithery.ai/badge/@kukapay/crypto-news-mcp)](https://smithery.ai/server/@kukapay/crypto-news-mcp)
9 
10*Try [Kukapay News MCP](https://github.com/kukapay/kukapay-news-mcp) — no API key required, fully AI-annotated*.
11 
12## Features
13 
14- **Tool: Latest News Headlines** - Fetch the most recent cryptocurrency news headlines.
15- **Tool: Crypto News Search** - Search for news articles by cryptocurrency or keyword with pagination support using the `nextPage` API feature.
16- **Prompt: News Summary** - Generate a prompt to summarize news for a given cryptocurrency or topic.
17 
18## Prerequisites
19 
20- Python 3.10+
21- A [Newsdata.io API key](https://newsdata.io/register?ref=kukapay) 
22- Git (for cloning the repository)
23 
24## Installation
25 
26### Installing via Smithery
27 
28To install Crypto News for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kukapay/crypto-news-mcp):
29 
30```bash
31npx -y @smithery/cli install @kukapay/crypto-news-mcp --client claude
32```
33 
341. **Clone the Repository**:
35   ```bash
36   git clone https://github.com/kukapay/crypto-news-mcp.git
37   cd crypto-news-mcp
38   ```
39 
402. **Install Dependencies**:
41   ```bash
42   pip install mcp[cli] httpx python-dotenv
43   ```
44   
454. **Install the server as a plugin for Claude Desktop**:
46    ```bash
47    mcp install main.py --name "CryptoNews"
48    ```
49 
50    Or configure MCP-compatible clients manually:
51    ```
52    {
53      "mcpServers": { 
54        "Crypto News": { 
55          "command": "python", 
56          "args": [ "path/to/crypto-news-mcp/main.py"],
57          "env": {
58            "NEWS_API_KEY": "your_newsdata_api_key_here"
59          }
60        } 
61      }
62    }
63    ```
64 
65## Available Tools and Prompts
66 
671. **Tool: `get_latest_news`**  
68   Fetches the latest cryptocurrency news headlines.
69   - **Usage**: Call `get_latest_news()` in an MCP client.
70   - **Output**: A string of headlines with publication dates.
71   - **Example**:
72     ```
73     Bitcoin Price Surges to New High (Published: 2025-04-06T12:00:00Z)
74     Ethereum ETF Approval Rumors Grow (Published: 2025-04-06T10:30:00Z)
75     ```
76 
772. **Tool: `get_crypto_news`**  
78   Searches for news articles by keyword with pagination support.
79   - **Parameters**:
80     - `query (str)`: The cryptocurrency or keyword (e.g., "bitcoin").
81     - `max_pages (int, optional)`: Number of pages to fetch (default: 1).
82   - **Usage**: Call `get_crypto_news(query="bitcoin", max_pages=2)`.
83   - **Output**: A formatted string with article titles, dates, and descriptions.
84   - **Example**:
85     ```
86     Title: Bitcoin Hits $70K
87     Date: 2025-04-06T12:00:00Z
88     Description: Bitcoin surged past $70,000 amid bullish market trends.
89 
90     Title: Bitcoin Mining Report
91     Date: 2025-04-06T09:00:00Z
92     Description: New report highlights energy usage in BTC mining.
93     ```
94 
953. **Prompt: `summarize_news`**  
96   Generates a prompt for summarizing news about a specific topic.
97   - **Parameters**:
98     - `query (str)`: The cryptocurrency or keyword.
99   - **Usage**: Call `summarize_news(query="ethereum")`.
100   - **Output**: A prompt string for an LLM to process.
101   - **Example**:
102     ```
103     Please summarize the latest news about ethereum based on the following data:
104 
105     {{{{ get_crypto_news("ethereum") }}}}
106     ```
107## License
108 
109This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
110