Skip to main content
Glama
rss-mcp

rss-mcp

by huangcheng

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

RSS_MCP_DB

~/.local/share/rss-mcp/rss.db

RSS_MCP_USER_AGENT

rss-mcp/0.1 (+https://github.com/huangcheng/rss-mcp)

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_full replaces content only when article text is returned. mark_read marks it read.

  • search_entries — Full-text search over cached title, summary, and content (bodies omitted; use read_entry for 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 -s

They 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 tools
add_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

    A3.6/5.0

    Scored across 10 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP 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 content
      6
      36 npm
      12
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Secure MCP server for RSS/Atom feed reading with SQLite backend. Enables feed management, entry search, and OPML import/export.
      17
      AGPL 3.0
    • A
      license
      A
      quality
      C
      maintenance
      Local 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.
      3
      MIT