MCP tool

Start a long-form analysis

Start a long-form analysis of a public YouTube video longer than 10 minutes. It listens to the opening first: a podcast episode gets a podcast analysis, anything else a video analysis.

LiveGrowth and above

Tool contract

PropertyValue
Tool namestart_longform_analysis
OAuth scopelongform:write
Rate limit5 requests/minute
PlanGrowth and above

Inputs

FieldTypeDescription
urlstring, requiredA public YouTube link to a video longer than 10 minutes.
ownershipmine | competitorWhose video it is. A video you analysed before keeps its earlier answer when this is left out; a new one is yours.
asPodcastbooleanRead a video that already has a finished video analysis again, as a podcast. It uses long-form minutes again, and the video analysis stays.

Output

  • The analysis identifier, to read with Read a long-form report once it is done
  • The long-form minutes it uses
  • Or why it was not started, before anything is spent

Example arguments

json
{"url":"https://www.youtube.com/watch?v=00000000000","ownership":"mine"}

Important details

  • It uses your monthly long-form minutes, not a monthly analysis. It starts at once from a connected assistant, so the permission to start long-form analyses is asked for when you connect, and an assistant connected before it existed needs to connect again.
  • Before anything is spent it checks the video: one of 10 minutes or less, one you have already analysed, one while another is running, or one your minutes do not cover is not started.
  • Starting one in the Retensis Agent is available on every Retensis plan: you approve each start on a card that states the minutes it uses, and your long-form minutes decide what can start. Starting from a connected assistant is part of Growth, like every tool on this page.

Related documentation