`yt_channel_details`

Pack: youtube · Endpoint: https://gateway.pipeworx.io/youtube/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/yt_channel_details for the schema, then POST the same URL with its arguments for the data.

Get YouTube channel information and statistics including subscriber count, video count, view count, description, and custom URL.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	YouTube Data API v3 key from Google Cloud Console
`channel_id`	string	no	Channel ID (starts with UC…)
`username`	string	no	Channel username (alternative to channel_id)

Example call

Arguments

{
  "_apiKey": "your-youtube-api-key",
  "channel_id": "UCkRfArvrzheW2E7b6SVV7vA"
}

curl

curl -X POST https://gateway.pipeworx.io/youtube/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"yt_channel_details","arguments":{"_apiKey":"your-youtube-api-key","channel_id":"UCkRfArvrzheW2E7b6SVV7vA"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('yt_channel_details', {
  "_apiKey": "your-youtube-api-key",
  "channel_id": "UCkRfArvrzheW2E7b6SVV7vA"
});

More examples

{
  "_apiKey": "your-youtube-api-key",
  "username": "LinusTechTips"
}

Response shape

Always returns: channels

Field	Type	Description
`channels`	array	Array of channel detail objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "channels": {
      "type": "array",
      "description": "Array of channel detail objects",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Channel ID"
          },
          "title": {
            "type": "string",
            "description": "Channel title"
          },
          "description": {
            "type": "string",
            "description": "Channel description"
          },
          "custom_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Custom channel URL if available"
          },
          "published_at": {
            "type": "string",
            "description": "ISO 8601 channel creation date"
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Country code if available"
          },
          "thumbnail": {
            "type": [
              "string",
              "null"
            ],
            "description": "Channel thumbnail URL"
          },
          "view_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total channel view count"
          },
          "subscriber_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "Subscriber count (null if hidden)"
          },
          "video_count": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total video count"
          },
          "uploads_playlist": {
            "type": "string",
            "description": "Playlist ID containing all uploads"
          }
        },
        "required": [
          "id",
          "title",
          "description",
          "custom_url",
          "published_at",
          "country",
          "thumbnail",
          "view_count",
          "subscriber_count",
          "video_count",
          "uploads_playlist"
        ]
      }
    }
  },
  "required": [
    "channels"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "youtube": {
      "url": "https://gateway.pipeworx.io/youtube/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

yt_channel_details