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