MCP Feed Reader

Add an RSS/Atom feed by URL, optionally assign to a category. Args: url: Feed URL (RSS, Atom, or RDF) category: Category name (created if it does not exist)

List all feeds with unread counts. Args: category_id: Filter by category ID (optional)

Get details for a single feed including entry counts. Args: feed_id: Feed ID

Remove a feed and all its entries. Args: feed_id: Feed ID to delete

Crawl feed sources over the network for new content. Slow — takes 30-60s for all feeds. Prefer the systemd timer for background updates. Use list_entries to read cached content. Args: feed_id: Specific feed ID to refresh (optional, refreshes all if omitted)

List entries with optional filters. Args: feed_id: Filter by feed ID category_id: Filter by category ID unread_only: Show only unread entries (default: True) limit: Max entries to return (1-500, default: 50) offset: Pagination offset (default: 0)

Get full content of an entry (auto-marks as read). Args: entry_id: Entry ID

Mark entries as read. Args: entry_id: Mark a single entry as read feed_id: Mark all entries in a feed as read all_entries: Mark ALL entries as read (use with caution)

Mark an entry as unread. Args: entry_id: Entry ID

Full-text search across entry titles and content. Args: query: Search query (FTS5 syntax supported) limit: Max results (1-500, default: 50)

List all categories with feed counts.

Create a new category. Args: name: Category name

Rename a category. Args: category_id: Category ID name: New name

Delete a category. Feeds in this category become uncategorized. Args: category_id: Category ID to delete

Import feeds from an OPML file, creating categories from outline groups. Args: file_path: Path to the OPML file

Export all feeds as OPML XML string.

Get dashboard stats: total feeds, unread count, entries per category.