# YouTube Research MCP (npm · @coyasong/youtube-mcp-server)

Citation-ready YouTube transcript research and optional channel intelligence for AI agents.

- Trust score: 63/100 (medium)
- Change this week: +13
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@coyasong/youtube-mcp-server`: 63/100 (this document), [markdown](https://verifymcp.io/servers/coyasong-youtube-research/coyasong-youtube-mcp-server.md), [page](https://verifymcp.io/servers/coyasong-youtube-research/coyasong-youtube-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@coyasong/youtube-mcp-server`
- Version: `1.2.0`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 85/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (150 of 165), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (150 of 165), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 21 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1465 tokens (~104/item across 14 items; 14 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 80/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 29% of tool parameters carry a description.
  - Structured output schemas are declared (14% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add coyasong-youtube-research -- npx -y @coyasong/youtube-mcp-server
```

### Codex

```bash
codex mcp add coyasong-youtube-research -- npx -y @coyasong/youtube-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "coyasong-youtube-research": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@coyasong/youtube-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add coyasong-youtube-research --command npx --arg -y --arg @coyasong/youtube-mcp-server
```

### Hermes

```yaml
mcp_servers:
  coyasong-youtube-research:
    command: "npx"
    args: ["-y", "@coyasong/youtube-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "coyasong-youtube-research": {
      "command": "npx",
      "args": [
        "-y",
        "@coyasong/youtube-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 63, +43)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional] Licence: MIT

### 2026-08-01 (score 20, −12)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 32, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 50)

First indexed and scored.

## MCP tools (14)

### `search-videos` (~247 tokens)

[Requires YOUTUBE_API_KEY] Search for YouTube videos with advanced filtering options. Supports parameters: - query: Search term (required) - maxResults: Number of results to return (1-50) - channelId: Filter by specific channel - order: Sort by date, rating, viewCount, relevance, title - type: Filter by resource type (video, channel, playlist) - videoDuration: Filter by length (short: <4min, medium: 4-20min, long: >20min) - publishedAfter/publishedBefore: Filter by publish date (ISO format) - videoCaption: Filter by caption availability - videoDefinition: Filter by quality (standard/high) - regionCode: Filter by country (ISO country code)

Input parameters:

- `channelId` (string)
- `maxResults` (number)
- `order` (string)
- `publishedAfter` (string)
- `publishedBefore` (string)
- `query` (string, required)
- `regionCode` (string)
- `type` (string)
- `videoCaption` (string)
- `videoDefinition` (string)
- `videoDuration` (string)

### `get-video-comments` (~67 tokens)

[Requires YOUTUBE_API_KEY] Retrieve comments for a specific YouTube video with sorting options

Input parameters:

- `includeReplies` (boolean)
- `maxResults` (number)
- `order` (string)
- `pageToken` (string)
- `videoId` (string, required)

### `research-video` (~177 tokens)

Research a YouTube video

Extract a citation-ready YouTube transcript without requiring a YouTube API key. Accepts a video ID or URL and returns timestamped source links that agents can cite and open directly.

Input parameters:

- `contextLines` (integer): Nearby segments to include around query matches
- `endSeconds` (number): Only inspect captions at or before this time
- `language` (string): Caption language code, for example en, ko, or ja
- `matchMode` (string): Whole-word matching is the default
- `maxSegments` (integer): Maximum citations to return; defaults to 200
- `offset` (integer): Result offset for pagination
- `query` (string): Return only matching transcript segments
- `startSeconds` (number): Only inspect captions at or after this time
- `video` (string, required): YouTube video ID or URL

Output parameters:

- `citations` (array)
- `durationSeconds` (number)
- `language` (string)
- `matchMode`
- `nextOffset`
- `offset` (integer)
- `query`
- `returnedSegments` (integer)
- `source` (object)
- `sourceUrl` (string)
- `timeRange` (object)
- `totalAvailableSegments` (integer)
- `totalTranscriptSegments` (integer)
- `truncated` (boolean)
- `videoId` (string)

### `research-videos` (~105 tokens)

Compare evidence across YouTube videos

Run the same focused transcript query across 2 to 5 YouTube videos and return timestamp-linked evidence for comparison. No YouTube API key is required.

Input parameters:

- `contextLines` (integer)
- `language` (string): Optional caption language code
- `matchMode` (string)
- `maxSegmentsPerVideo` (integer)
- `query` (string, required): Phrase or word to find in every transcript
- `videos` (array, required): YouTube video IDs or URLs

Output parameters:

- `query` (string)
- `results` (array)
- `videosRequested` (integer)

### `get-video-transcript` (~136 tokens)

Get the transcript/captions for a YouTube video with optional language selection. This tool retrieves the full transcript of a video with timestamped captions. Each caption includes the text and its timestamp in the video. Parameters: videoId (required) - The YouTube video ID; language (optional) - Language code for the transcript (e.g., "en", "ko", "ja"). If not specified, the default language for the video will be used. Returns a text with each caption line preceded by its timestamp.

Input parameters:

- `language` (string)
- `videoId` (string, required): YouTube video ID or URL

### `get-video-stats` (~46 tokens)

[Requires YOUTUBE_API_KEY] Get statistical information for a specific YouTube video (views, likes, comments, upload date, etc.)

Input parameters:

- `videoId` (string, required)

### `get-channel-stats` (~46 tokens)

[Requires YOUTUBE_API_KEY] Get statistical information for a specific YouTube channel (subscriber count, total views, video count, etc.)

Input parameters:

- `channelId` (string, required)

### `compare-videos` (~32 tokens)

[Requires YOUTUBE_API_KEY] Compare statistics for multiple YouTube videos

Input parameters:

- `videoIds` (array, required)

### `get-trending-videos` (~58 tokens)

[Requires YOUTUBE_API_KEY] Retrieve trending videos by region and category. This helps analyze current popular content trends.

Input parameters:

- `categoryId` (string)
- `maxResults` (number)
- `regionCode` (string)

### `get-video-categories` (~34 tokens)

[Requires YOUTUBE_API_KEY] Retrieve available video categories for a specific region

Input parameters:

- `regionCode` (string)

### `analyze-channel-videos` (~53 tokens)

[Requires YOUTUBE_API_KEY] Analyze recent videos from a specific channel to identify performance trends

Input parameters:

- `channelId` (string, required)
- `maxResults` (number)
- `sortBy` (string)

### `enhanced-transcript` (~219 tokens)

Advanced transcript extraction tool with filtering, search, and multi-video capabilities. Provides rich transcript data for detailed analysis and processing. This tool offers multiple advanced features: 1) Extract transcripts from multiple videos in one request; 2) Filter by time ranges to focus on specific parts; 3) Search for specific content within transcripts; 4) Segment transcripts for structural analysis; 5) Format output in different ways (raw, timestamped, merged text); 6) Include video metadata. Parameters: videoIds (required) - Array of YouTube video IDs (up to 5); language (optional) - Language code; format (optional) - Output format ("raw", "timestamped", "merged"); includeMetadata (optional) - Whether to include video details; filters (optional) - Complex filtering options including timeRange, search, and segment.

