{"name":"findaclip","transport":"streamable-http","endpoint":"/mcp","tools":[{"name":"get_account_status","title":"Get account status","description":"Check the linked FindaClip account, subscription state, and useful account links.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"account":{"type":"object","properties":{"email":{"type":["string","null"]},"name":{"type":["string","null"]}},"additionalProperties":false},"subscription":{"type":"object","properties":{"tier":{"type":["string","null"]},"status":{"type":["string","null"]},"active":{"type":"boolean"}},"additionalProperties":false},"subscriptionRequired":{"type":"boolean"},"credits":{"type":"object","properties":{"creditsAvailable":{"type":["number","null"]}},"additionalProperties":false},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"readOnlyHint":true,"requiredScopes":["account.read"]},{"name":"get_credit_balance","title":"Get credit balance","description":"Show remaining FindaClip credits.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"credits":{"type":"object","properties":{"creditsAvailable":{"type":["number","null"]}},"additionalProperties":false},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"readOnlyHint":true,"requiredScopes":["credits.read"]},{"name":"get_topup_options","title":"Get credit top-up options","description":"Show FindaClip credit top-up packages and recommend the smallest package that covers an optional credit shortfall.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"creditsShortfall":{"type":"number","minimum":0}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"options":{"type":"array","items":{"type":"object","properties":{"topupType":{"type":"string"},"label":{"type":"string"},"credits":{"type":"number"},"priceCents":{"type":"number"},"priceUsd":{"type":"number"}},"additionalProperties":false}},"recommendedTopupType":{"type":["string","null"]},"creditsShortfall":{"type":["number","null"]}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["credits.read"]},{"name":"create_topup_checkout","title":"Create credit top-up checkout","description":"Create a Stripe Checkout link for a selected FindaClip credit top-up package. This does not charge automatically; the user must open Checkout and pay.","openWorldHint":true,"inputSchema":{"type":"object","properties":{"topupType":{"type":"string","enum":["small","medium","large"]},"returnTo":{"type":"string","enum":["settings","auto_find"]}},"required":["topupType"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"checkout":{"type":"object","properties":{"topupType":{"type":"string"},"credits":{"type":"number"},"priceCents":{"type":"number"},"checkoutUrl":{"type":"string"}},"additionalProperties":false}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["credits.write"]},{"name":"get_auto_find_settings","title":"Get Auto Find settings","description":"Show Auto Find status, selected prompts, eligibility, and tracked channels.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"eligibility":{"type":"object","properties":{"canUse":{"type":"boolean"},"tier":{"type":["string","null"]},"status":{"type":["string","null"]},"channelLimit":{"type":"number"},"watchedCount":{"type":"number"},"reason":{"type":["string","null"]}},"additionalProperties":true},"settings":{"type":"object","properties":{"enabled":{"type":"boolean"},"promptTemplateId":{"type":"string"},"promptTemplateIds":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"additionalProperties":false}},"timezone":{"type":["string","null"]},"customPrompt":{"anyOf":[{"type":"object","properties":{"name":{"type":["string","null"]},"goal":{"type":["string","null"]},"minClipDurationSeconds":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"channels":{"type":"array","items":{"type":"object","properties":{"channelId":{"type":"number"},"youtubeChannelId":{"type":["string","null"]},"title":{"type":["string","null"]},"handle":{"type":["string","null"]},"url":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"subscriptionStatus":{"type":["string","null"]},"monitoringPaused":{"type":"boolean"},"monitoringPausedReason":{"type":["string","null"]}},"additionalProperties":false}},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"readOnlyHint":true,"requiredScopes":["auto_find.read"]},{"name":"update_auto_find_settings","title":"Update Auto Find settings","description":"Turn Auto Find on or off, select prompt templates, and optionally save a custom prompt.","inputSchema":{"type":"object","properties":{"enabled":{"type":"boolean"},"promptTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"promptTemplateIds":{"type":"array","minItems":1,"maxItems":2,"items":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]}},"customPrompt":{"type":["object","null"],"properties":{"name":{"type":["string","null"]},"goal":{"type":"string"},"prioritize":{"type":["string","null"]},"avoid":{"type":["string","null"]},"examples":{"type":["string","null"]},"minClipDurationSeconds":{"type":"number","minimum":5,"maximum":30}},"additionalProperties":false},"timezone":{"type":["string","null"]}},"required":["enabled"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"settings":{"type":"object","properties":{"enabled":{"type":"boolean"},"promptTemplateId":{"type":"string"},"promptTemplateIds":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"additionalProperties":false}},"timezone":{"type":["string","null"]},"customPrompt":{"anyOf":[{"type":"object","properties":{"name":{"type":["string","null"]},"goal":{"type":["string","null"]},"minClipDurationSeconds":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["auto_find.write"]},{"name":"get_auto_find_prompt_builder_schema","title":"Get Auto Find prompt builder schema","description":"Get the editable Auto Find prompt fields, defaults, examples, allowed clip-length values, and interview guidance. Use this when the user wants help creating, editing, or personalizing their Auto Find prompt. The chat app should ask questions, help with fields the user does not know how to answer, infer sensible draft fields from the user's goals, then preview before saving.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"defaultBaseTemplateId":{"type":"string"},"editableFields":{"type":"array","items":{"type":"object","additionalProperties":true}},"clipLengthOptions":{"type":"array","items":{"type":"object","additionalProperties":true}},"defaults":{"type":"object","properties":{"id":{"type":["number","null"]},"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string"},"goal":{"type":"string"},"prioritize":{"type":"string"},"avoid":{"type":"string"},"titleStyle":{"type":"string"},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string"},"updatedAt":{"type":["string","null"]}},"additionalProperties":false},"baseTemplates":{"type":"array","items":{"type":"object","additionalProperties":true}},"interviewGuidance":{"type":"array","items":{"type":"string"}},"confirmationRequired":{"type":"boolean"}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"readOnlyHint":true,"requiredScopes":["auto_find.read"]},{"name":"preview_auto_find_prompt_config","title":"Preview Auto Find prompt config","description":"Normalize and validate a proposed Auto Find prompt config without saving it. Use this after interviewing the user, including when the assistant drafted fields the user was unsure how to answer. Show the preview and coaching to the user before asking for confirmation.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string","maxLength":120},"goal":{"type":"string","maxLength":4000},"prioritize":{"type":"string","maxLength":4000},"avoid":{"type":"string","maxLength":4000},"titleStyle":{"type":"string","maxLength":4000},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string","maxLength":4000},"promptConfig":{"type":"object","properties":{"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string","maxLength":120},"goal":{"type":"string","maxLength":4000},"prioritize":{"type":"string","maxLength":4000},"avoid":{"type":"string","maxLength":4000},"titleStyle":{"type":"string","maxLength":4000},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string","maxLength":4000}},"additionalProperties":false}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"promptConfig":{"type":"object","properties":{"id":{"type":["number","null"]},"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string"},"goal":{"type":"string"},"prioritize":{"type":"string"},"avoid":{"type":"string"},"titleStyle":{"type":"string"},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string"},"updatedAt":{"type":["string","null"]}},"additionalProperties":false},"coaching":{"type":"array","items":{"type":"string"}},"rawPromptPreview":{"type":"string"},"previewSections":{"type":"array","items":{"type":"object","additionalProperties":true}},"confirmationRequired":{"type":"boolean"}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["auto_find.write"]},{"name":"save_auto_find_prompt_config","title":"Save Auto Find prompt config","description":"Save and activate a confirmed Auto Find prompt config. Only call after the user has reviewed the preview and explicitly confirmed saving. This tool requires confirmed: true and does not allow raw system prompt replacement.","inputSchema":{"type":"object","properties":{"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string","maxLength":120},"goal":{"type":"string","maxLength":4000},"prioritize":{"type":"string","maxLength":4000},"avoid":{"type":"string","maxLength":4000},"titleStyle":{"type":"string","maxLength":4000},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string","maxLength":4000},"promptConfig":{"type":"object","properties":{"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string","maxLength":120},"goal":{"type":"string","maxLength":4000},"prioritize":{"type":"string","maxLength":4000},"avoid":{"type":"string","maxLength":4000},"titleStyle":{"type":"string","maxLength":4000},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string","maxLength":4000}},"additionalProperties":false},"confirmed":{"type":"boolean","const":true}},"required":["confirmed"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"promptConfig":{"type":"object","properties":{"id":{"type":["number","null"]},"baseTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"name":{"type":"string"},"goal":{"type":"string"},"prioritize":{"type":"string"},"avoid":{"type":"string"},"titleStyle":{"type":"string"},"clipLengthPreference":{"type":"string","enum":["mostly_short","balanced","allow_longer_context"]},"examples":{"type":"string"},"updatedAt":{"type":["string","null"]}},"additionalProperties":false},"coaching":{"type":"array","items":{"type":"string"}},"settings":{"type":"object","properties":{"enabled":{"type":"boolean"},"promptTemplateId":{"type":"string"},"promptTemplateIds":{"type":"array","items":{"type":"string"}},"prompts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"}},"additionalProperties":false}},"timezone":{"type":["string","null"]},"customPrompt":{"anyOf":[{"type":"object","properties":{"name":{"type":["string","null"]},"goal":{"type":["string","null"]},"minClipDurationSeconds":{"type":["number","null"]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"promptConfigIds":{"type":"array","items":{"type":"number"}},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["auto_find.write"]},{"name":"add_auto_find_channel","title":"Add Auto Find channel","description":"Add a YouTube channel URL, @handle, or channel ID to Auto Find.","inputSchema":{"type":"object","properties":{"input":{"type":"string"}},"required":["input"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"channel":{"type":"object","additionalProperties":true},"note":{"type":"string"}},"required":["summary","displayText","nextActions"],"additionalProperties":true},"requiredScopes":["auto_find.write"]},{"name":"remove_auto_find_channel","title":"Remove Auto Find channel","description":"Remove a tracked Auto Find channel by channel ID.","destructiveHint":true,"inputSchema":{"type":"object","properties":{"channelId":{"type":"number"}},"required":["channelId"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"removedChannel":{"type":"object","additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":true},"requiredScopes":["auto_find.write"]},{"name":"list_auto_find_results","title":"List Auto Find results","description":"List recent Auto Find runs and their available clip results. Use this to find existing runs before asking the user for IDs. Completed results include structuredContent.clipAssetManifest for agent-ready clip packages.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"status":{"type":"string"},"channel":{"type":"string"},"promptTemplateId":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]},"minRank":{"type":"number","minimum":0,"maximum":10},"recentDays":{"type":"number","minimum":1,"maximum":90},"limit":{"type":"number","minimum":1,"maximum":100}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"get_latest_clips","title":"Get latest clips","description":"Pull the latest available FindaClip clips, optionally since an ISO date/time. This is the preferred read-only tool for scheduled agents asking what is new.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"since":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":50},"channel_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"number"}},"channelIds":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"number"}},"min_rank":{"type":"number","minimum":0,"maximum":10},"minRank":{"type":"number","minimum":0,"maximum":10},"include_seen":{"type":"boolean"},"includeSeen":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"topClips":{"type":"array","items":{"type":"object","properties":{"clipId":{"type":"number"},"momentId":{"type":"number"},"autoFindItemId":{"type":"number"},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]},"seen":{"type":"boolean"},"seenAt":{"type":["string","null"]},"seenScope":{"type":"string"},"nextTools":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"clips":{"type":"array","items":{"type":"object","properties":{"clipId":{"type":"number"},"momentId":{"type":"number"},"autoFindItemId":{"type":"number"},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]},"seen":{"type":"boolean"},"seenAt":{"type":["string","null"]},"seenScope":{"type":"string"},"nextTools":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"results":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"filters":{"type":"object","additionalProperties":true},"suggestedNextActions":{"type":"array","items":{"type":"string"}}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"get_daily_clip_digest","title":"Get daily clip digest","description":"Pull a ranked daily digest of clips that became available on a local calendar date. Recurrence belongs in the agent host; this tool only returns the digest for the requested date.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"timezone":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":50},"channel_ids":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"number"}},"channelIds":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"number"}},"min_rank":{"type":"number","minimum":0,"maximum":10},"minRank":{"type":"number","minimum":0,"maximum":10},"include_seen":{"type":"boolean"},"includeSeen":{"type":"boolean"}},"required":["date"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"dateWindow":{"type":"object","properties":{"date":{"type":"string"},"timezone":{"type":"string"},"start":{"type":"string"},"end":{"type":"string"}},"additionalProperties":false},"topClips":{"type":"array","items":{"type":"object","properties":{"clipId":{"type":"number"},"momentId":{"type":"number"},"autoFindItemId":{"type":"number"},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]},"seen":{"type":"boolean"},"seenAt":{"type":["string","null"]},"seenScope":{"type":"string"},"nextTools":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"results":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"suggestedNextActions":{"type":"array","items":{"type":"string"}},"filters":{"type":"object","additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"get_clip_details","title":"Get clip details","description":"Fetch one FindaClip clip by clip_id or moment_id, including timestamps, quote preview, parent Auto Find result, seen metadata, deep links, and Post Writer readiness.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"clip_id":{"type":"number"},"clipId":{"type":"number"},"moment_id":{"type":"number"},"momentId":{"type":"number"},"auto_find_item_id":{"type":"number"},"autoFindItemId":{"type":"number"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"clip":{"type":"object","properties":{"clipId":{"type":"number"},"momentId":{"type":"number"},"autoFindItemId":{"type":"number"},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]},"seen":{"type":"boolean"},"seenAt":{"type":["string","null"]},"seenScope":{"type":"string"},"nextTools":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"result":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"postWriterReadiness":{"type":"object","additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"mark_clip_seen","title":"Mark clip seen","description":"Mark a clip as seen for the current MCP bearer token. Seen state is per token/client, so one agent does not hide clips from another.","inputSchema":{"type":"object","properties":{"clip_id":{"type":"number"},"clipId":{"type":"number"},"moment_id":{"type":"number"},"momentId":{"type":"number"},"auto_find_item_id":{"type":"number"},"autoFindItemId":{"type":"number"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"clip":{"type":"object","properties":{"clipId":{"type":"number"},"momentId":{"type":"number"},"autoFindItemId":{"type":"number"},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"availableAt":{"type":["string","null"]},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]},"seen":{"type":"boolean"},"seenAt":{"type":["string","null"]},"seenScope":{"type":"string"},"nextTools":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"analyze_youtube_links","title":"Analyze YouTube links","description":"Find clips from YouTube links by queueing Auto Find clip analysis. Use only when the user explicitly asks for clips, moments, shorts, or Auto Find results; do not use this for transcript-only summaries or Q&A.","inputSchema":{"type":"object","properties":{"links":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"string"}},"promptTemplateIds":{"type":"array","minItems":1,"maxItems":2,"items":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]}}},"required":["links"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"autoFindEnabled":{"type":"boolean"},"queuedRuns":{"type":"number"},"queuedItemIds":{"type":"array","items":{"type":"number"}},"existingItemIds":{"type":"array","items":{"type":"number"}},"polling":{"anyOf":[{"type":"object","properties":{"tool":{"type":"string"},"autoFindItemIds":{"type":"array","items":{"type":"number"}}},"additionalProperties":false},{"type":"null"}]},"results":{"type":"array","items":{"type":"object","properties":{"link":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"status":{"type":"string"},"reason":{"type":["string","null"]},"queuedPromptTemplateIds":{"type":"array","items":{"type":"string"}},"skippedPromptTemplateIds":{"type":"array","items":{"type":"string"}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":true}},"note":{"type":"string"}},"required":["summary","displayText","nextActions"],"additionalProperties":true},"requiredScopes":["auto_find.write"]},{"name":"prepare_video_clip_pack","title":"Prepare video clip pack","description":"Workflow-level tool for agents: queue or reuse Auto Find analysis for one YouTube video, return status immediately, and include contentPack plus clipAssetManifest when clips are available. This tool is status-first and does not block waiting for long-running analysis.","inputSchema":{"type":"object","properties":{"youtubeUrl":{"type":"string"},"youtubeVideoId":{"type":"string"},"promptTemplateIds":{"type":"array","minItems":1,"maxItems":2,"items":{"type":"string","enum":["best_topics_clips","outrage_comment_clips","custom_auto_find_clips"]}},"limit":{"type":"number","minimum":1,"maximum":50},"includePostWriterReadiness":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"queuedItemIds":{"type":"array","items":{"type":"number"}},"existingItemIds":{"type":"array","items":{"type":"number"}},"polling":{"anyOf":[{"type":"object","properties":{"tool":{"type":"string"},"autoFindItemIds":{"type":"array","items":{"type":"number"}}},"additionalProperties":false},{"type":"null"}]},"runs":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"results":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"contentPack":{"type":"object","additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["auto_find.write","clips.read"]},{"name":"get_auto_find_run_status","title":"Get Auto Find run status","description":"Poll queued or completed Auto Find run status by item IDs returned from analyze_youtube_links. When runs are complete, call get_clip_results for the actual clips.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"autoFindItemIds":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"number"}}},"required":["autoFindItemIds"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"runs":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"get_clip_results","title":"Get clip results","description":"Fetch clip titles, moment IDs, timestamps, scores, speaker quote previews, FindaClip deep links, and structuredContent.clipAssetManifest for Auto Find results. Unless the user asks for top or best clips only, show all clips returned by this tool.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"autoFindItemIds":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"number"}},"youtubeVideoId":{"type":"string"},"limit":{"type":"number","minimum":1,"maximum":50}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"results":{"type":"array","items":{"type":"object","properties":{"autoFindItemId":{"type":"number"},"status":{"type":["string","null"]},"promptTemplateId":{"type":["string","null"]},"youtubeVideoId":{"type":["string","null"]},"videoTitle":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"publishedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"lastError":{"type":["string","null"]},"clipCount":{"type":"number"},"clips":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"clipSummary":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]},"rankingScore":{"type":["number","null"]},"rankingLabel":{"type":["string","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"clipAssetManifest":{"type":"array","items":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"video":{"type":"object","properties":{"autoFindItemId":{"type":["number","null"]},"youtubeVideoId":{"type":["string","null"]},"title":{"type":["string","null"]},"channelTitle":{"type":["string","null"]},"thumbnailUrl":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]}},"additionalProperties":true},"timestamps":{"type":"object","properties":{"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"startTimestamp":{"type":["string","null"]},"endTimestamp":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"duration":{"type":["string","null"]}},"additionalProperties":true},"rank":{"type":"object","properties":{"score":{"type":["number","null"]},"label":{"type":["string","null"]}},"additionalProperties":true},"evidence":{"type":"object","properties":{"speakerQuotePreview":{"type":["string","null"]},"clipSummary":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"}},"additionalProperties":true},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"locked":{"type":"boolean"},"recommendedNextActions":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"load_youtube_transcript","title":"Load YouTube transcript","description":"Fetch and cache the full timestamped transcript for a YouTube URL or video ID without running clip analysis or creating Auto Find items. Requires an active FindaClip plan, blocks when locked unpaid results exist, and may consume transcript-load credits the first time a user loads a video. Use this for new YouTube URLs when the user asks for a transcript, summary, or Q&A about the video. When citing transcript timestamps, use playbackLinkTemplate to link those moments back to FindaClip playback.","inputSchema":{"type":"object","properties":{"youtubeVideoId":{"type":"string"},"videoId":{"type":"string"},"youtubeUrl":{"type":"string"},"url":{"type":"string"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"youtubeVideoId":{"type":"string"},"title":{"type":"string"},"channelTitle":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"transcriptFormat":{"type":"string"},"transcriptCharacterCount":{"type":"number"},"transcriptSegmentCount":{"type":"number"},"openInFindaClip":{"type":["string","null"]},"playbackLinkTemplate":{"type":["string","null"]}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"get_video_transcript","title":"Get video transcript","description":"Load the full timestamped transcript for an already analyzed, Auto Find, or previously transcript-loaded YouTube video into the current chat session. Requires an active FindaClip plan and blocks when locked unpaid results exist. Use this before answering questions about what was said in an existing FindaClip video. If the user says latest or most recent, call with latest: true or no arguments. If the user gives a title, call with titleQuery. Call this once per video in a chat session; answer follow-up questions from the transcript already returned unless the user asks to reload it or asks about a different video. When citing transcript timestamps, use playbackLinkTemplate to link those moments back to FindaClip playback.","readOnlyHint":true,"inputSchema":{"type":"object","properties":{"youtubeVideoId":{"type":"string"},"videoId":{"type":"string"},"youtubeUrl":{"type":"string"},"url":{"type":"string"},"autoFindItemId":{"type":"number"},"titleQuery":{"type":"string"},"videoTitle":{"type":"string"},"title":{"type":"string"},"query":{"type":"string"},"search":{"type":"string"},"latest":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"youtubeVideoId":{"type":"string"},"title":{"type":"string"},"channelTitle":{"type":["string","null"]},"durationSeconds":{"type":["number","null"]},"transcriptFormat":{"type":"string"},"transcriptCharacterCount":{"type":"number"},"transcriptSegmentCount":{"type":"number"},"openInFindaClip":{"type":["string","null"]},"playbackLinkTemplate":{"type":["string","null"]}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["clips.read"]},{"name":"generate_speaker_quote","title":"Generate speaker quote","description":"Generate or return a chat-safe speaker quote preview for a selected FindaClip clip. Present speakerQuotePreview in chat and use the FindaClip deep link for the full generated quote and playback.","inputSchema":{"type":"object","properties":{"momentId":{"type":"number"}},"required":["momentId"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"speakerQuotePreview":{"type":["string","null"]},"hasFullSpeakerQuote":{"type":"boolean"},"moment":{"type":"object","properties":{"momentId":{"type":"number"},"title":{"type":["string","null"]},"startTime":{"type":["number","null"]},"endTime":{"type":["number","null"]},"rankingScore":{"type":["number","null"]},"openInFindaClip":{"type":["string","null"]}},"additionalProperties":false}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["post_writer.write"]},{"name":"generate_post_ideas","title":"Generate Post Writer ideas","description":"Generate Post Writer idea sets for a selected FindaClip clip. Use structuredContent.displayText verbatim unless the user asks for a summary; do not convert source references into clickable links.","inputSchema":{"type":"object","properties":{"momentId":{"type":"number"},"notes":{"type":"string"},"researchEnabled":{"type":"boolean"},"force":{"type":"boolean"}},"required":["momentId"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"messageId":{"type":["number","null"]},"momentId":{"type":"number"},"analyses":{"type":"array","items":{"type":"object","additionalProperties":true}},"ideas":{"type":"array","items":{"type":"object","additionalProperties":true}},"research":{"type":"object","additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"notes":{"type":["string","null"]},"researchEnabled":{"type":"boolean"},"presentationGuidance":{"type":"object","additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["post_writer.write"]},{"name":"generate_post_drafts","title":"Generate Post Writer drafts","description":"Generate one Post Writer draft from a selected idea or style for a FindaClip clip. Call generate_post_ideas first unless the user already selected a known idea/style. Pass style or selectedIdea.style to create only that selected draft.","inputSchema":{"type":"object","properties":{"momentId":{"type":"number"},"ideaId":{"type":"number"},"selectedIdea":{"type":"object","additionalProperties":true},"style":{"type":"string"},"notes":{"type":"string"},"researchEnabled":{"type":"boolean"},"force":{"type":"boolean"}},"required":["momentId"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"messageId":{"type":["number","null"]},"momentId":{"type":"number"},"drafts":{"type":"array","items":{"type":"object","additionalProperties":true}},"createdDrafts":{"type":"array","items":{"type":"object","additionalProperties":true}},"existingDraftCount":{"type":"number"},"failedStyles":{"type":"array","items":{"type":"string"}},"batchId":{"type":["string","null"]},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true},"selectedIdeaId":{"type":["number","null"]},"style":{"type":["string","null"]},"notes":{"type":["string","null"]},"researchEnabled":{"type":"boolean"},"presentationGuidance":{"type":"object","additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["post_writer.write"]},{"name":"draft_posts_for_clips","title":"Draft posts for clips","description":"Batch convenience tool for scheduled agents: generate Post Writer drafts grouped by selected clip IDs. Preserves existing locked-result and credit-shortfall behavior per clip.","inputSchema":{"type":"object","properties":{"clip_ids":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"number"}},"clipIds":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"number"}},"moment_ids":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"number"}},"momentIds":{"type":"array","minItems":1,"maxItems":10,"items":{"type":"number"}},"style":{"type":"string"},"notes":{"type":"string"},"research_enabled":{"type":"boolean"},"researchEnabled":{"type":"boolean"},"force":{"type":"boolean"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"drafts":{"type":"array","items":{"type":"object","additionalProperties":true}},"failures":{"type":"array","items":{"type":"object","additionalProperties":true}},"style":{"type":["string","null"]},"notes":{"type":["string","null"]},"researchEnabled":{"type":"boolean"},"presentationGuidance":{"type":"object","additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["post_writer.write"]},{"name":"unlock_post_ideas","title":"Unlock Post Writer ideas","description":"Unlock a locked Post Writer idea set after the user explicitly asks and has enough FindaClip credits. For shortfalls, explain creditsRequired, creditsAvailable, and creditsShortfall before using top-up tools.","inputSchema":{"type":"object","properties":{"analysisId":{"type":"number"}},"required":["analysisId"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"analysis":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["credits.write","post_writer.write"]},{"name":"unlock_post_draft","title":"Unlock Post Writer draft","description":"Unlock a locked Post Writer draft after the user explicitly asks and has enough FindaClip credits. For shortfalls, explain creditsRequired, creditsAvailable, and creditsShortfall before using top-up tools.","inputSchema":{"type":"object","properties":{"draftId":{"type":"number"},"variantId":{"type":"number"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"summary":{"type":"string"},"displayText":{"type":"string"},"nextActions":{"type":"array","items":{"type":"string"}},"draft":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]},"links":{"type":"object","properties":{"settings":{"type":"string"},"subscribe":{"type":"string"},"billing":{"type":"string"},"autoFind":{"type":"string"},"openInFindaClip":{"type":"string"}},"additionalProperties":true}},"required":["summary","displayText","nextActions"],"additionalProperties":false},"requiredScopes":["credits.write","post_writer.write"]}]}