Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YT_MCP_MODE | No | Operating mode: 'standalone' (uses youtube-transcript-api directly) or 'backend' (connects to a running transcript service). | standalone |
| YT_MCP_TRANSPORT | No | Transport protocol to use: 'stdio' or 'streamable-http'. | stdio |
| YT_MCP_BACKEND_URL | No | Backend service URL, used when YT_MCP_MODE is set to 'backend'. | http://localhost:8300 |
| YT_MCP_CACHE_MAX_SIZE | No | Maximum number of entries allowed in the cache. | 100 |
| YT_MCP_BACKEND_API_KEY | No | API key for backend, used when YT_MCP_MODE is set to 'backend'. | |
| YT_MCP_CACHE_TTL_SECONDS | No | Cache Time-To-Live in seconds. | 3600 |
| YT_MCP_RATE_LIMIT_PER_MINUTE | No | Maximum number of requests allowed per minute. | 30 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_transcript | Get the full transcript of a YouTube video in the specified language and format. |
| search_transcript | Search for keywords or phrases in a YouTube video transcript and return matching segments with timestamps. |
| get_transcript_summary | Get a transcript organized into time-based chunks for easier analysis of long videos. |
| batch_transcripts | Get transcripts for multiple YouTube videos in a single request (max 10 videos). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| summarize_video | Generate a comprehensive summary of a YouTube video from its transcript. |
| compare_videos | Compare the content of two YouTube videos side by side. |
| find_key_moments | Find and analyze key moments in a video related to a specific topic. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| help_resource | Usage guide for the YouTube Transcript MCP server with examples for all tools. |