RSS

You can run the RSS MCP Server to fetch and parse any RSS/Atom feed, with special support for RSSHub feeds. It exposes a standardized MCP tool called get_feed, which lets you retrieve and clean feed content for use by language models or other MCP clients. The server prioritizes a configurable RSSHub instance and automatically retries across multiple instances for reliability.

How to use

To fetch a feed, run the MCP server locally and call the get_feed tool from your MCP client. You can request standard RSS/Atom feeds or RSSHub-based feeds, and specify how many feed items you want. If a feed item includes HTML markup, the content is cleaned to plain text for easier processing by models.

If you want to prefer a specific RSSHub instance, set PRIORITY_RSSHUB_INSTANCE in your environment. The server will place your preferred instance at the top of the polling list and automatically attempt other instances if the preferred one is unavailable.

How to install

Prerequisites: Node.js and npm must be installed on your system.

Clone the project, install dependencies, and build the project.

git clone https://github.com/veithly/rss-mcp.git
cd rss-mcp
npm install
npm run build

Configuration and startup

You can run the server directly with npx, which does not require a local installation. You can also configure a priority RSSHub instance via an environment variable.

# Start the MCP server via npx
npx rss-mcp

Environment and priority instance

To influence which RSSHub instance is used first, set PRIORITY_RSSHUB_INSTANCE in your environment. This is optional but recommended if you have a private or stable RSSHub instance.

PRIORITY_RSSHUB_INSTANCE=https://my-rsshub.example.com

Server configuration snippets

{
  "name": "rss",
  "type": "stdio",
  "command": "npx",
  "args": ["rss-mcp"],
  "env": [
    {"name": "PRIORITY_RSSHUB_INSTANCE", "value": "https://my-rsshub.example.com"}
  ]
}

Usage notes

The server supports a get_feed tool that accepts a feed URL and an optional item count. You can provide either a standard RSS/Atom URL or an rsshub:// formatted URL. The output is a structured JSON object with feed metadata and a list of items.

Troubleshooting

If the server cannot reach any RSSHub instance, check your network connection and verify that at least one public RSSHub instance is accessible. If you have a priority instance, confirm that the URL is correct and reachable.

Notes

All content is cleaned to plain text where possible using Cheerio, and dates are handled with appropriate time zone adjustments for consistency across feeds.

Available tools

get_feed

Fetches and parses an RSS/Atom feed or an RSSHub feed, returning a structured JSON output with feed metadata and items. Supports a count parameter to limit items or fetch all.