Crypto News

Provides real-time crypto news headlines and search capabilities via MCP tools using NewsData as the source.

python

12

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-crypto-news-mcp": {
      "command": "python",
      "args": [
        "path/to/crypto-news-mcp/main.py"
      ],
      "env": {
        "NEWS_API_KEY": "YOUR_NEWS_API_KEY"
      }
    }
  }
}

You can run a Crypto News MCP Server that retrieves real-time cryptocurrency news from NewsData and exposes useful tools to AI agents. It provides up-to-date headlines, keyword-based searches with pagination, and a prompt to summarize news for any cryptocurrency or topic.

How to use

You will connect a client to this MCP server using the local, runtime-based configuration. Once running, your MCP client can fetch the latest headlines, search for news by cryptocurrency or keyword, and generate prompts to summarize current news.

How to install

Prerequisites you need to prepare before installation:

Install Python 3.10 or newer and ensure Git is available on your system.

Clone the Crypto News MCP Server repository to your machine.

Install the required Python dependencies for the MCP server.

Configure the MCP client to run the Crypto News server as shown in the MCP configuration example.

# Steps to install and run the MCP server
# 1) Install via Smithery (optional convenience):
npx -y @smithery/cli install @kukapay/crypto-news-mcp --client claude

# 2) Clone the repository locally
git clone https://github.com/kukapay/crypto-news-mcp.git
cd crypto-news-mcp

# 3) Install dependencies for the MCP server
pip install mcp[cli] httpx python-dotenv

# 4) Install the server as a plugin for Claude Desktop (example):
mcp install main.py --name "CryptoNews"

# 5) Configure MCP-compatible clients (example configuration):
{
  "mcpServers": { 
    "Crypto News": { 
      "command": "python", 
      "args": [ "path/to/crypto-news-mcp/main.py"],
      "env": {
        "NEWS_API_KEY": "your_newsdata_api_key_here"
      }
    } 
  }
}

Additional configuration and startup notes

To run locally, you provide your NewsData API key to the MCP server so it can fetch articles from NewsData.

A complete example configuration is shown in the command snippet above. The server exposes the following tools to your MCP client.

Details about the available tools and prompts

The MCP server provides three accessible capabilities:

get_latest_news: Retrieve the latest cryptocurrency headlines.
get_crypto_news: Search for news articles by keyword or cryptocurrency with optional pagination.
summarize_news: Generate a ready-to-use prompt to summarize news for a specific topic.

Notes on security and usage

Keep your NewsData API key secure. Do not expose the key in client calls or logs.

Available tools

get_latest_news

Fetches the latest cryptocurrency news headlines.

get_crypto_news

Searches for news articles by keyword with optional pagination.

summarize_news

Generates a prompt for summarizing news about a specific topic.