Ytstream Download Youtube Videos

This MCP Server gives you programmatic access to the Ytstream Download Youtube Videos API. It lets your application request video data and download information through a simple, standardized MCP interface, with a single API key-based authentication.

How to use

You can use this MCP server with any MCP client that supports stdio-based servers. Start by provisioning the server through your MCP platform or locally, then point your client at the local/remote endpoint as needed. The server exposes a download endpoint that returns streaming or download information for YouTube videos, based on the video ID and optional geo/language preferences.

How to install

Prerequisites: Python is available on your system and you can install Python packages with pip. You also need a working MCP client environment if you plan to connect to this server through an MCP platform.

From PyPI install the package to get started quickly.

Install the package from PyPI:

pip install bach-ytstream_download_youtube_videos

If you prefer to run from source, install in editable mode so you can develop against it:

pip install -e .

Run the server using uvx (recommended, it handles setup for you):

uvx --from bach-ytstream_download_youtube_videos bach_ytstream_download_youtube_videos

You can also run directly in development mode with Python if you prefer:

python server.py

If you install the package and want to run it as a command, install the package and then execute the command name (underscores are used in the command):

pip install bach-ytstream_download_youtube_videos
bach_ytstream_download_youtube_videos

Additional setup and usage notes

Configure authentication by setting an API key in your environment. This API requires an API key to be provided via the API_KEY environment variable.

export API_KEY=your_api_key_here

Environment and configuration

Environment variables you can set when running the server:

export API_KEY=your_api_key_here

In Cursor MCP configuration

If you use the Cursor MCP client, add the following to your Cursor MCP configuration file (usually ~/.cursor/mcp.json):

{
  "mcpServers": {
    "bach_ytstream": {
      "command": "uvx",
      "args": ["--from", "bach_ytstream_download_youtube_videos", "bach_ytstream_download_youtube_videos"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

In Claude Desktop configuration

If you use Claude Desktop, add the MCP server configuration to claude_desktop_config.json similar to the Cursor example:

{
  "mcpServers": {
    "bach_ytstream": {
      "command": "uvx",
      "args": ["--from", "bach_ytstream_download_youtube_videos", "bach_ytstream_download_youtube_videos"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available endpoints and usage patterns

This server provides a downloadstream tool to fetch or stream information for YouTube videos. The endpoint is accessible via the MCP interface and accepts required and optional parameters to tailor the response to the end user’s location and preferred language.

Endpoint example (described for context only): you supply a video id and optionally a country code and language code to retrieve the appropriate stream info.

Available tools

downloadstream

Stream or fetch information about a YouTube video using the download endpoint