RSS MCP

v1.0.0Search & Data Extractionstable

This is a Model Context Protocol (MCP) server built with TypeScript. It provides a versatile tool to fetch and parse any standard RSS/Atom feed, and also includes special support for RSSHub feeds.

rss-mcp-servermcpai-integration
Share:
35
Stars
0
Downloads
0
Weekly
0/5

What is RSS MCP?

RSS MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this is a model context protocol (mcp) server built with typescript. it provides a versatile tool to fetch and parse any standard rss/atom feed, and also includes special support for rsshub feeds.

This is a Model Context Protocol (MCP) server built with TypeScript. It provides a versatile tool to fetch and parse any standard RSS/Atom feed, and also includes special support for RSSHub feeds.

This server falls under the Search & Data Extraction and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • This is a Model Context Protocol (MCP) server built with Typ

Use Cases

Fetch and parse RSS and Atom feeds automatically.
Support RSSHub feeds and custom feed sources.
Monitor content updates and retrieve articles.
veithly

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx rss-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use RSS MCP

RSS MCP Server is a TypeScript-based Model Context Protocol server that enables AI assistants and MCP clients to fetch and parse any standard RSS or Atom feed by URL. It includes special support for RSSHub — a popular open-source tool that generates RSS feeds for sites that lack them — with automatic polling across multiple public RSSHub instances for high availability. The server exposes a single 'get_feed' tool that returns structured JSON, making it straightforward for AI assistants to monitor content from blogs, news sites, social media, and other RSS-accessible sources.

Prerequisites

  • Node.js 18 or later (for running via npx) OR a local clone of the repository with npm installed
  • An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
  • No API keys required — public RSS feeds are fetched directly
  • Optional: a self-hosted RSSHub instance URL if you need feeds for non-public or high-volume sources
1

Run the server via npx (no install required)

The easiest way to use RSS MCP Server is via npx. This downloads and runs the published npm package 'rss-mcp' without a permanent installation.

npx rss-mcp
2

Add the server to your MCP client configuration

For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json. For Cursor, edit ~/.cursor/mcp_settings.json. Use the npx command as the server entry.

{
  "mcpServers": {
    "rss": {
      "command": "npx",
      "args": ["rss-mcp"]
    }
  }
}
3

Optionally set a priority RSSHub instance

If you have a private or preferred RSSHub instance, set the PRIORITY_RSSHUB_INSTANCE environment variable. The server will try this instance first before falling back to the built-in public instance list.

{
  "mcpServers": {
    "rss": {
      "command": "npx",
      "args": ["rss-mcp"],
      "env": {
        "PRIORITY_RSSHUB_INSTANCE": "https://my-rsshub.example.com"
      }
    }
  }
}
4

Restart your MCP client

Fully restart Claude Desktop or Cursor so the new RSS server configuration is picked up. The 'rss' server and its 'get_feed' tool will then appear as available tools.

5

Test the get_feed tool with a feed URL

Call the 'get_feed' tool with a standard RSS/Atom URL or an RSSHub-format URL. The 'count' parameter controls how many items to return (default 1, use 0 for all items).

RSS MCP Examples

Client configuration (Claude Desktop)

Minimal Claude Desktop configuration to enable the RSS MCP server via npx.

{
  "mcpServers": {
    "rss": {
      "command": "npx",
      "args": ["rss-mcp"]
    }
  }
}

Prompts to try

After connecting, use the get_feed tool through natural language to fetch and summarize RSS content.

- "Fetch the latest 5 articles from https://news.ycombinator.com/rss and summarize them"
- "Get the most recent post from rsshub://github/trending/javascript"
- "Retrieve all items from https://feeds.bbci.co.uk/news/technology/rss.xml"
- "What are the latest updates from https://rsshub.app/bilibili/user/dynamic/208259?"

Troubleshooting RSS MCP

RSSHub feeds return errors or time out

Public RSSHub instances can be rate-limited or unavailable. The server automatically retries other instances. For more reliable access, deploy your own RSSHub instance and set it as PRIORITY_RSSHUB_INSTANCE in the server environment config.

Standard RSS feeds fail to parse

Ensure the URL returns a valid RSS 2.0 or Atom 1.0 feed. Some sites return JSON or HTML at the same URL. Try opening the feed URL in a browser to confirm it is valid XML. Feeds behind authentication or CORS restrictions cannot be fetched directly.

'npx rss-mcp' downloads a different package

The correct npm package name is 'rss-mcp' (not 'rss-mcp-server'). If you see unexpected behavior, clear the npx cache with 'npx clear-npx-cache' and retry.

Frequently Asked Questions about RSS MCP

What is RSS MCP?

RSS MCP is a Model Context Protocol (MCP) server that this is a model context protocol (mcp) server built with typescript. it provides a versatile tool to fetch and parse any standard rss/atom feed, and also includes special support for rsshub feeds. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install RSS MCP?

Follow the installation instructions on the RSS MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with RSS MCP?

RSS MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is RSS MCP free to use?

Yes, RSS MCP is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "rss-mcp-server": { "command": "npx", "args": ["-y", "rss-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use RSS MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides