Skip to main content
Glama

kzmshx-youtube-mcp

An MCP server for extracting YouTube video transcripts and metadata.

Configuration

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": ["kzmshx-youtube-mcp"]
    }
  }
}

Related MCP server: ytt-mcp

Installation (Optional)

If you prefer to install globally:

pip install kzmshx-youtube-mcp
# or
uv tool install kzmshx-youtube-mcp

Tools

get_transcript

Get transcript text from a YouTube video.

Parameter

Type

Description

url

string

YouTube URL or video ID

language

string

Language code (default: auto)

with_timestamps

bool

Include timestamps (default: false)

Example:

// Input
{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

// Output
{
  "video_id": "dQw4w9WgXcQ",
  "language": "en",
  "transcript": "We're no strangers to love\nYou know the rules and so do I..."
}

get_video_info

Get metadata from a YouTube video.

Parameter

Type

Description

url

string

YouTube URL or video ID

Example:

// Input
{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

// Output
{
  "id": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up",
  "description": "...",
  "duration": 213,
  "channel": "Rick Astley",
  "upload_date": "2009-10-25",
  "view_count": 1500000000,
  "available_languages": ["en", "ja", "es", "fr"]
}

License

MIT

Available Tools

2 tools
get_transcriptA

Get transcript text from a YouTube video.

Args: url: YouTube URL or video ID language: Language code (default: auto-detect) with_timestamps: Include timestamps in output

Returns: Dict containing video_id, language, and transcript text

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes
languageNoauto
with_timestampsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, but the description explains the return structure (dict with video_id, language, transcript). It does not disclose potential errors, rate limits, or side effects, but for a simple read operation, basic behavioral context is covered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with a clear structure: a one-line purpose, structured Args, and Returns sections. No redundant information; every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has an output schema (implied), the description adequately explains the return format. It covers the main functionality and parameters, though it could detail error handling or edge cases for full completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but the description adds clear meaning for all three parameters (url, language, with_timestamps) in the 'Args' section, including defaults and purpose. This compensates for the missing schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Get transcript text from a YouTube video,' specifying the verb and resource. It effectively distinguishes from the sibling tool 'get_video_info', which presumably handles video metadata.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, nor does it mention prerequisites or scenarios where it should not be used. It only explains parameters without contextual usage advice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_video_infoA

Get metadata from a YouTube video.

Args: url: YouTube URL or video ID

Returns: Dict containing video metadata

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYes

Output Schema

ParametersJSON Schema
NameRequiredDescription

No output parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description only mentions it returns a dict of metadata but does not disclose side effects (e.g., network call) or whether it is read-only. Minimal behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Short, front-loaded description with clear Args and Returns sections. Every sentence provides necessary information without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite low complexity and presence of output schema, the description lacks any usage context or constraints (e.g., authentication, rate limits). Adequate but not fully comprehensive.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description adds value by specifying the 'url' parameter can be a URL or video ID, beyond the schema's type-only definition.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states 'Get metadata from a YouTube video', specifying the verb and resource. Differentiates from sibling 'get_transcript' which serves a different purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like 'get_transcript'. Missing context on appropriate scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updates
    • First observedget_transcript
    • First observedget_video_info

TDQS

A3.7/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: one retrieves transcript text, the other fetches video metadata. There is no overlap or ambiguity.

Naming Consistency5/5

Both tool names follow a consistent 'get_' prefix with noun (transcript, video_info), forming a predictable verb_noun pattern.

Tool Count3/5

With only 2 tools, the server feels undersized for a YouTube integration. While the tools are focused, the count is on the low end for a typical MCP server.

Completeness2/5

The server covers only two basic reading operations, missing common YouTube actions like searching, listing comments, or managing playlists. Significant gaps exist for a comprehensive YouTube toolset.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    An MCP server that enables users to retrieve YouTube transcripts and perform video or channel searches without requiring Google API keys. It supports transcript chunking and provides tools for detailed video content analysis and channel metadata extraction.
    5
    58
    4
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kzmshx/youtube-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server