MCP tool
Search podcast episodes
Find your podcast episodes closest in meaning to a question: a topic, a guest or a moment.
LiveGrowth and above
Tool contract
| Property | Value |
|---|---|
| Tool name | search_episodes |
| OAuth scope | analyses:read |
| Rate limit | 20 requests/minute |
| Plan | Growth and above |
Inputs
| Field | Type | Description |
|---|---|---|
| query | string, required | What you are looking for, in your own words. Up to 300 characters. |
| showId | UUID | Search only this show, from List podcast shows. All your episodes when left out. |
Output
- Up to 8 episodes, the best match first
- Each one's identifier, title and show
- Whether it is your own episode or a competitor's, when it was analysed, and its length
- Or why nothing was found
Example arguments
json
{"query":"the episode about the Viking raids"}Important details
- Searching your podcast episodes is available on every Retensis plan. Reaching it from a connected assistant is part of Growth, like every tool on this page.
- It searches the episodes you see in History, your teammates' included, by what the analysis found in each.
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.