YouTube
Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.
Saved Videovideo
A YouTube video saved in Vritto.
youtube_queryYoutubeDashboardFindthrough vritto_findReturn the YouTube workspace snapshot. Use this for watch-queue, new-uploads, and playlist-ID questions. Defaults to a compact summary: per-collection counts plus capped Up Next, feed, and playlist rows.
| Field | Type | Description |
|---|---|---|
| detail | one of summary, full | Response shape: "summary" (default, counts + capped Up Next/feed/playlist rows) or "full" (all nine collections with complete records incl. long descriptions and note bodies). |
youtube_queryYoutubeRecordsFindthrough vritto_findSearch the user's saved YouTube video library by text, newest-updated first. Use this to resolve video IDs before record writes.
| Field | Type | Description |
|---|---|---|
| query | string | Case-insensitive text matched against title, channel, description, and tags. |
| detail | one of summary, full | Row shape: "summary" (default, id/videoId/title/channel/date/status/rating) or "full" (every field incl. the long description). |
| limit | integer | Maximum records (default 50 in summary mode). |
| cursor | string | Pagination cursor from a previous nextCursor. |
youtube_queryYoutubeStatsFindthrough vritto_findReturn total saved YouTube videos and watch-note counts. Year and rating breakdowns are not tracked for YouTube and come back empty.
No input.
youtube_importYoutubeUrlCreatethrough vritto_createImport a YouTube URL into the saved video library, fetching title, channel, and duration metadata. Use this whenever the user provides a YouTube link. Passing a recommender also records a pending recommendation.
| Field | Type | Description |
|---|---|---|
| url* | string | YouTube video URL (watch, youtu.be, shorts, embed, or live link). |
| reason | string | Why the video was saved or recommended. |
| recommendedByPersonId | string | Vritto People record ID of the recommender. |
| recommendedByName | string | Free-text recommender name when no People record exists. |
| projectId | string | Vritto project ID this video supports. |
Example input
{
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"reason": "Priya's pick for the playlist"
}youtube_upsertYoutubeRecordCreatethrough vritto_createCreate or refresh a saved YouTube video record by video ID; metadata is refetched from the YouTube Data API when available, with the provided fields as offline fallback. Prefer youtube_importYoutubeUrl when the user gives a URL. Status, rating, and notes are not stored by this action.
| Field | Type | Description |
|---|---|---|
| record* | object | Video record body. |
| record.providerRef* | object | Provider reference; only providerId is used. |
| record.title | string | Fallback title when YouTube metadata is unavailable. |
| record.channelTitle | string | Fallback channel name. |
| record.description | string | Fallback description. |
| record.thumbnailUrl | string | Fallback thumbnail URL. |
youtube_linkYoutubeVideoToProjectUpdatethrough vritto_updateLink an already-saved YouTube video to a Vritto project as research/reference material. For a new URL, prefer youtube_importYoutubeUrl with projectId.
| Field | Type | Description |
|---|---|---|
| youtubeVideoId* | string | YouTube video ID. |
| projectId* | string | Vritto project ID. |
| reason | string | Why this video supports the project. |
| status | string | Link status label; defaults to "reference". |
youtube_deleteYoutubeRecordDeletethrough vritto_deleteRemove one saved YouTube video along with its feed and inbox entries. Only for explicit removals.
| Field | Type | Description |
|---|---|---|
| mediaRecordId* | string | Saved video ID to delete (the YouTube video ID). |
Video Notevideo_note
A note, question, or idea captured against a video.
youtube_createYoutubeWatchNoteCreatethrough vritto_createCapture a watch note against a YouTube video: a plain note, a question, or a task/project idea, optionally pinned to a timestamp and linked to a Vritto project.
| Field | Type | Description |
|---|---|---|
| youtubeVideoId* | string | YouTube video ID the note belongs to. |
| body* | string | Note text. |
| kind | one of note, question, task_idea, project_idea | Note kind; defaults to "note". |
| timestampSeconds | integer | Video timestamp the note refers to, in seconds. |
| projectId | string | Vritto project ID this note supports. |
| feedItemId | string | Feed item ID the note was taken from, when known. |
youtube_updateYoutubeWatchNoteUpdatethrough vritto_updateUpdate an existing watch note's body, kind, or timestamp. Omitted patch fields keep their current values.
| Field | Type | Description |
|---|---|---|
| noteId* | string | Watch note ID. |
| patch* | object | Fields to change; omitted fields keep current values. |
| patch.body | string | New note text. |
| patch.kind | one of note, question, task_idea, project_idea | New note kind. |
| patch.timestampSeconds | integer | New video timestamp in seconds, or null to clear. |
youtube_deleteYoutubeWatchNoteDeletethrough vritto_deleteDelete one watch note. Only for explicit removals.
| Field | Type | Description |
|---|---|---|
| noteId* | string | Watch note ID to delete. |
Playlist Itemplaylist_item
A video's place in a Vritto playlist, such as Up Next.
youtube_queryYoutubePlaylistItemsFindthrough vritto_findList the videos in one playlist in position order (including the Up Next and Watched system playlists). Resolve the playlistId with youtube_queryYoutubeDashboard first.
| Field | Type | Description |
|---|---|---|
| playlistId* | string | Playlist ID. |
youtube_addVideoToPlaylistCreatethrough vritto_createAdd a saved video to a playlist (e.g. the Up Next queue), snapshotting its metadata; adding a duplicate is a no-op. Resolve the playlistId with youtube_queryYoutubeDashboard first.
| Field | Type | Description |
|---|---|---|
| playlistId* | string | Destination playlist ID. |
| youtubeVideoId* | string | YouTube video ID of a saved video, e.g. "dQw4w9WgXcQ". |
youtube_removeYoutubePlaylistItemDeletethrough vritto_deleteRemove one entry from a playlist by its playlist-item ID (from youtube_queryYoutubePlaylistItems, not the video ID). Only for explicit removals.
| Field | Type | Description |
|---|---|---|
| itemId* | string | Playlist item ID to remove. |
Kept in the Vritto app
youtube_queryYoutubeWatchLogs: Superseded by a newer operation that is on MCP.youtube_queryYoutubePersonLinks: Superseded by a newer operation that is on MCP.youtube_addYoutubeWatchLog: Superseded by a newer operation that is on MCP.youtube_updateYoutubeWatchLog: Superseded by a newer operation that is on MCP.youtube_deleteYoutubeWatchLog: Superseded by a newer operation that is on MCP.youtube_upsertYoutubeRecommendation: Superseded by a newer operation that is on MCP.youtube_upsertYoutubePersonTaste: Superseded by a newer operation that is on MCP.