Input schema (JSON)
{
"type": "object",
"examples": [
{
"host": "Huberman",
"query": "cold exposure benefits"
},
{
"host": "Fridman",
"query": "AI alignment"
},
{
"query": "interesting recent ideas"
},
{
"guest": "Brown"
},
{
"query": "AI safety",
"publishedAfter": "2026-01-01"
},
{
"query": "psychedelics",
"channel": "PowerfulJRE"
}
],
"required": [],
"properties": {
"host": {
"type": "string",
"maxLength": 256,
"description": "Filter to episodes where the named podcast host (interviewer / show owner) is the speaker. Case-insensitive substring (e.g. \"Huberman\" matches \"Andrew Huberman\", \"Rogan\" matches \"Joe Rogan\")."
},
"guest": {
"type": "string",
"maxLength": 256,
"description": "Filter to episodes where the named person is a GUEST being interviewed (scientist, author, CEO, public figure, expert, athlete, comedian). Case-insensitive substring (e.g. \"Brown\" matches \"Brené Brown\", \"Huang\" matches \"Jensen Huang\")."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Max episodes to return (1-25, default 10). Use a lower limit (3-5) for focused lookups, higher (10-15) for broad discovery or topical surveys."
},
"query": {
"type": "string",
"maxLength": 512,
"description": "Natural-language topic, person's view, advice domain, or quote you remember. Examples: 'cold exposure benefits', 'Jensen Huang Taiwan', 'productivity advice', 'AI safety', 'sleep tips', 'reading vs listening', 'investing for beginners'. Keep to a single coherent phrase, not a bag of paraphrases. Optional when at least one filter (host/guest/speaker/channel/publishedAfter/publishedBefore) is provided — in that case results are the most recent episodes matching the filter."
},
"channel": {
"type": "string",
"maxLength": 256,
"description": "Filter to episodes from a specific podcast/show. The catalog stores channels under canonical strings that are often YouTube handles, not show titles (e.g. \"PowerfulJRE\" for The Joe Rogan Experience). Call `list_channels` first to get the exact string when the user's wording doesn't unambiguously match a known channel. Case-insensitive substring match."
},
"speaker": {
"type": "string",
"maxLength": 256,
"description": "Filter to episodes featuring the named person in ANY role (host OR guest). Use when you don't know which side."
},
"publishedAfter": {
"type": "string",
"maxLength": 256,
"description": "Inclusive lower bound on episode publish date for recency-sensitive queries (\"latest\", \"recent\", \"this year\"). ISO date (YYYY-MM-DD) or date-time (YYYY-MM-DDTHH:MM:SSZ)."
},
"publishedBefore": {
"type": "string",
"maxLength": 256,
"description": "Inclusive upper bound on episode publish date, for queries restricted to a past window (\"in 2024\", \"before the election\"). Same format as publishedAfter."
}
},
"additionalProperties": false
}