Tools

find_youtube_channel

Look up a YouTube channel from a link, an @handle, a channel id or a link to one of its videos. Returns its id and name, to confirm with the user before create_automation.

Access token · read · Read only

Parameters

channel string required

A channel link, @handle, channel id or video link.

View schema

{
  "examples": [
    "@yourchannel"
  ],
  "description": "A channel link, @handle, channel id or video link.",
  "type": "string",
  "minLength": 1,
  "maxLength": 300
}

Request example

{
  "name": "find_youtube_channel",
  "arguments": {
    "channel": "@yourchannel"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.