CreatorOS
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
CreatorOS connects you to the user's own YouTube channel (read-only in this version). Start with youtube_list_channels; if nothing is connected, call youtube_connect_channel. For 'how is my channel doing / what should I do', call youtube_analyze_channel_performance first. Every result is labelled measured / derived / estimated / ai_recommendation - keep those labels when you answer, quote the evidence, and never present a correlation as a proven cause. If a tool returns an error, its [category] tells you whether it is authentication, permission, quota, unsupported_metric, unavailable_data, configuration or system - relay the 'How to fix'.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| youtube_connect_channelA | Connect a YouTube channel via Google sign-in (OAuth 2.0, read-only permissions). Opens Google's consent screen in a browser on the computer running this server. The user signs in and picks the channel (or Brand Account). Tokens are encrypted locally and never returned here. Call again to connect additional channels. |
| youtube_list_channelsA | List YouTube channels connected to CreatorOS and which one is the default. |
| youtube_set_default_channelB | Choose which connected channel tools use when channel_id is omitted. |
| youtube_disconnect_channelA | Revoke CreatorOS's Google access for a channel and delete its local token. Requires explicit confirmation. |
| youtube_get_channel_overviewC | Channel profile, public stats, library composition (Shorts vs long-form) and upload cadence. |
| youtube_list_videosA | List the channel's uploaded videos with lifetime public stats (views, likes, comments). |
| youtube_search_videosA | Search the connected channel's own video library (keyword match; uses no YouTube quota). |
| youtube_get_video_detailsA | Full metadata for one video (title, description, tags, duration, format, stats) plus stored stat history. |
| youtube_get_commentsB | Top-level comments on a video, with quick derived signals (questions, most-liked) for audience analysis. |
| youtube_get_channel_analyticsB | Private channel analytics: totals vs previous period, daily trend, traffic sources, countries, subscriber split. |
| youtube_get_video_analyticsB | Private analytics for one video: totals, impressions/CTR (if available), traffic sources, audience-retention curve with the biggest drop-off, and YouTube search terms that found it. |
| youtube_compare_videosB | Compare videos on equal footing: each video is measured over its own first N days after publishing. |
| youtube_analyze_channel_performanceA | End-to-end health check: syncs videos, pulls analytics for this and the previous period, diagnoses each video's bottleneck (click / discovery / retention / conversion) against the channel's own same-format baseline, finds rising and declining videos, and returns ONE prioritized, evidence-backed recommendation. |
| youtube_recommend_publishing_timeA | Recommend the best weekday and time block to publish, estimated from how your past uploads performed relative to neighbouring uploads. Includes confidence, sample sizes and how to validate it. |
| youtube_get_recommendation_historyB | Recommendations CreatorOS made earlier (with their baselines) so you can check them against what happened next. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| channel_health_assessment | |
| weekly_creator_review | |
| video_performance_analysis |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| connected_channels |
TDQS
Scored across 15 tools
Tools split cleanly into four groups: connection management, library browsing, analytics, and recommendations. Most boundaries are clear, but the analytics cluster has mild overlap risk — get_channel_analytics vs analyze_channel_performance (the latter is a composite that calls the former) and get_video_analytics vs compare_videos require reading descriptions to pick correctly. list_videos vs search_videos could also be confused at a glance, though the quota note helps.
Every tool follows the same youtube_<verb>_<noun> snake_case pattern, with predictable verb families (connect, list, set, get, search, analyze, recommend, compare). No camelCase or style drift anywhere in the set.
15 tools is at the top of the ideal band and each one maps to a distinct user-facing job — connection lifecycle, video browsing, channel/video analytics, and recommendations. Nothing feels padded, and the composite analyze_channel_performance earns its place by tying the others together.
The surface covers the full connection lifecycle plus the read-only insight workflows the server explicitly scopes itself to (OAuth read-only), so core jobs have no dead ends. Minor gaps remain: no playlist or subscription inspection, no video metadata update, and no way to drill into comment replies, all of which an agent might reasonably expect from a creator-analytics server.