Newsroom

newsroom_list_sources

List all configured news/social sources for the current workspace.

newsroom_add_source

Add a news/social source by URL. RSS/Atom feeds are parsed directly; social URLs (Reddit/HN/Bluesky) are normalized to RSS. Set discover=true to auto-find the feed from a website URL.

newsroom_update_source

Update a source. Only send fields you want to change. Use is_active=false to pause. Provide url and source_type to fix a broken feed URL.

newsroom_delete_source

Delete a source and all its items.

newsroom_get_source

Get details for a specific source.

newsroom_discover_feed

Discover the RSS/Atom feed URL for a website without adding a source. Returns the feed URL if found, or scraped page metadata as a fallback.

newsroom_fetch_now

Fetch a single source immediately and ingest new items (deduplicated by content hash). Returns counts of new vs duplicate items.

scheduled_fetch

Fetch all active sources whose fetch interval has elapsed (called by the scheduler). Optionally scope to one workspace.

newsroom_list_items

List items from the unified feed, newest first. Filter by source, collection, starred, or unread.

newsroom_search_items

Full-text search across all items in the workspace. Supports quoted phrases and boolean operators (AND/OR/NOT) via websearch_to_tsquery.

newsroom_get_item

Get a single item by ID.

newsroom_mark_read

Mark an item as read.

newsroom_mark_unread

Mark an item as unread.

newsroom_toggle_star

Star or unstar an item (bookmark). Set is_starred=true to star, false to unstar; omit to toggle the current value.

newsroom_get_overview

Dashboard overview: counts of sources, total items, unread items, and items published today.

newsroom_list_collections

List all source collections (watchlists) for the current workspace.

newsroom_create_collection

Create a named collection (watchlist) of sources.

newsroom_update_collection

Update a collection. Only send fields you want to change.

newsroom_delete_collection

Delete a collection (does not delete the sources inside it).

newsroom_add_source_to_collection

Add a source to a collection. A source appears at most once per collection.

newsroom_remove_source_from_collection

Remove a source from a collection.

newsroom_list_collection_items

List the sources in a collection.

newsroom_list_global_sources

List the shared global source library (maintained by the crawler / admin) with the calling workspace's subscription state. Global sources are readable by every workspace; is_subscribed reflects opt-out semantics (true = visible, false = opted out).

newsroom_set_subscription

Subscribe to or unsubscribe from a global source for the current workspace. Global sources are visible by default (opt-out); set is_subscribed=false to hide a source, true to re-show it.