mcp-rss

An MCP (Model Context Protocol) server that exposes RSS and Atom feeds as tools for AI agents. Connect any Claude Desktop or MCP-compatible client and let it read, search, and manage news feeds.

Tools

Tool	Description
fetch_feed(url)	Fetch and parse an RSS or Atom feed. Returns metadata and all entries.
search_entries(url, query)	Search entries by keyword across title, summary, content, and author.
get_entry(url, id)	Get a single entry by its ID or link URL.
list_subscriptions()	List all saved feed subscriptions.
add_subscription(url, label)	Save a feed URL as a named subscription.
remove_subscription(url)	Remove a saved subscription by its URL.

Fetched feeds are cached in memory (5 minutes by default). Subscriptions are persisted to ~/.config/mcp-rss/subscriptions.json.

Installation

npm install -g @christianecg/mcp-rss

Claude Code configuration

claude mcp add --scope global rss npx -- -y @christianecg/mcp-rss

Claude Desktop configuration

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "rss": {
      "command": "npx",
      "args": ["-y", "@christianecg/mcp-rss"]
    }
  }
}

Restart Claude Desktop. You can then ask Claude things like:

• "What are the latest posts on https://hnrss.org/frontpage?"
• "Search the Hacker News feed for anything about TypeScript."
• "Save https://hnrss.org/frontpage as 'Hacker News'."

Environment variables

Variable	Default	Description
MCP_RSS_TTL_MS	300000	Feed cache TTL in milliseconds.

Local development

pnpm install
pnpm build
pnpm start

Or point Claude Desktop at the local build:

{
  "mcpServers": {
    "rss": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-rss/dist/index.js"]
    }
  }
}

License

MIT © Christian ECG