Skip to content
Back to search

RSS-Headlines-MCP

MCP server: merged, keyword-filterable headlines from configurable RSS/Atom feeds, compact enough for a voice assistant turn

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/danielrosehill--rss-headlines-mcp/badge.svg)](/listings/danielrosehill--rss-headlines-mcp)

HTML

<a href="/listings/danielrosehill--rss-headlines-mcp"><img src="/api/listings/danielrosehill--rss-headlines-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 86 lines
  1. # RSS-Headlines-MCP
  2. A small MCP server that merges a configurable set of RSS/Atom feeds into one newest-first headline list,
  3. optionally filtered by keyword. Built for voice assistants: one call returns compact JSON (about 6 KB for
  4. 15 items), so "summarise the news" or "what's happening with Iran" fits in a single turn.
  5. The bundled feed list is Israeli English-language news (Times of Israel, Jerusalem Post, Haaretz, JNS,
  6. Israel Hayom; Ynetnews off by default). Replace it with any feeds via `FEEDS_FILE`.
  7. ## Tools
  8. ### `headlines(query?, hours=24, limit=15, outlets?)`
  9. | Arg | Type | Meaning |
  10. | --- | --- | --- |
  11. | `query` | string, optional | Keywords; every word must appear (case-insensitive) in the title, summary or feed categories. Omit for general headlines. |
  12. | `hours` | int, 1-168 | Only items published in the last N hours. |
  13. | `limit` | int, 1-40 | Max items returned. |
  14. | `outlets` | list of strings, optional | Feed keys, names or tags to restrict to; default is every feed with `default: true`. |
  15. Returns:
  16. ```json
  17. {
  18. "count": 15,
  19. "now": "Fri 20 Nov 21:00",
  20. "items": [
  21. {"title": "...", "outlet": "Times of Israel", "published": "Fri 20 Nov 20:36",
  22. "summary": "first ~200 chars of the feed description", "link": "https://..."}
  23. ],
  24. "errors": ["jns: ConnectTimeout"]
  25. }
  26. ```
  27. `errors` appears only when a feed failed; the other feeds still return. Times are in `NEWS_TZ`.
  28. Duplicate titles across outlets are dropped. Items without a parseable date are dropped.
  29. ### `outlets()`
  30. Lists the configured feeds (`key`, `name`, `default`, `tags`).
  31. ## Configuration
  32. | Env | Default | |
  33. | --- | --- | --- |
  34. | `FEEDS_FILE` | bundled `src/rss_headlines_mcp/feeds.json` | Your feed list (same shape) |
  35. | `NEWS_TZ` | `TZ`, else `UTC` | Zone for `published` and `now` |
  36. | `CACHE_SECONDS` | `300` | Per-feed cache; a failing feed falls back to its last good copy |
  37. | `HOST` / `PORT` | `0.0.0.0` / `8000` | Streamable HTTP, path `/mcp`, stateless, JSON responses |
  38. | `MCP_TRANSPORT` | `streamable-http` | or `stdio` |
  39. Feed entry:
  40. ```json
  41. {"key": "jpost", "name": "Jerusalem Post", "url": "https://www.jpost.com/rss/rssfeedsfrontpage.aspx",
  42. "default": true, "tags": ["israel", "en"], "tz_override": "Asia/Jerusalem"}
  43. ```
  44. `tz_override` is for feeds that stamp local time with a wrong offset. Found 2026-11-20: the Jerusalem Post
  45. front-page feed labels Israel wall-clock time as `GMT` (an item at 19:47 "GMT" when it was 19:00 UTC), so
  46. its times are reinterpreted as `Asia/Jerusalem`. The other bundled feeds carry correct offsets.
  47. Feed notes (checked 2026-11-20): Times of Israel `/feed/` returns only ~13 items, so a 24 h window holds
  48. most of a day only together with the other outlets; `https://www.timesofisrael.com/liveblog/feed/` is empty.
  49. Ynetnews `StoryRss3082.xml` was last updated 2026-11-15, hence `default: false`. i24news has no working RSS.
  50. ## Run
  51. ```bash
  52. uv sync
  53. uv run rss-headlines-mcp # http://0.0.0.0:8000/mcp
  54. MCP_TRANSPORT=stdio uv run rss-headlines-mcp # for Claude Desktop / Claude Code stdio
  55. docker compose up -d --build # 127.0.0.1:8000/mcp
  56. ```
  57. Claude Code: `claude mcp add news -e MCP_TRANSPORT=stdio -- uvx --from git+https://github.com/danielrosehill/RSS-Headlines-MCP rss-headlines-mcp`
  58. ## Design
  59. Stateless: no subscription database, feeds come from a JSON file. One call fetches the feeds in parallel
  60. (cached), merges, filters by keyword and time, de-duplicates and trims, so the answer stays small enough for
  61. a voice turn.
  62. ## License
  63. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.