Skip to main content
Glama
tubearchivist-mcp

tubearchivist-mcp

by si-essence

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoHTTP port. Default 3000.3000
MCP_TRANSPORTNoTransport mode: stdio or http. --http overrides this.
TUBEARCHIVIST_URLYesRequired. Origin only, http or https, with no userinfo, query, hash, or path. Example: http://127.0.0.1:8000. Do not append /api.
TUBEARCHIVIST_TOKENNoRequired unless TUBEARCHIVIST_TOKEN_FILE is set. Sent as Authorization: Token. Redacted in logs, errors, previews, and results. Minimum 8 characters.
TUBEARCHIVIST_CONTACTNoContact token in the User-Agent. Must not contain the API token.
TUBEARCHIVIST_PER_MINUTENoLocal request budget per minute. Default 30. Cache hits do not spend it.30
TUBEARCHIVIST_TIMEOUT_MSNoUpstream timeout in milliseconds. Default 20000.20000
TUBEARCHIVIST_TOKEN_FILENoOptional. Path to a chmod 600 file whose trimmed contents are the token. Used when TUBEARCHIVIST_TOKEN is omitted.
TUBEARCHIVIST_ALLOW_WRITESNoMust be the literal true before a confirmed write is sent.
TUBEARCHIVIST_CACHE_TTL_SECNoRead 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 14 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues