tube-bridge
PYPI · TUBE-BRIDGE
YouTube MCP server for search, transcripts, frames, comments, channels, and local semantic corpora.
Available components
Last scanned (22 hours ago)
Scores higher than 82% of PyPI servers
Category Search and Retrieval
Recent critical change
CVE-2026-112398 affects this package (24 Oct 2026). See the changelog before you install this server.
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security82
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects mcp 1.28.1, a direct dependency. A fixed version is available. View diagnostics → Fail
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- Dependency health was assessed across the 71 of 73 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Build provenance not yet verified. View diagnostics → Unverified
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 0 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability81
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1257 tokens (~73/item across 17 items; 17 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Nov 26 0
- Provenance: fail → unverified ▼ security
- Package version: 1.1.6 → 1.1.7 functional
- 3 Nov 26 +16
- Malware scan: unverified → pass ▲ security
- Stability: 0.97 → pass security
- 2 Nov 26 −16
- Malware scan: pass → unverified ▼ security
- Stability: pass → 0.97 functional
- 1 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 31 Oct 26 −15
- Malware scan: pass → unverified ▼ security
- 29 Oct 26 +15
- Malware scan: unverified → pass ▲ security
- 28 Oct 26 0
- CVE-2026-116685 affects this package: high ▼ security
- CVE-2026-116686 affects this package: high ▼ security
- CVE-2026-116684 affects this package: high ▼ security
- 27 Oct 26 +1
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Nov 2026 · Analysed pypi/tube-bridge@1.1.7
Provenance Inconclusive
We could not complete the check, so nothing is claimed either way. This is a gap on our side, not a finding about the package.
| Result | Inconclusive |
|---|---|
| Ecosystem | pypi |
| Reason | Attestation not fetched |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Vulnerabilities 4 findings
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-5h93-6whr-6q8j | CVE-2026-116685 | medium | CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:N/A:N | yes |
| GHSA-84m7-p3x7-pcfv | CVE-2026-59951 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
| GHSA-rwrf-2pqf-9j8j | CVE-2026-116686 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:R/S:U/C:N/I:N/A:H | yes |
| GHSA-w4fh-qvv9-3v23 | CVE-2026-116684 | medium | CVSS:3.1/AV:N/AC:H/PR:L/UI:N/S:U/C:H/I:H/A:N | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 71 packages
| Packages resolved | 71 |
|---|---|
| Stale | 8 |
| No linked repository | 2 |
| Tree resolution | Partial |
The dependency tree was only partially resolved, so these counts may be incomplete.
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
corpus_add ~120
Fetch a video's transcript, chunk it, and store local embeddings in an existing corpus. Use this after `corpus_create`; it skips an already-indexed video by default. `force_reembed=true` deletes and replaces that video's existing local chunks and vectors. This modifies local corpus data and may contact YouTube; returns indexing status and chunk count.
| Name | Type | Req | Description |
|---|---|---|---|
| corpus_id | string | yes | Corpus ID to add to |
| force_reembed | boolean | – | Re-embed even if already indexed |
| url | string | yes | YouTube video URL or ID |
No output schema declared.
No examples provided.
corpus_create ~61
Create a named corpus for semantic search over transcripts. Each corpus uses a fixed embedding model.
| Name | Type | Req | Description |
|---|---|---|---|
| corpus_id | string | yes | Unique corpus ID (e.g. 'iran-hormuz-2026') |
| label | string | – | Human-readable label (optional) |
No output schema declared.
No examples provided.
corpus_delete ~31
Delete a corpus and all its chunks/vectors permanently.
| Name | Type | Req | Description |
|---|---|---|---|
| corpus_id | string | yes | Corpus ID to delete |
No output schema declared.
No examples provided.
corpus_list ~19
List all available corpora with chunk and video counts.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
corpus_search ~73
Semantic search within a corpus. Deduplicates overlapping windows, limits source domination, and returns titles plus timestamp URLs.
| Name | Type | Req | Description |
|---|---|---|---|
| corpus_id | string | yes | Corpus ID to search in |
| query | string | yes | Natural language search query |
| top_k | integer | – | Max results (default 10, max 50) |
No output schema declared.
No examples provided.
tube_bridge_help ~27
Get tube-bridge documentation: available tools, architecture, known limitations, API key setup.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
youtube_get_available_languages ~36
Available subtitle languages for a video. Shows manual vs auto-generated.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | YouTube video URL or ID |
No output schema declared.
No examples provided.
youtube_get_channel_info ~46
Detailed channel metadata: subscribers, views, videos, country, keywords. Requires YOUTUBE_API_KEY.
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | yes | YouTube channel ID (starts with UC...) |
No output schema declared.
No examples provided.
youtube_get_channel_videos ~98
List up to `limit` recent uploads from a known YouTube channel URL or @handle. Use this for channel browsing, not keyword search or channel metadata. Read-only and keyless; returns normalized channel metadata plus video records. Empty results include a warning when the channel is missing or has no uploads.
| Name | Type | Req | Description |
|---|---|---|---|
| channel_url | string | yes | Channel URL or @handle |
| limit | integer | – | Max videos (default 10) |
No output schema declared.
No examples provided.
youtube_get_comments ~100
Retrieve up to `max_results` top-level comments for a known YouTube video. Use this for audience reactions, not video metadata or transcripts. Read-only and requires `YOUTUBE_API_KEY`; returns structured comment records. Calls may fail when comments are disabled, the video is unavailable, or Data API quota is exhausted.
| Name | Type | Req | Description |
|---|---|---|---|
| max_results | integer | – | Max comments (default 20) |
| url | string | yes | YouTube video URL or ID |
No output schema declared.
No examples provided.
youtube_get_frame ~81
Extract one ephemeral JPEG near an integer-millisecond timestamp. Returns metadata plus MCP ImageContent; accuracy is best-effort at a decoded frame boundary.
| Name | Type | Req | Description |
|---|---|---|---|
| max_width | integer | – | Maximum JPEG width in pixels (default 640) |
| timestamp_ms | integer | yes | Frame timestamp in integer milliseconds |
| url | string | yes | YouTube video URL or ID |
No output schema declared.
No examples provided.
youtube_get_playlist ~95
List up to `limit` videos from a known YouTube playlist URL in upstream order. Use this for playlist contents, not channel uploads or keyword search. Read-only and keyless; returns playlist metadata plus ordered video records. Results are bounded and may fail when the playlist is private, unavailable, or blocked upstream.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max videos (default 20) |
| playlist_url | string | yes | Playlist URL |
No output schema declared.
No examples provided.
youtube_get_transcript ~89
Transcript/subtitles of a YouTube video. Uses the original/default language; manual > ASR within that language.
| Name | Type | Req | Description |
|---|---|---|---|
| lang | string | – | Language code (e.g. en, ru). Auto-detect if not specified. |
| url | string | yes | YouTube video URL or ID |
| with_timestamps | boolean | – | Include [MM:SS] timestamps (default: false) |
No output schema declared.
No examples provided.
youtube_get_trending ~90
List up to `limit` currently trending YouTube videos. Use this for broad discovery, not keyword search. Read-only; uses Data API v3 when `YOUTUBE_API_KEY` is set and otherwise a keyless yt-dlp fallback. Returns source metadata and video records; results can change over time and depend on upstream availability.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results (default 10) |
No output schema declared.
No examples provided.
youtube_get_video_info ~43
Detailed metadata for a YouTube video: title, duration, views, channel, description, tags.
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | YouTube video URL or ID |
No output schema declared.
No examples provided.
youtube_search ~158
Search YouTube videos. Uses Data API v3 when YOUTUBE_API_KEY is set, falls back to yt-dlp. Filters: date range, channel, duration, order.
| Name | Type | Req | Description |
|---|---|---|---|
| channel_id | string | – | Restrict to channel ID (API only) |
| limit | integer | – | Max results (default 10, max 50) |
| order | string | – | Sort: date, rating, relevance, viewCount, title (API only) |
| published_after | string | – | ISO 8601 date filter (API only) |
| published_before | string | – | ISO 8601 date filter (API only) |
| query | string | yes | Search query |
| video_duration | string | – | short, medium, long (API only) |
No output schema declared.
No examples provided.
youtube_search_channels ~90
Search YouTube channels by name/topic. Returns subscriber counts, video counts, country. Requires YOUTUBE_API_KEY.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results (default 10) |
| max_subscribers | integer | – | Maximum subscriber filter |
| min_subscribers | integer | – | Minimum subscriber filter |
| order | string | – | relevance, date |
| query | string | yes | Channel name or topic |
No output schema declared.
No examples provided.
How do I install the tube-bridge MCP server?
tube-bridge runs locally as a PyPI package, launched with uvx tube-bridge. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · tube-bridge
claude mcp add thewhitewater-tube-bridge -- uvx tube-bridge
What is the tube-bridge MCP server?
tube-bridge is an MCP server listed in the public MCP registry as io.github.TheWhiteWater/tube-bridge. YouTube MCP server for search, transcripts, frames, comments, channels, and local semantic corpora. This page covers its PyPI package (tube-bridge).
Is the tube-bridge MCP server safe to use?
tube-bridge scores 81 out of 100 on VerifyMCP. We recorded 4 known advisories against it as of 4 November 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the tube-bridge MCP server expose?
tube-bridge exposes 17 tools: youtube_search, youtube_search_channels, youtube_get_channel_info, youtube_get_video_info, youtube_get_trending, and 12 more. Their descriptions and schemas cost roughly 1,257 tokens of context every time the server is loaded.
Is the tube-bridge MCP server still maintained?
tube-bridge is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the tube-bridge MCP server under?
tube-bridge declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.