YtMCP Server

You can run YtMCP to provide read-only access to YouTube data through sixteen specialized tools. It supports local development via STDIO and production deployment via HTTPS, enabling you to power large language model workflows with reliable YouTube intelligence.

How to use

You connect to the server using an MCP client, then request data through the available tools. The server responds with Markdown-formatted results suitable for ingestion by LLMs. Choose STDIO for local testing or HTTPS for production deployment, and authenticate only as required by your client configuration.

How to install

Prerequisites: Python 3.13 or newer. Ensure you have a Python environment available and a way to install Python packages.

Option A: Install with the UV package manager (recommended for local development)

# Clone the repository
git clone https://github.com/utkarshchaudhary009/ytmcp.git
cd ytmcp

# Install with UV (recommended)
uv sync

# OR install with pip
pip install -e .

Run the server in STDIO mode after installation.

# Using UV
uv run ytmcp

# OR using pip
ytmcp

Production deployment (Render)

You can deploy quickly with an HTTPS endpoint through Render. Use a one-click deployment or a manual setup to customize your environment.

One-Click Deploy: Visit the deployment platform’s render service page to connect your project.

Manual deployment steps you can follow in your Render setup:

Name: ytmcp
Environment: Python 3
Build Command: pip install -e .
Start Command: ytmcp --transport streamable-http --host 0.0.0.0 --port $PORT

Optional environment variable to control logging:

FASTMCP_LOG_LEVEL=INFO```

## Available tools

### search\_videos

Basic keyword search for videos with a configurable limit.

### search\_filtered

Advanced search with filters such as upload date, duration, and sort order.

### get\_trending\_videos

Retrieve currently trending videos.

### find\_channels

Search for channels by name or topic.

### find\_playlists

Discover playlists matching a keyword.

### get\_transcript

Fetch time-synced transcripts or subtitles for a video.

### get\_video\_metadata

Retrieve comprehensive video metadata such as views, tags, and description.

### get\_video\_chapters

Extract video chapters and key moments.

### get\_thumbnail

Obtain high-resolution thumbnail URLs for videos.

### get\_comments

Fetch top comments for a video with safe-rate limits.

### get\_channel\_videos

List videos from a channel with sorting options.

### get\_channel\_shorts

List YouTube Shorts from a channel.

### get\_channel\_streams

List live streams associated with a channel.

### get\_playlist\_items

Flatten and list items within a playlist.

### get\_channel\_about

Channel description and statistics.

### get\_audio\_stream\_url

Get direct audio stream URLs for a media item.