commit 1afdd499994315a3d607c93cf94458878dbe841a
parent 880ab0de8cb1bffd9453acc59c833c9ddb649f8c
Author: I Mean I'm Just Saying <imeanimjustsaying@kiwifarms.st>
Date: Fri, 9 Oct 2026 11:20:05 -0400
docs: the MCP README lists list_tags; the README's docs table names AGENTS and the generated key references
mcp/README.md's tool table now has every tool the server advertises (TOOLS in mcp/src/server.ts: list_tags was
missing). README's Documentation table adds SETTINGS, SITE, CHANNEL, REPORT, CITATIONS and AGENTS.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Diffstat:
2 files changed, 7 insertions(+), 0 deletions(-)
diff --git a/README.md b/README.md
@@ -644,6 +644,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) to work on the code.
| [PUBLISH.md](PUBLISH.md) | Building and deploying sites: Pages + R2, cost-abuse protection, parallel builds in containers. |
| [SCHEDULED_SYNC.md](SCHEDULED_SYNC.md) | Unattended per-channel syncing. |
| [WORKTREES.md](WORKTREES.md) | Parallel checkouts and the port scheme. |
+| [SETTINGS.md](SETTINGS.md) | Every `settings.json` key (generated). |
+| [SITE.md](SITE.md) | Every `site.json` key (generated). |
+| [CHANNEL.md](CHANNEL.md) | Every key of a channel's `config.json` (generated). |
+| [REPORT.md](REPORT.md) | The cited report document, `report.json` (generated). |
+| [CITATIONS.md](CITATIONS.md) | The citation model every cited document shares (generated). |
+| [AGENTS.md](AGENTS.md) | Instructions for coding agents working in this repo. |
| [mcp/README.md](mcp/README.md) | The MCP server: tools, links, client setup. |
## License
diff --git a/mcp/README.md b/mcp/README.md
@@ -15,6 +15,7 @@ clip window; the MCP itself still writes nothing.
| Tool | What it does |
|------|--------------|
| `list_channels` | List channels **organized under their channel groups** (name, slug, video count; site in hub mode), with a compact group cheat-sheet (`id · name · N channels`) for scoping. |
+| `list_tags` | The **curated tags** the archive publishes (the operator's cross-channel vocabulary, what `tags` on `search_transcripts` / `enumerate_matches` filters by): each tag's id, label, group, how many videos carry it on this source, and the per-channel breakdown. Not the yt-dlp keywords `scopes:["tags"]` searches. A source that publishes none says so. |
| `list_reports` / `get_report` | The cited reports a site publishes (corpus spec 5): the index (title, kind, claim and citation counts, a fact-check's verdict tally), then one report's sections and claims with every citation's **verbatim quote, original URL and the site's moment page**. See [Cited reports](#cited-reports). |
| `search_transcripts` | Search captions for a term/phrase (or regex); returns matching videos with timestamped snippets — **each `[mm:ss]` is a clickable link to that exact moment** (or a compact `[mm:ss\|sec]` with `link_style:"base"`). Alias-aware, pageable, and **filterable** (`states`, `date_from`/`date_to`, `media_type`, `age`, `exclude`, `scopes`). A page that isn't the whole match set is flagged **above** the hits. |
| `enumerate_matches` | A query's **complete** match set as a worklist (id/title/channel/date + batch count) in **one scan**. Takes the **same filters** as `search_transcripts`, so the two can never disagree about coverage. The tool to use whenever you need to count or cover everything. |
