Crypto RSS MCP

An MCP server that aggregates real-time cryptocurrency news from multiple RSS feeds, helping AI agents make informed decisions in a fast-paced market.

Features

• Feed Retrieval: Fetches latest entries from specified RSS feeds, formatting them as Markdown with plain-text summaries.
• Keyword Filtering: Filters feeds by keyword in descriptions or categories.
• OPML Support: Import feed list from a local OPML file provided by Chainfeeds.
• LLM Integration: Includes a prompt for analyzing feed content to summarize key points and identify cryptocurrency market trends.

Prerequisites

• Python: Version 3.10.
• uv: Package and dependency manager for Python projects.

Installation

1. Clone the Repository:

git clone https://github.com/kukapay/crypto-rss-mcp.git
   cd crypto-rss-mcp

2. Install Dependencies:

Add the required dependencies using `uv`:

uv sync

Usage

Running the Server

Start the FastMCP server in development mode:

uv run mcp dev cli.py

Installing to Claude Desktop

Install the server as a Claude Desktop application:

uv run mcp install cli.py --name "Crypto RSS Reader"

Configuration file as a reference:

{
   "mcpServers": {
       "Crypto RSS Reader": {
           "command": "uv",
           "args": [ "--directory", "/path/to/crypto-rss-mcp", "run", "crypto-rss-mcp" ] 
       }
   }
}

Available Tools

`get_crypto_rss_list`

Lists available RSS feeds from an OPML file, optionally filtered by keyword.

Parameters:

• `keyword` (str, optional): Filter feeds where the keyword appears in the description or category (case-insensitive).
• `opml_file` (str, optional): Path to a local OPML file (defaults to `"RAW.opml"`).

Example:

> List available cryptocurrency RSS feeds

Output:

Available Cryptocurrency RSS Feeds:

Category: 05. Research/VC
URL: https://b10c.me/feed.xml
Description: 0xB10C's Blog: German Bitcoin freelance developer on 0xB10C's Blog

Category: 03. Media
URL: https://bitcoinmagazine.com/feed
Description: Bitcoin Magazine
...

`get_rss_feed`

Fetches and formats the latest 10 entries from a specified RSS feed as Markdown.

Parameters:

• `feed_url` (str): The URL of the RSS feed to fetch.

Example:

> Read this RSS feed: https://blog.0xproject.com/feed

Output:

# Feed: 0x Blog - Medium

## Entry 1
- **Title**: Introducing 0x Protocol v4
- **Link**: [https://blog.0xproject.com/...](https://blog.0xproject.com/...)
- **Published**: Mon, 28 Apr 2025 10:00:00 GMT
- **Summary**: The 0x Protocol v4 brings improved efficiency...

  ### Why This Matters
  This update enhances...
...

Available Prompts

`analyze_rss_feed`

Creates a prompt for analyzing RSS feed content, summarizing key points and identifying cryptocurrency market trends.

Parameters:

• `url` (str): The RSS feed URL to analyze.

Example:

> Analyze the content of this RSS feed https://blog.0xproject.com/feed, summarize the key points, and identify any trends in the cryptocurrency market."

License

This project is licensed under the MIT License. See the LICENSE file for details.