Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PYTHONUTF8NoSet to 1 to enable Python UTF-8 mode, as shown in the Claude Code and Claude Desktop/Cursor configuration examples.
TUBELENS_EXTRA_HOSTSNoComma-separated list of additional allowed hosts beyond YouTube, e.g. "vimeo.com,www.vimeo.com".

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": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
video_infoC

Get YouTube video metadata: title, channel, stats, upload date, tags, chapters, description.

video_commentsA

Read YouTube comments. sort: 'top' or 'new'. replies=True adds replies (3 per thread). query: comma-separated terms; scans up to scan comments and returns only those containing any term (case-insensitive), e.g. query="broke,refund,scam". Each comment is cut to max_chars_each.

video_transcriptA

Get video transcript (manual subs first, then auto-captions). lang='auto' (default) uses the video's spoken language; or force e.g. 'en', 'tr'. Lines merge into ~chunk_seconds blocks (0 = raw) to save tokens. Use start/end ('1:30') to read one part of a long video. No captions? use transcribe_video.

batch_transcriptsB

Transcripts of several videos in one call (max 8), each merged into 30s blocks and capped.

find_in_videoB

Find WHERE a topic is said in a video. query: comma-separated terms (any match). Returns timestamped caption lines (with a little context). frames=True also returns the video frame at each hit.

youtube_searchB

Search YouTube. sort: 'relevance' or 'date' (newest first). Optional filters: min_views, min_minutes, max_minutes (0 = off). Returns title, channel, duration, views, URL.

youtube_researchA

Research a topic on YouTube in one call. Runs several searches (your queries, or the topic plus 'explained' and 'review' variants), merges and de-duplicates, ranks by views, recency and how many searches surfaced each video, then returns a compact brief per top video: stats, chapters, description, transcript excerpt (start/middle/end) with top terms, and top comments. Follow up with find_in_video, video_comments(query=...) or watch_video on the most promising ones. n_videos max 8.

channel_videosB

List recent videos of a channel or playlist URL (e.g. https://www.youtube.com/@name/videos).

channel_statsA

Quick channel analysis over its latest n videos (max 50): average/median views, best videos, typical length and upload cadence. url like https://www.youtube.com/@name/videos

watch_videoA

'Watch' a video: returns frames (images, each labelled with timestamp) plus the transcript for the same range. mode='even' spaces frames evenly; mode='scenes' samples twice as many moments and keeps the ones that differ most (best for slides, demos, edited videos). Use start/end ('90', '1:30') to zoom in and call again for detail. n_frames max 24 (default 6); width 512 saves tokens, raise to ~768 only to read small on-screen text (or use ocr_frames).

ocr_framesA

Read the TEXT shown in a video (slides, code, UI, burned-in subtitles) without returning images, so it is cheap in tokens. Frames come from scene changes (default) or even spacing. Output: timestamp and recognised text per frame. Runs locally (rapidocr), no cloud.

transcribe_videoA

Transcribe the SPEECH of a video locally with Whisper (faster-whisper, CPU) when it has no usable captions. model: tiny | base | small (bigger = slower, more accurate). lang: 'en', 'tr'... or empty to auto-detect. Max 30 min per call, so use start/end for long videos. First run downloads the model once.

doctorA

Self-check: versions, which optional features are installed, and whether YouTube is reachable. Run this first if any tool misbehaves.

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 13 tools

Disambiguation4/5

Each tool targets a distinct capability (metadata, comments, transcript, search, channel listing, frames, OCR, local ASR), and the descriptions explicitly state fallback relationships (e.g. video_transcript -> transcribe_video when captions are missing). The only mild overlaps are the frame-producing tools (watch_video, ocr_frames, find_in_video with frames=True) and transcript variants (video_transcript vs batch_transcripts), but the descriptions make the intended split clear.

Naming Consistency4/5

All names are lowercase snake_case and readable, with no camelCase or style mixing. The pattern is slightly heterogeneous: some are verb-led (find_in_video, watch_video, transcribe_video, ocr_frames) and others noun-led (video_info, channel_stats, youtube_search), plus a bare 'doctor', but this is a minor deviation rather than confusion.

Tool Count5/5

13 tools sit comfortably in the well-scoped range, and each one earns its place: core reads, search/research aggregation, channel analysis, frame/OCR inspection, and a local ASR fallback. Nothing feels redundant or padded, and there are no missing bulk/utility helpers.

Completeness5/5

For a YouTube analysis/research domain the surface is thorough: metadata, comments, transcripts (single and batch), in-video search, search and multi-query research, channel/playlist listing and stats, visual frames, OCR, and a Whisper fallback for uncaptioned videos, plus a doctor self-check. Read-only by design, so the absence of write operations is not a gap.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues