PlugsightDocs

YouTube tools

The YouTube tools in the developer API, with every argument: list channels and videos, and run YouTube Analytics reports.

Needs: A YouTube connection (Pro and Agency). 3 tools, all read-only.

Google is still reviewing the permission this connector needs. Until it approves it, Plugsight offers YouTube to Plugsight admins only, so for most people it isn't in the Connector catalog yet and these tools don't appear. See YouTube.

These tools appear in GET /v1/tools only when the API key's MCP server includes a connection of this kind. Call each one with POST /v1/tools/\<name>, sending its arguments as a JSON object. See Calling tools for the request and response format.

These tools need a plan that includes marketing connectors (Pro or Agency). On the Free plan they don't appear, even if the connection exists.

These tools don't take an account argument. Call youtube_list_channels for the channels this key reaches and pass a channel id (UC…) as channel; leave it out when there's only one. Channels you've hidden in Plugsight aren't listed and can't be read.

Tool What it does Kind
youtube_list_channels List YouTube channels Read
youtube_report YouTube channel report Read
youtube_list_videos List YouTube videos Read

Every tool here only reads: none of them changes anything in YouTube, so none needs confirm.

The example requests fill in only the required arguments, with placeholder values.

youtube_list_channels

List YouTube channels · Read

The YouTube channels this MCP reaches, with subscribers, total views and video count.

No arguments: send {}.

Example request:

curl -X POST https://app.plugsight.app/v1/tools/youtube_list_channels \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

youtube_report

YouTube channel report · Read

YouTube Analytics for a channel over a period: views, watch time, average view duration, subscribers gained and lost, likes, comments, shares. group_by splits it: day or month (trends), video (top videos, with titles), country, device, traffic_source (search, suggested, external…), playback_location, subscribed_status, or age_gender (share of viewers). Returns a compact table with totals.

Argument Type Required What it is
channel string No Channel id (UC…) from youtube_list_channels (optional when there's only one)
group_by string No How to split the report. One of: none, day, month, video, country, device, traffic_source, playback_location, subscribed_status, age_gender. Default "none".
metrics array of string No YouTube Analytics metrics. Default: views, estimatedMinutesWatched, averageViewDuration, subscribersGained, subscribersLost, likes, comments, shares. Traffic, device and location splits allow views and estimatedMinutesWatched
sort_by string No Metric to rank by, for video, country and source splits. Default: the first metric
limit integer No Most rows to return. From 1 to 200. Default 25.
date_preset string No Used when date_from/date_to aren't given. Default last_28d. One of: last_7d, last_28d, last_30d, last_90d, last_365d, this_month, last_month, this_year, last_year.
date_from string No YYYY-MM-DD, or "today", "yesterday", "NdaysAgo" (e.g. "28daysAgo")
date_to string No YYYY-MM-DD, or "today", "yesterday", "NdaysAgo" (e.g. "28daysAgo")

Example request:

curl -X POST https://app.plugsight.app/v1/tools/youtube_report \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

youtube_list_videos

List YouTube videos · Read

A channel's uploads, newest first, with publish date, length, views, likes, comments and link. Use youtube_report with group_by video for watch time over a period.

Argument Type Required What it is
channel string No Channel id (UC…) from youtube_list_channels (optional when there's only one)
search string No Only videos whose title contains this
limit integer No Most videos to return. From 1 to 200. Default 25.

Example request:

curl -X POST https://app.plugsight.app/v1/tools/youtube_list_videos \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'