Input parameters:

- `filters` (object)
- `format` (string)
- `includeMetadata` (boolean)
- `language` (string)
- `videoIds` (array, required)

### `get-key-moments` (~98 tokens)

Extract concise, timestamp-linked key moments from a video transcript without returning the full transcript. Useful for quickly navigating longer videos. Parameters: videoId (required) - A YouTube video ID or URL; maxMoments (optional) - Number of key moments to extract (default: 5, max: 10).

Input parameters:

- `maxMoments` (integer)
- `videoId` (string, required): YouTube video ID or URL

### `get-segmented-transcript` (~147 tokens)

Divide a video transcript into segments for easier analysis and navigation. This tool splits the video into equal time segments and extracts the transcript for each segment with proper timestamps. Ideal for analyzing the structure of longer videos or when you need to focus on specific parts of the content. Parameters: videoId (required) - The YouTube video ID; segmentCount (optional) - Number of segments to divide the video into (default: 4, max: 10). Returns a markdown-formatted text with each segment clearly labeled with time ranges and containing the relevant transcript text.

Input parameters:

- `segmentCount` (integer)
- `videoId` (string, required): YouTube video ID or URL

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/coyasong-youtube-research/coyasong-youtube-mcp-server#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 63
- 2026-08-01: 20
- 2026-07-31: 32
- 2026-07-30: 50
- 2026-07-28: 50
- 2026-07-27: 50

## Links

- npm package: https://www.npmjs.com/package/@coyasong/youtube-mcp-server
- Socket report: https://socket.dev/npm/package/@coyasong/youtube-mcp-server
- Repository: https://github.com/coyaSONG/youtube-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/coyasong-youtube-research/coyasong-youtube-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/coyasong-youtube-research/coyasong-youtube-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/coyasong-youtube-research/coyasong-youtube-mcp-server