rss-mcp
Provides tools for managing RSS and Atom subscriptions, fetching feeds, listing and reading cached entries, full-text search, marking entries read or unread, and importing/exporting OPML.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rss-mcp subscribe to https://hnrss.org/frontpage and fetch the latest entries"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rss-mcp
Agent-only MCP server for RSS and Atom. A host drives it over stdio. There is no GUI, TUI, or interactive CLI. Subscriptions, cached entries, unread state, and full-text search live in one local SQLite file. v1 is tools only: no resources, prompts, or MCP Apps.
Protocol: MCP 2026-07-28 (stdio, tools) via the official Python SDK v2 (mcp ≥ 2.3). Design: docs/superpowers/specs/2026-11-18-rss-mcp-design.md.
Requires Python 3.11+.
Host config
The process reads JSON-RPC from stdin and writes MCP messages only to stdout. It exits when stdin closes.
Cursor mcp.json (any stdio host can use the same command):
{
"mcpServers": {
"rss-mcp": {
"command": "uvx",
"args": ["--from", "/absolute/path/to/rss-mcp", "rss-mcp"],
"env": {
"RSS_MCP_DB": "/absolute/path/rss.db"
}
}
}
}uvx rss-mcp once the package is on an index. From this checkout: uv run rss-mcp.
Related MCP server: mcp-feed-reader-crunchtools
Environment
Variable | Default |
|
|
|
|
list_entries and search_entries use limit 20 when omitted and clamp to 0–100. Each fetch upserts at most 50 entries and sends stored ETag / Last-Modified when the feed has them.
Tools
add_subscription— Add a feed by URL. Repeating a URL returns the existing subscription.remove_subscription— Delete a subscription and its cached entries.list_subscriptions— List subscriptions with unread counts.fetch_feed— Fetch one subscription, or every subscription when the id is omitted.list_entries— List cached entries (article bodies omitted). Limit falls back to the server default and is clamped.read_entry— Return one entry with full content.fetch_fullreplaces content only when article text is returned.mark_readmarks it read.search_entries— Full-text search over cached title, summary, and content (bodies omitted; useread_entryfor full text).mark_entry— Mark entries read or unread. Unknown ids are skipped.import_opml— Add each OPML feed. Existing URLs are skipped.export_opml— Export subscriptions as an OPML document.
Live tests
Optional network tests against a real Inoreader OPML export:
uv run pytest tests/test_real_inoreader_opml.py -v -sThey skip when /Users/huangcheng/Downloads/Cheng-Inoreader-feeds-final-20261016.opml is missing. Unit tests do not require that file.
License
MIT © 2026 HUANG Cheng
Available Tools
10 toolsadd_subscriptionA
Add a feed by URL. Repeating a URL returns the existing subscription.
Inputs: url (required), tags, title. Returns: object
export_opmlB
Export subscriptions as an OPML document.
Inputs: no named parameters. Returns: object
fetch_feedA
Fetch one subscription, or every subscription when the id is omitted.
Inputs: subscription_id. Returns: object
import_opmlB
Add each OPML feed. Existing URLs are skipped.
Inputs: opml (required). Returns: object
list_entriesB
List cached entries (bodies omitted). Limit falls back to the server default and is clamped.
Inputs: limit, since, unread_only, subscription_id. Returns: object
list_subscriptionsB
List subscriptions with unread counts.
Inputs: no named parameters. Returns: object
mark_entryA
Mark entries read or unread. Unknown ids are skipped.
Inputs: read (required), entry_ids (required). Returns: object
read_entryB
Return one entry. fetch_full replaces content only when article text is returned. mark_read sets read state.
Inputs: entry_id (required), mark_read, fetch_full. Returns: object
remove_subscriptionB
Delete a subscription and its cached entries.
Inputs: subscription_id (required). Returns: object
search_entriesA
Full-text search over cached title, summary, and content. Omits entry bodies; use read_entry for full content.
Inputs: query (required), limit, unread_only, subscription_id. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Most tools map to distinct resource+action pairs (subscriptions vs. entries vs. OPML), and descriptions clarify boundaries like cached listing vs. network fetch. Minor overlap remains: add_subscription vs. import_opml both add feeds, and read_entry's mark_read flag partially duplicates mark_entry.
Every tool is snake_case verb_noun (add_subscription, list_entries, read_entry, export_opml), with consistent verb choices (list/read/search/fetch/mark) across resources. No convention mixing.
Ten tools is well within the ideal range and each covers a distinct part of the RSS lifecycle: subscription management, fetching, entry reading/searching, read state, and OPML transfer. No tool feels redundant or padded.
The surface covers the core lifecycle: add/remove/list subscriptions, fetch, list/read/search entries, mark read state, and OPML import/export. Gaps are minor, such as no update/edit for an existing subscription (rename, polling settings) and no folder/category grouping.
Maintenance
Related MCP Connectors
RSS & Atom feed manager with full-text search, AI curation, and remote MCP endpoint.
Managed cloud RSS and Atom feed reader with a remote Model Context Protocol (MCP) endpoint. Zero server setup required — enables AI agents like Claude to instantly subscribe to feeds, search full-text articles, extract readable content, and access curated AI editions ("Your Newspaper") over secure streamable HTTP.
RSS, Atom and JSON feeds for agents: find a site's feed, read items as JSON, keyless news search.
Personal podcast queue and private RSS feed managed through a bounded MCP tool set.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for fetching, parsing, and managing RSS feeds. Features Fetch and parse RSS/Atom feeds In-memory caching with TTL Batch fetching of multiple feeds Monitor feeds for new items Search content across multiple feeds Extract and format feed content636 npm12Apache 2.0
- AlicenseBqualityBmaintenanceSecure MCP server for RSS/Atom feed reading with SQLite backend. Enables feed management, entry search, and OPML import/export.17AGPL 3.0
- AlicenseAqualityCmaintenanceLocal MCP server for reading and searching RSS and Atom feeds, enabling AI assistants to fetch feed contents, search entries by keyword, and view feed metadata without any cloud intermediary.3MIT
- AlicenseAqualityDmaintenanceFetches and reads RSS/Atom feeds, enabling MCP clients to pull latest items from blogs, news sites, and release feeds and build digests.237 npmMIT