tubearchivist-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port. Default 3000. | 3000 |
| MCP_TRANSPORT | No | Transport mode: stdio or http. --http overrides this. | |
| TUBEARCHIVIST_URL | Yes | Required. Origin only, http or https, with no userinfo, query, hash, or path. Example: http://127.0.0.1:8000. Do not append /api. | |
| TUBEARCHIVIST_TOKEN | No | Required unless TUBEARCHIVIST_TOKEN_FILE is set. Sent as Authorization: Token. Redacted in logs, errors, previews, and results. Minimum 8 characters. | |
| TUBEARCHIVIST_CONTACT | No | Contact token in the User-Agent. Must not contain the API token. | |
| TUBEARCHIVIST_PER_MINUTE | No | Local request budget per minute. Default 30. Cache hits do not spend it. | 30 |
| TUBEARCHIVIST_TIMEOUT_MS | No | Upstream timeout in milliseconds. Default 20000. | 20000 |
| TUBEARCHIVIST_TOKEN_FILE | No | Optional. Path to a chmod 600 file whose trimmed contents are the token. Used when TUBEARCHIVIST_TOKEN is omitted. | |
| TUBEARCHIVIST_ALLOW_WRITES | No | Must be the literal true before a confirmed write is sent. | |
| TUBEARCHIVIST_CACHE_TTL_SEC | No | Read cache TTL in seconds. Default 60. Writes clear the cache. | 60 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ta_channelA | List, search, subscribe, update, and delete channels. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: list (GET /api/channel/), subscribe (POST /api/channel/), search (GET /api/channel/search/), get (GET /api/channel/{channel_id}/), update (POST /api/channel/{channel_id}/), delete (DELETE /api/channel/{channel_id}/), aggs (GET /api/channel/{channel_id}/aggs/), nav (GET /api/channel/{channel_id}/nav/). |
| ta_configA | Application settings and YouTube cookie status. Cookie values are redacted. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: get (GET /api/appsettings/config/), update (POST /api/appsettings/config/), cookie_status (GET /api/appsettings/cookie/), cookie_validate (POST /api/appsettings/cookie/), cookie_import (PUT /api/appsettings/cookie/), cookie_revoke (DELETE /api/appsettings/cookie/). |
| ta_downloadA | Read and change the download queue, including add, priority start, and delete. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: list (GET /api/download/), add (POST /api/download/), bulk_update (PATCH /api/download/), bulk_delete (DELETE /api/download/), aggs (GET /api/download/aggs/), get (GET /api/download/{video_id}/), update (POST /api/download/{video_id}/), delete (DELETE /api/download/{video_id}/). |
| ta_libraryA | Reindex progress and watched-state changes for a video, channel, or playlist. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: refresh_status (GET /api/refresh/), refresh (POST /api/refresh/), watched (POST /api/watched/). |
| ta_maintenanceA | Snapshots, zip backups, filesystem rescan, and manual import. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: snapshots (GET /api/appsettings/snapshot/), snapshot_create (POST /api/appsettings/snapshot/), snapshot_get (GET /api/appsettings/snapshot/{snapshot_id}/), snapshot_restore (POST /api/appsettings/snapshot/{snapshot_id}/), snapshot_delete (DELETE /api/appsettings/snapshot/{snapshot_id}/), backups (GET /api/appsettings/backup/), backup_create (POST /api/appsettings/backup/), backup_get (GET /api/appsettings/backup/{filename}/), backup_restore (POST /api/appsettings/backup/{filename}/), backup_delete (DELETE /api/appsettings/backup/{filename}/), rescan (POST /api/appsettings/rescan-filesystem/), import (POST /api/appsettings/manual-import/). |
| ta_mediaA | Subtitle tracks as WebVTT text. Binary media is not exposed. Reads only. Actions: subtitle (GET /media/subtitle/{channel_id}/{video_id}.{lang}.vtt). |
| ta_notifyA | Read and edit webhook URLs stored on scheduled tasks. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: list (GET /api/task/notification/), add (POST /api/task/notification/), remove (DELETE /api/task/notification/). |
| ta_playlistA | List, subscribe, update, and delete playlists, including custom playlists. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: list (GET /api/playlist/), subscribe (POST /api/playlist/), create_custom (POST /api/playlist/custom/), update_custom (POST /api/playlist/custom/{playlist_id}/), get (GET /api/playlist/{playlist_id}/), update (POST /api/playlist/{playlist_id}/), delete (DELETE /api/playlist/{playlist_id}/). |
| ta_searchA | Full-text search across videos, channels, and playlists. Reads only. Actions: search (GET /api/search/). |
| ta_statsC | Library, download, and watch statistics. Reads only. Actions: video (GET /api/stats/video/), channel (GET /api/stats/channel/), playlist (GET /api/stats/playlist/), download (GET /api/stats/download/), watch (GET /api/stats/watch/), download_history (GET /api/stats/downloadhist/), biggest_channels (GET /api/stats/biggestchannels/). |
| ta_systemA | Ping, health, and in-app notification messages. Reads only. Actions: ping (GET /api/ping/), health (GET /api/health/), notifications (GET /api/notification/). |
| ta_taskA | Read task results, start or stop tasks, and manage schedules. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: results (GET /api/task/by-name/), results_by_name (GET /api/task/by-name/{task_name}/), start (POST /api/task/by-name/{task_name}/), get (GET /api/task/by-id/{task_id}/), command (POST /api/task/by-id/{task_id}/), schedules (GET /api/task/schedule/), schedule_get (GET /api/task/schedule/{task_name}/), schedule_upsert (POST /api/task/schedule/{task_name}/), schedule_delete (DELETE /api/task/schedule/{task_name}/). |
| ta_userA | The account behind the token and per-user view preferences. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: account (GET /api/user/account/), me (GET /api/user/me/), update (POST /api/user/me/). |
| ta_videoA | List, read, delete, navigate, and comment on archived videos, plus playback progress. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: list (GET /api/video/), get (GET /api/video/{video_id}/), delete (DELETE /api/video/{video_id}/), nav (GET /api/video/{video_id}/nav/), similar (GET /api/video/{video_id}/similar/), comments (GET /api/video/{video_id}/comment/), progress_set (POST /api/video/{video_id}/progress/), progress_clear (DELETE /api/video/{video_id}/progress/). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Each tool is scoped to a distinct resource domain (channel, video, playlist, download, task, config, etc.), so most selections are unambiguous, and the embedded action lists plus HTTP endpoints further disambiguate. A few edges blur: ta_system.notifications (in-app) versus ta_notify (webhook URLs on scheduled tasks), and ta_library.refresh (reindex) versus ta_maintenance.rescan versus ta_task.start, could be confused by an agent.
All 14 tools follow an identical ta_<resource> pattern with singular resource nouns, and sub-operations are consistently expressed as named actions inside each tool. No camelCase/snake_case mixing or ad-hoc verb prefixes anywhere.
14 tools is squarely in the well-scoped range and maps one-to-one onto TubeArchivist's resource domains rather than exposing each of the ~70 REST actions as a separate tool. The grouping keeps the surface navigable without omitting functionality.
Coverage is unusually thorough: full CRUD for channels, playlists (including custom), downloads, tasks and schedules, snapshots/backups, config/cookies, user prefs, plus stats, search, subtitles and watched-state. Minor gaps remain — no operation to add an individual video to a custom playlist, comments are read-only, and there is no search-suggestion/autocomplete action.