feed-all 0.2.0

Portable RSS, Atom, webpage tracking, and MCP service

feed-all

Portable RSS, Atom, webpage subscription, article reading, and MCP service.

Install

The workspace implementation is currently 0.2.0. For a local checkout:

uv run --directory rss-plugin feed-all

After a release is published to PyPI, the portable installation is:

uvx feed-all

Use FEED_ALL_DATA_DIR to select the SQLite data directory. The default is ~/.feed-all. Local/private URLs are disabled by default; set FEED_ALL_ALLOW_PRIVATE_URLS=1 only for controlled tests.

Host configuration

Claude Code/Desktop and compatible MCP hosts use JSON:

{
  "mcpServers": {
    "feed-all": {
      "command": "uvx",
      "args": ["feed-all"]
    }
  }
}

For a local checkout, replace the command and args with:

{
  "command": "uv",
  "args": ["run", "--directory", "/ABSOLUTE/PATH/rss-plugin", "feed-all"]
}

Codex uses TOML:

[mcp_servers.feed_all]
command = "uvx"
args = ["feed-all"]

The MCP tools/list response is the authoritative runtime contract. The current tool names are recorded in references/tools.md.

Workflow

1. Discover or preview a URL with rss_discover or rss_fetch.
2. Subscribe with rss_subscribe (rss, atom, or webpage).
3. Refresh one source or all sources with rss_refresh.
4. Search and read with rss_list_entries, rss_search, and rss_get_entry.
5. Use rss_check_health when diagnosing a source.

The skill documentation is available in SKILL.md. The compatibility skill name rss-plugin-installer is retained for hosts that use the GitHub skill's original trigger name.