MCP Tools

The Rad TV MCP server exposes 44 tools organized by category. Call them via tools/call JSON-RPC.

Raw GraphQL uses Relay connections (first, after, edges, node). MCP list tools may still use limit / start-style arguments; see Pagination for the underlying API shape.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_me",
    "arguments": {}
  }
}

Identity & User

Tool	Arguments	Description
`get_me`	—	Get the current authenticated user's profile, channel, subscription
`list_followed_channels`	—	List channels the current user follows

Channels

Tool	Arguments	Description
`get_channel`	`id` (DID)	Get a single channel by DID
`list_channels`	`limit`, `start`	Paginated list of all channels

Taxonomy

Tool	Arguments	Description
`list_categories`	`limit`, `start`	List content categories (auth required)
`list_ratings`	`limit`, `start`	List content ratings
`list_genres`	`limit`, `start`	List content genres

Content Creation

Tool	Arguments	Description
`create_content`	`title`, `summary`, `type`	Create a new content item
`update_content`	`id`, `title`, `name`, `summary`, `shortSummary`, `containsAds`, `type`	Update an existing content item; only the fields you pass are changed
`create_content_asset`	`contentId`, `filename`, `size`, `hint`	Create a TUS upload session for a content asset
`submit_content_for_processing`	`contentId`, `assetName`, `layout`, `enhance`, `force`	Submit content for transcoding

On update_content, containsAds is one of YES, NO, MAYBE, and type is accepted only alongside containsAds — the stored content type is left unchanged either way. Pass force to submit_content_for_processing to start a new transcode job even when a live one already exists for the same source (a re-transcode).

AI Tools

These tools require an active Creator+ subscription in addition to a Bearer token.

Tool	Arguments	Description
`predict_virality`	`title`, `imageUrl`, `description`, `category`	Score a title (plus optional thumbnail, description, category) for viral potential before publishing — returns a virality score, predicted click-through rate, confidence, and recommendations

Publishing

Tool	Arguments	Description
`publish_content`	`id`, `releaseDate`	Make content publicly visible
`unpublish_content`	`id`	Revert content to protected

Playlists

Tool	Arguments	Description
`create_playlist`	`title`, `summary`, `channel`	Create an empty playlist
`update_playlist`	`id`, `title`, `summary`	Update playlist metadata
`create_playlist_asset`	`id`, `filename`, `size`	Create upload session for playlist cover

Engagement

Tool	Arguments	Description
`follow_channel`	`channel` (DID)	Follow a channel
`unfollow_channel`	`channel` (DID)	Unfollow a channel
`like_content`	`id` (DID)	Like content (idempotent)
`unlike_content`	`id` (DID)	Unlike content (idempotent)
`create_comment`	`contentId`, `body`	Create a comment on content
`list_comments`	`contentId`, `limit`, `start`	List comments on content

YouTube

Tool	Arguments	Description
`list_youtube_videos`	`pageToken`, `limit`	List videos on connected YouTube channel
`get_youtube_publish_job`	`id`	Get status of a YouTube publish job
`create_content_from_youtube`	`videoId`, `channel`	Import YouTube video as Rad content
`publish_content_to_youtube`	`id`, `privacyStatus`	Publish Rad content to YouTube

Creator Analytics

Read-only analytics for the authenticated creator's own channel. Each tool forwards your Bearer token to the analytics service, which scopes every response to your channel via the token's identity — there is no cross-channel access.

Analytics data is production-only. On api-staging.rad.live these tools return correctly-shaped but zeroed responses.

Tool	Arguments	Description
`get_creator_analytics_overview`	`range`, `from`, `to`	Headline KPIs (views, watch minutes, unique viewers, subscribers) with deltas vs the prior period
`get_creator_analytics_audience`	`range`, `from`, `to`	Audience breakdown by country and device
`get_creator_analytics_timeseries`	`metric`, `granularity`, `range`, `from`, `to`	Timeseries for a chosen metric at day/week/month granularity
`get_creator_analytics_subscribers`	`range`, `from`, `to`	Subscriber growth, recency buckets, and per-country split
`list_creator_analytics_videos`	`range`, `from`, `to`, `sort`, `first`, `after`	Paginated per-video analytics, sorted by the chosen metric
`get_creator_analytics_video`	`contentLrn`, `range`, `from`, `to`	Per-video deep-dive (daily views/watch, country/device, engagement)
`list_creator_analytics_comments`	`first`, `after`	Inbox feed of comments on your content (newest first)
`creator_analytics_dashboard`	`range`, `from`, `to`, `topVideos`	One-call dashboard: overview + audience + top videos

range accepts LAST_7D, LAST_28D, LAST_30D (default), LAST_90D, MTD, YTD, or CUSTOM (pair with from/to). metric is one of VIEWS, WATCH_MINUTES, UNIQUE_VIEWERS, CHANNEL_SUBSCRIBERS, NEW_CHANNEL_SUBSCRIBERS.

Compound Workflows

These tools combine multiple operations for agent convenience. See Agent Workflows for detailed guides.

Tool	Arguments	Description
`publish_video`	`title`, `summary`, `channel`, `sourceUrl`/`filename`+`size`, `contentType`, `layout`, `enhance`, `publish`, `releaseDate`, `thumbnailUrl`	End-to-end video publishing
`finalize_content_upload`	`contentId`, `layout`, `enhance`, `publish`, `releaseDate`	Complete upload after Mode 2 `publish_video`
`import_youtube_and_publish`	`videoId`, `channel`, `publish`	Import from YouTube and publish in one call
`create_playlist_with_items`	`title`, `summary`, `channel`, `contentIds`	Create playlist with content
`verify_connection`	—	Agent hello: verify auth, channel, subscription, permissions
`channel_dashboard`	`channel`	Get channel info, recent content, playlists, transcode status
`import_youtube_library`	`maxResults`, `publishedAfter`, `autoPublish`, `channel`	Batch import from YouTube
`wait_for_processing`	`contentId`, `timeoutSeconds`	Block until transcode completes or times out
`get_processing_status`	`contentId`	Non-blocking transcode status check

The full machine-readable tool listing is always available at GET https://api.rad.live/llms.txt.

MCP Tools

On this page