{
  "info": {
    "name": "YouTube — mcp.ai",
    "description": "REST API for the YouTube MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/youtube",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "youtube_api",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/api",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api"
          ]
        },
        "description": "Escape hatch: call any path on the YouTube backend. Pass path (e.g. /search), optional method (default GET), query map, and JSON body for POST. Prefer the named youtube_* tools when available; this is",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"path\": \"\",\n  \"method\": \"\",\n  \"query\": {},\n  \"body\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_about",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/about",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "about"
          ]
        },
        "description": "Channel description, links, country, subscriber count, banner.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_community",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/community",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "community"
          ]
        },
        "description": "Community posts tab for a channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_featured",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/featured",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "featured"
          ]
        },
        "description": "Featured channels listed on a channel. Note: YouTube deprecated the featured-channels tab; this route exists upstream but typically returns an empty/error envelope.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_home",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/home",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "home"
          ]
        },
        "description": "Channel home page payload (featured shelves + meta).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_playlists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/playlists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "playlists"
          ]
        },
        "description": "Channel playlists tab.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"sort_by\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "search"
          ]
        },
        "description": "Search a channel's own videos and playlists.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"query\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_shorts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/shorts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "shorts"
          ]
        },
        "description": "Channel shorts tab.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_shorts_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/shorts/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "shorts",
            "post"
          ]
        },
        "description": "POST variant of channel shorts. Requires a `params` continuation token from a prior GET response. Skip in daily smoke (no synthetic params).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"params\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_store",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/store",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "store"
          ]
        },
        "description": "Store / merch shelf for a channel.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_videos",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/videos",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "videos"
          ]
        },
        "description": "Channel videos tab.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"sort_by\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_channel_videos_post",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channel/videos/post",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channel",
            "videos",
            "post"
          ]
        },
        "description": "POST variant of channel videos. Requires a `params` continuation token captured from a prior GET response — used to fetch deeper pages or filtered shelves that the GET surface can't address. Skip in d",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"forUsername\": \"\",\n  \"params\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_comments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/comments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "comments"
          ]
        },
        "description": "Top-level comments thread for a video.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"sort_by\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_download",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/download",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "download"
          ]
        },
        "description": "Stream/download metadata for a video (formats, audio/video URLs, status).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"cgeo\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_hashtag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/hashtag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "hashtag"
          ]
        },
        "description": "Posts under a hashtag (without leading #).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tag\": \"\",\n  \"type\": \"\",\n  \"token\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_home_feed",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/home/feed",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "home",
            "feed"
          ]
        },
        "description": "YouTube home feed (anonymous, geo/lang aware).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"geo\": \"\",\n  \"lang\": \"\",\n  \"token\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_hype",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/hype",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "hype"
          ]
        },
        "description": "YouTube Hype: viral / hyped videos feed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"geo\": \"\",\n  \"lang\": \"\",\n  \"token\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_playlist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/playlist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "playlist"
          ]
        },
        "description": "Playlist items by playlist id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_resolve_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/resolve/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "resolve",
            "url"
          ]
        },
        "description": "Resolve a YouTube URL or share link to its videoId / pageType.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search"
          ]
        },
        "description": "Search videos, channels, playlists.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": \"\",\n  \"type\": \"\",\n  \"sort_by\": \"\",\n  \"duration\": \"\",\n  \"upload_date\": \"\",\n  \"geo\": \"\",\n  \"lang\": \"\",\n  \"token\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_trending",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/trending",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "trending"
          ]
        },
        "description": "Trending videos by region.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"geo\": \"\",\n  \"type\": \"\",\n  \"lang\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "youtube_video_related",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/video/related",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "video",
            "related"
          ]
        },
        "description": "Related videos for a given video id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"token\": \"\",\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}