Skip to content

feat(mcp): subscribe to news feeds in one step - #530

Merged
adeelahmad merged 1 commit into
mainfrom
claude/project-thread-8xn6n8
Oct 18, 2026
Merged

adeelahmad merged 1 commit into
mainfrom
claude/project-thread-8xn6n8

Conversation

@adeelahmad

Copy link
Copy Markdown
Owner

Requested by Adeel · project thread

Description

Before: an agent following a news feed (#453) had to create a source, then add a watch, over the generic source and watch tools.

After: subscribe_feed (MCP with a write-scope token, and the assistant, admins only) takes a feed's address or a site's page and a namespace, reads the feed first and keeps it only if it works, names it by the feed's title, and adds the watch; a feed already followed is reused. news_feeds lists what's followed (addresses stay sealed) and unsubscribe_feed stops one, keeping the posts it brought in. The assistant's versions ask first outside a setup conversation, and the result never echoes the feed's own words.

How: rss.py gains subscribe, subscriptions and unsubscribe on top of the existing source and watch code; mcp_tools.py and ops_tools.py expose them; ai_tools.py routes the two writes through the existing approval path. The threat model's news feed row now names who can add a feed.

Motivation and Context

Agent-first (AGENTS.md): everything a person does in the web app an agent can do too, and following a feed should be one step for an agent.

Steps to reproduce (if appropriate):

pytest tests/api/test_news_feed_source.py::test_subscribing_in_one_step tests/api/test_setup_assistant.py::test_the_assistant_follows_news_feeds

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change; ! in the title)

Checklist:

  • The title is a Conventional Commit.
  • My code follows the code style of this project (make hooks checks it on commit).
  • I added or updated tests.
  • My change requires documentation updates, and I have updated docs/ accordingly.
  • Users need more than the title to understand it, so I wrote it under ## Unreleased in CHANGELOG.md.

Done questions (AGENTS.md)

  • Goal: agents follow, list and stop news feeds in one step; merging on green.
  • Agents: this is the agent surface (MCP and the assistant).
  • Zero setup: yes.
  • Fewest clicks: one call instead of two; the namespace and backfill have defaults.
  • Configurable: no new setting; the assistant tools show in Settings' AI tools list.
  • Light: no new dependency.
  • Private and secure: admins only, write-scope token for MCP; addresses stay sealed in every listing; the assistant asks first outside setup; threat model updated.
  • Cost: no model call.
  • User decides: the assistant's subscribe and unsubscribe wait for approval outside a setup conversation.
  • Upgrades: no change to stored data's shape.
  • Honest: requirements row names both tests; docs list the tools.
  • Tested and documented: tests added; docs/mcp.md, docs/assistant.md and docs/processing.md updated; nothing generated changed.
  • Open: RSS and Atom; MCP.
  • Reported: in the project thread.
  • Reuse: reuses the source, watch and approval code.

Local CI (ci/local-ci.sh) on the same change one commit back (6ea0612): FastAPI (embedded SurrealDB), Next.js, pre-commit and title pass; on this head the news feed, MCP and setup assistant tests pass and validate_threat_model.py --base origin/main agrees.


Generated by Claude Code

Agents can now follow a news feed without the two-step source-then-watch
dance: subscribe_feed (MCP and the assistant, admins) takes an address or
a site's page and a namespace, reads the feed first and keeps it only if
it works, names it by the feed's title, and adds the watch; a feed
already followed is reused. news_feeds lists what's followed (addresses
stay sealed) and unsubscribe_feed stops one, keeping the posts. The
assistant's changes ask first outside a setup conversation, and its
result never echoes the feed's own words.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SWH8a26M9wkAPq2eRrfWZK
@adeelahmad adeelahmad self-assigned this Oct 17, 2026
@adeelahmad
adeelahmad merged commit a0781ae into main Oct 18, 2026
12 checks passed
@adeelahmad
adeelahmad deleted the claude/project-thread-8xn6n8 branch October 18, 2026 01:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants