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
| Property | Value |
|---|---|
| Tool name | start_longform_analysis |
| OAuth scope | longform:write |
| Rate limit | 5 requests/minute |
| Plan | Growth and above |
Inputs
| Field | Type | Description |
|---|---|---|
| url | string, required | A public YouTube link to a video longer than 10 minutes. |
| ownership | mine | competitor | Whose video it is. A video you analysed before keeps its earlier answer when this is left out; a new one is yours. |
| asPodcast | boolean | Read 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
Retensis MCP
Connect Retensis to Claude, ChatGPT, or another AI assistant and run your research, writing, and analysis tools just by asking.
OAuth and scopes
Understand Retensis MCP authorization, token lifetime, PKCE, and available scopes.
MCP tool reference
Every Retensis tool your assistant can use, and what each one does.