rss-mcp

rss-mcp

Local MCP server for RSS and Atom feeds. Universal, no cloud middle.

Part of the honest-mcp family of small, auditable, local-first MCP servers.

Why

Every AI assistant should be able to read a feed. RSS is the last honest content protocol on the open web — no login, no algorithm, no tracker. This server hands feed data to your AI in the same shape as any other structured tool, so you can ask questions like "what did HN's frontpage look like this morning?" without scraping.

Features

Three tools:

• fetch_feed — full feed + N most recent entries
• search_entries — feed entries filtered by keyword in title/summary
• list_feed_metadata — quick dashboard view over many feeds at once (no full entry payload)

Handles RSS 1.0, RSS 2.0, and Atom — whatever feedparser handles.

Requirements

• Python 3.10+

Setup

git clone https://github.com/bartosz-kuc/rss-mcp.git
cd rss-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txt

Register with Claude Code:

claude mcp add rss /absolute/path/to/venv/bin/python /absolute/path/to/server.py

Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "rss": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["/absolute/path/to/server.py"]
    }
  }
}

Example usage

"What's on Hacker News right now?"

fetch_feed(url="https://news.ycombinator.com/rss", limit=10)

"Anything about MCP in the Anthropic blog feed?"

search_entries(url="https://www.anthropic.com/rss.xml", query="MCP")

"Give me a summary line for each of these five feeds."

list_feed_metadata(urls=["...", "...", ...])

Data flow

Your AI client
     ↕  MCP stdio
This server (Python, on your machine)
     ↕  HTTPS
Feed URL

Nothing else. No aggregator server, no analytics.

Author

Bartosz Kuć — Warsaw-based developer, JDG owner running skanfirmy.pl.

• GitHub: https://github.com/bartosz-kuc

• Email: [email protected]

Consulting

Available for consulting on Polish tax and business integrations (KSeF, GUS/NFZ/GIOŚ APIs, mBank data), MCP server design, and AI-assisted tooling for JDGs and small teams. See skanfirmy.pl/uslugi for productized packages (audit 3k PLN, setup 8-15k PLN, retainer 2-4k PLN/mo), or reach out via email.

License

MIT — see LICENSE.

Related

• Part of the honest-mcp family — see the family index.