PodLearn is an MCP server published by io.github.blutrich, hosted at podlearn.ai. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 25 tools, including search_podcasts, list_podcasts, get_podcast_details, search_episodes, list_feed_episodes.
Search 4M+ podcasts & YouTube, transcribe any episode, search transcripts, generate AI lessons.
902 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search PodLearn library AND PodcastIndex.org (4M+ podcasts) by keyword. Also resolves Spotify/Apple Podcasts URLs. Returns rows tagged with `source: local|podcastindex|spotify`. First move when the user names a podcast/host but you don't have its id.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Search keywords or a podcast URL |
{
"name": "search_podcasts",
"title": "Search podcasts",
"description": "Search PodLearn library AND PodcastIndex.org (4M+ podcasts) by keyword. Also resolves Spotify/Apple Podcasts URLs. Returns rows tagged with `source: local|podcastindex|spotify`. First move when the user names a podcast/host but you don't have its id.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search keywords or a podcast URL"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search podcasts",
"readOnlyHint": true,
"destructiveHint": false
}
}List podcasts already in the PodLearn library, optionally filtered by category. Returns most-recently-added first. For discovery beyond the library use search_podcasts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| category | string | Filter by category (e.g. "Technology") |
{
"name": "list_podcasts",
"title": "List podcasts",
"description": "List podcasts already in the PodLearn library, optionally filtered by category. Returns most-recently-added first. For discovery beyond the library use search_podcasts.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"category": {
"type": "string",
"description": "Filter by category (e.g. \"Technology\")"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List podcasts",
"readOnlyHint": true,
"destructiveHint": false
}
}Fetch full metadata for one podcast in the PodLearn library, including its episode count. The podcast must already be in the local DB (source=local in search_podcasts results).
| Parameter | Type | Description |
|---|---|---|
| podcast_id * | integer | Local podcast id |
{
"name": "get_podcast_details",
"title": "Podcast details",
"description": "Fetch full metadata for one podcast in the PodLearn library, including its episode count. The podcast must already be in the local DB (source=local in search_podcasts results).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"podcast_id"
],
"properties": {
"podcast_id": {
"type": "integer",
"description": "Local podcast id"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Podcast details",
"readOnlyHint": true,
"destructiveHint": false
}
}Cross-podcast episode search by title/description AND parent podcast name/author. Returns local episodes only — for podcasts discoverable on PodcastIndex that aren't yet ingested, use list_feed_episodes instead. `status: "transcribed"` filters to ready-to-read; `status: "untranscribed"` to available-to-transcribe.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query * | string | Topic, keyword, or host name |
| offset | integer | |
| status | string | one of ["transcribed","untranscribed","completed","processing","failed","not_started"] |
{
"name": "search_episodes",
"title": "Search episodes",
"description": "Cross-podcast episode search by title/description AND parent podcast name/author. Returns local episodes only — for podcasts discoverable on PodcastIndex that aren't yet ingested, use list_feed_episodes instead. `status: \"transcribed\"` filters to ready-to-read; `status: \"untranscribed\"` to available-to-transcribe.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "Topic, keyword, or host name"
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"status": {
"enum": [
"transcribed",
"untranscribed",
"completed",
"processing",
"failed",
"not_started"
],
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search episodes",
"readOnlyHint": true,
"destructiveHint": false
}
}Fetch the canonical episode list for a podcast directly from PodcastIndex (the upstream RSS index). NO COST — pure discovery. Each episode is enriched with `in_library`, `episode_id` (if already ingested), and `transcription_status`. For episodes you want to ingest: call transcribe_url(audio_url, title, feed_id, podcast_name) — passing feed_id/podcast_name lands the episode under its real show. For episodes already in_library, use start_transcription(episode_id) instead.
| Parameter | Type | Description |
|---|---|---|
| max | integer | |
| since | integer | Unix seconds — published AFTER |
| before | integer | Unix seconds — published BEFORE (pagination) |
| feed_id * | string | PodcastIndex feed_id (the `id` from a search_podcasts result) |
{
"name": "list_feed_episodes",
"title": "List feed episodes",
"description": "Fetch the canonical episode list for a podcast directly from PodcastIndex (the upstream RSS index). NO COST — pure discovery. Each episode is enriched with `in_library`, `episode_id` (if already ingested), and `transcription_status`. For episodes you want to ingest: call transcribe_url(audio_url, title, feed_id, podcast_name) — passing feed_id/podcast_name lands the episode under its real show. For episodes already in_library, use start_transcription(episode_id) instead.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"feed_id"
],
"properties": {
"max": {
"type": "integer",
"default": 20,
"maximum": 200,
"minimum": 1
},
"since": {
"type": "integer",
"description": "Unix seconds — published AFTER"
},
"before": {
"type": "integer",
"description": "Unix seconds — published BEFORE (pagination)"
},
"feed_id": {
"type": "string",
"description": "PodcastIndex feed_id (the `id` from a search_podcasts result)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List feed episodes",
"readOnlyHint": true,
"destructiveHint": false
}
}List episodes already in the local DB for a specific podcast. Requires podcast_id (use search_podcasts first if you only have a name). For cross-podcast search use search_episodes; for canonical PodcastIndex listings use list_feed_episodes.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| status | string | one of ["completed","processing","failed","not_started"] |
| podcast_id * | integer | Local podcast_id from search_podcasts |
{
"name": "list_episodes",
"title": "List episodes",
"description": "List episodes already in the local DB for a specific podcast. Requires podcast_id (use search_podcasts first if you only have a name). For cross-podcast search use search_episodes; for canonical PodcastIndex listings use list_feed_episodes.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"podcast_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"status": {
"enum": [
"completed",
"processing",
"failed",
"not_started"
],
"type": "string"
},
"podcast_id": {
"type": "integer",
"description": "Local podcast_id from search_podcasts"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List episodes",
"readOnlyHint": true,
"destructiveHint": false
}
}Fetch full metadata for one episode including transcription_status and lesson_generation_status. Tells you whether get_transcription is ready or you need to transcribe first: start_transcription(episode_id) for an in-library episode (inherits its existing show/artwork/feed linkage automatically) or transcribe_url(audio_url, title, feed_id, podcast_name) for a URL not yet in the library.
| Parameter | Type | Description |
|---|---|---|
| episode_id * | string |
{
"name": "get_episode_details",
"title": "Episode details",
"description": "Fetch full metadata for one episode including transcription_status and lesson_generation_status. Tells you whether get_transcription is ready or you need to transcribe first: start_transcription(episode_id) for an in-library episode (inherits its existing show/artwork/feed linkage automatically) or transcribe_url(audio_url, title, feed_id, podcast_name) for a URL not yet in the library.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"episode_id"
],
"properties": {
"episode_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Episode details",
"readOnlyHint": true,
"destructiveHint": false
}
}Ingest and transcribe an EXTERNAL / arbitrary audio URL — a URL the user pasted, or audio not reachable through the index. Creates a STANDALONE episode row. If the episode is already in the library (it has an episode_id), prefer start_transcription(episode_id) instead — it inherits the episode's existing show, artwork, and feed linkage automatically. Consumes 1 transcription credit, or one unit of subscription quota; the credit is refunded automatically if transcription fails. Pass feed_id / podcast_name when you already know the parent show (e.g. from search_podcasts or list_feed_episodes) so the episode lands under its real show instead of appearing as unidentified "External audio". Returns the new episode_id. Transcription is asynchronous on the fallback path — poll get_episode_details until transcription_status is "completed".
| Parameter | Type | Description |
|---|---|---|
| title * | string | Episode title — shown in the user's library |
| feed_id | string | Optional: local podcasts.id / PodcastIndex feed id of the parent show, if known. Looked up only — never creates a show. |
| language | string | BCP-47 hint (e.g. "en", "he"). Auto-detect if omitted. |
| audio_url * | string | Direct audio URL (mp3, m4a, or platform URL) |
| podcast_id | integer | Existing parent podcast_id, if any |
| podcast_name | string | Optional: exact parent show title, if known and feed_id is unavailable. Matched only when it resolves to EXACTLY ONE existing show. |
Bulk/season transcription — kick off transcription for up to `max` (cap 25) not-yet-transcribed episodes of a podcast feed in ONE call. Pass the `feed_id` from search_podcasts / list_feed_episodes. Already-transcribed episodes are skipped free. Costs 1 credit per newly enqueued episode (or one unit of subscription quota). Enqueue-and-poll: returns each enqueued episode_id; poll get_episode_details until transcription_status is "completed".
| Parameter | Type | Description |
|---|---|---|
| max | integer | Max episodes to enqueue (default 10, cap 25) |
| since | integer | Optional unix-seconds; only episodes published AFTER |
| before | integer | Optional unix-seconds; only episodes published BEFORE (page back) |
| feed_id * | string | PodcastIndex feed id (from a search_podcasts / list_feed_episodes result) |
{
"name": "transcribe_feed",
"title": "Transcribe feed (bulk)",
"description": "Bulk/season transcription — kick off transcription for up to `max` (cap 25) not-yet-transcribed episodes of a podcast feed in ONE call. Pass the `feed_id` from search_podcasts / list_feed_episodes. Already-transcribed episodes are skipped free. Costs 1 credit per newly enqueued episode (or one unit of subscription quota). Enqueue-and-poll: returns each enqueued episode_id; poll get_episode_details until transcription_status is \"completed\".",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"feed_id"
],
"properties": {
"max": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Max episodes to enqueue (default 10, cap 25)"
},
"since": {
"type": "integer",
"description": "Optional unix-seconds; only episodes published AFTER"
},
"before": {
"type": "integer",
"description": "Optional unix-seconds; only episodes published BEFORE (page back)"
},
"feed_id": {
"type": "string",
"description": "PodcastIndex feed id (from a search_podcasts / list_feed_episodes result)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Transcribe feed (bulk)",
"readOnlyHint": false,
"destructiveHint": false
}
}Kick off transcription on an episode ALREADY in the library. Use only when the episode row exists and transcription_status is not "completed". Inherits the episode's existing show, artwork, and feed linkage automatically — no need to pass podcast context. For audio not yet in the library, use transcribe_url. COSTS 1 CREDIT (or subscription quota).
| Parameter | Type | Description |
|---|---|---|
| episode_id * | string |
{
"name": "start_transcription",
"title": "Start transcription",
"description": "Kick off transcription on an episode ALREADY in the library. Use only when the episode row exists and transcription_status is not \"completed\". Inherits the episode's existing show, artwork, and feed linkage automatically — no need to pass podcast context. For audio not yet in the library, use transcribe_url. COSTS 1 CREDIT (or subscription quota).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"episode_id"
],
"properties": {
"episode_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Start transcription",
"readOnlyHint": false,
"destructiveHint": false
}
}Fetch transcript text for a completed episode. PAGINATED — returns up to 120,000 characters per call (Claude.ai/Desktop caps a tool result at ~150k chars). Most transcripts fit in one call; only very long episodes page. If the response has `has_more: true`, call again with `offset: <next_offset>`. For focused look-up (a topic, quote, timestamp) prefer search_transcription.
| Parameter | Type | Description |
|---|---|---|
| offset | integer | Character offset to start from (default 0). Use next_offset from a prior page. |
| max_chars | integer | Max characters to return this call (default & max 120000). |
| episode_id * | string |
{
"name": "get_transcription",
"title": "Get transcription",
"description": "Fetch transcript text for a completed episode. PAGINATED — returns up to 120,000 characters per call (Claude.ai/Desktop caps a tool result at ~150k chars). Most transcripts fit in one call; only very long episodes page. If the response has `has_more: true`, call again with `offset: <next_offset>`. For focused look-up (a topic, quote, timestamp) prefer search_transcription.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"episode_id"
],
"properties": {
"offset": {
"type": "integer",
"minimum": 0,
"description": "Character offset to start from (default 0). Use next_offset from a prior page."
},
"max_chars": {
"type": "integer",
"maximum": 120000,
"minimum": 2000,
"description": "Max characters to return this call (default & max 120000)."
},
"episode_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get transcription",
"readOnlyHint": true,
"destructiveHint": false
}
}Keyword search WITHIN a single episode's transcript. Returns matching chunks with surrounding context. Use instead of get_transcription when the user asked about a specific topic — server does this faster + cheaper on context.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Topic, phrase, or speaker name |
| episode_id * | string |
{
"name": "search_transcription",
"title": "Search transcript",
"description": "Keyword search WITHIN a single episode's transcript. Returns matching chunks with surrounding context. Use instead of get_transcription when the user asked about a specific topic — server does this faster + cheaper on context.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"episode_id",
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Topic, phrase, or speaker name"
},
"episode_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search transcript",
"readOnlyHint": true,
"destructiveHint": false
}
}Fetch timestamped transcript segments. Use when the user wants timestamps — "jump to where they discuss X", chapter boundaries, durations of specific parts.
| Parameter | Type | Description |
|---|---|---|
| end_time | number | End time in seconds (optional) |
| episode_id * | string | |
| start_time | number | Start time in seconds (optional) |
{
"name": "get_transcription_segments",
"title": "Transcript segments",
"description": "Fetch timestamped transcript segments. Use when the user wants timestamps — \"jump to where they discuss X\", chapter boundaries, durations of specific parts.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"episode_id"
],
"properties": {
"end_time": {
"type": "number",
"description": "End time in seconds (optional)"
},
"episode_id": {
"type": "string",
"format": "uuid"
},
"start_time": {
"type": "number",
"description": "Start time in seconds (optional)"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Transcript segments",
"readOnlyHint": true,
"destructiveHint": false
}
}List the calling user's saved AI-generated lessons.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| episode_id | string | Optional: only lessons for this episode UUID |
{
"name": "list_lessons",
"title": "List lessons",
"description": "List the calling user's saved AI-generated lessons.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"episode_id": {
"type": "string",
"format": "uuid",
"description": "Optional: only lessons for this episode UUID"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List lessons",
"readOnlyHint": true,
"destructiveHint": false
}
}Fetch the full body of one AI-generated lesson (title, summary, key takeaways, structured sections). Use to retrieve prior synthesis — for creating a NEW one call generate_lesson.
| Parameter | Type | Description |
|---|---|---|
| lesson_id * | string |
{
"name": "get_lesson_content",
"title": "Lesson content",
"description": "Fetch the full body of one AI-generated lesson (title, summary, key takeaways, structured sections). Use to retrieve prior synthesis — for creating a NEW one call generate_lesson.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"lesson_id"
],
"properties": {
"lesson_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Lesson content",
"readOnlyHint": true,
"destructiveHint": false
}
}Generate a structured AI lesson (summary, key takeaways, sections) from a completed transcription. Requires the episode to have transcription_status "completed". Requires an active subscription or available credits; no credit is deducted. Subsequent calls for the same episode return the cached lesson.
| Parameter | Type | Description |
|---|---|---|
| episode_id * | string |
{
"name": "generate_lesson",
"title": "Generate lesson",
"description": "Generate a structured AI lesson (summary, key takeaways, sections) from a completed transcription. Requires the episode to have transcription_status \"completed\". Requires an active subscription or available credits; no credit is deducted. Subsequent calls for the same episode return the cached lesson.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"episode_id"
],
"properties": {
"episode_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Generate lesson",
"readOnlyHint": false,
"destructiveHint": false
}
}Get the caller's subscription plan + active/expired status + period end.
No parameters.
{
"name": "get_subscription_status",
"title": "Subscription status",
"description": "Get the caller's subscription plan + active/expired status + period end.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"title": "Subscription status",
"readOnlyHint": true,
"destructiveHint": false
}
}Get the caller's remaining transcription credits.
No parameters.
{
"name": "get_user_credits",
"title": "User credits",
"description": "Get the caller's remaining transcription credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"title": "User credits",
"readOnlyHint": true,
"destructiveHint": false
}
}Get the caller's episode-access usage stats — how many episodes they've transcribed/read this billing period.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer |
{
"name": "get_episode_usage",
"title": "Episode usage",
"description": "Get the caller's episode-access usage stats — how many episodes they've transcribed/read this billing period.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"title": "Episode usage",
"readOnlyHint": true,
"destructiveHint": false
}
}List the caller's saved/bookmarked episodes and lessons.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer |
{
"name": "get_saved_items",
"title": "Saved items",
"description": "List the caller's saved/bookmarked episodes and lessons.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 50
},
"offset": {
"type": "integer",
"default": 0
}
},
"additionalProperties": true
},
"annotations": {
"title": "Saved items",
"readOnlyHint": true,
"destructiveHint": false
}
}Bookmark an episode or lesson for the caller.
| Parameter | Type | Description |
|---|---|---|
| item_id * | string | UUID of the episode or lesson to save |
| item_type * | string | one of ["episode","lesson"] |
{
"name": "save_item",
"title": "Save item",
"description": "Bookmark an episode or lesson for the caller.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"item_type",
"item_id"
],
"properties": {
"item_id": {
"type": "string",
"description": "UUID of the episode or lesson to save"
},
"item_type": {
"enum": [
"episode",
"lesson"
],
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Save item",
"readOnlyHint": false,
"destructiveHint": false
}
}Permanently remove a saved/bookmarked episode or lesson from the caller's collection. The saved_item_id comes from get_saved_items.
| Parameter | Type | Description |
|---|---|---|
| saved_item_id * | string |
{
"name": "remove_saved_item",
"title": "Remove saved item",
"description": "Permanently remove a saved/bookmarked episode or lesson from the caller's collection. The saved_item_id comes from get_saved_items.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"saved_item_id"
],
"properties": {
"saved_item_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Remove saved item",
"readOnlyHint": false,
"destructiveHint": true
}
}Turn an already-generated lesson into a LinkedIn-ready share post. Pass lesson_id directly OR episode_id (uses the most recent lesson generated by the caller for that episode). Lesson must exist — chain after generate_lesson if needed.
| Parameter | Type | Description |
|---|---|---|
| lesson_id | string | |
| episode_id | string |
{
"name": "generate_linkedin_post",
"title": "Generate LinkedIn post",
"description": "Turn an already-generated lesson into a LinkedIn-ready share post. Pass lesson_id directly OR episode_id (uses the most recent lesson generated by the caller for that episode). Lesson must exist — chain after generate_lesson if needed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"lesson_id": {
"type": "string",
"format": "uuid"
},
"episode_id": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Generate LinkedIn post",
"readOnlyHint": false,
"destructiveHint": false
}
}Discover YouTube videos by topic/keyword across all of YouTube. Use when the user wants to learn from a talk/interview/lecture and has no URL — especially when search_podcasts / search_episodes find nothing (much long-form content is YouTube-first). NO COST: pure discovery. Returns rows with a ready-to-transcribe `url`; ingesting one with transcribe_url(url, title) costs 1 credit.
| Parameter | Type | Description |
|---|---|---|
| max | integer | |
| query * | string |
{
"name": "search_youtube",
"title": "Search YouTube",
"description": "Discover YouTube videos by topic/keyword across all of YouTube. Use when the user wants to learn from a talk/interview/lecture and has no URL — especially when search_podcasts / search_episodes find nothing (much long-form content is YouTube-first). NO COST: pure discovery. Returns rows with a ready-to-transcribe `url`; ingesting one with transcribe_url(url, title) costs 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"max": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"query": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search YouTube",
"readOnlyHint": true,
"destructiveHint": false
}
}Open an interactive episode picker (cards with show, title, and status) for the user to pick an episode to read. On hosts that render MCP Apps the grid is clickable; everywhere else a markdown table is returned. Optional query filters by title/host.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | Optional title/host filter |
{
"name": "browse_episodes",
"title": "Browse episodes",
"description": "Open an interactive episode picker (cards with show, title, and status) for the user to pick an episode to read. On hosts that render MCP Apps the grid is clickable; everywhere else a markdown table is returned. Optional query filters by title/host.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 12,
"maximum": 40,
"minimum": 1
},
"query": {
"type": "string",
"description": "Optional title/host filter"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Browse episodes",
"readOnlyHint": true,
"destructiveHint": false
}
}Agent-facing podcast transcript library. Always cite episode_id in synthesis. For paid actions (start_transcription, transcribe_url, generate_lesson) confirm cost with the user before invoking — credit gates enforce server-side but the user should see the cost choice explicitly.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "transcribe_url",
"title": "Transcribe URL",
"description": "Ingest and transcribe an EXTERNAL / arbitrary audio URL — a URL the user pasted, or audio not reachable through the index. Creates a STANDALONE episode row. If the episode is already in the library (it has an episode_id), prefer start_transcription(episode_id) instead — it inherits the episode's existing show, artwork, and feed linkage automatically. Consumes 1 transcription credit, or one unit of subscription quota; the credit is refunded automatically if transcription fails. Pass feed_id / podcast_name when you already know the parent show (e.g. from search_podcasts or list_feed_episodes) so the episode lands under its real show instead of appearing as unidentified \"External audio\". Returns the new episode_id. Transcription is asynchronous on the fallback path — poll get_episode_details until transcription_status is \"completed\".",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"audio_url",
"title"
],
"properties": {
"title": {
"type": "string",
"minLength": 1,
"description": "Episode title — shown in the user's library"
},
"feed_id": {
"type": "string",
"description": "Optional: local podcasts.id / PodcastIndex feed id of the parent show, if known. Looked up only — never creates a show."
},
"language": {
"type": "string",
"description": "BCP-47 hint (e.g. \"en\", \"he\"). Auto-detect if omitted."
},
"audio_url": {
"type": "string",
"format": "uri",
"description": "Direct audio URL (mp3, m4a, or platform URL)"
},
"podcast_id": {
"type": "integer",
"description": "Existing parent podcast_id, if any"
},
"podcast_name": {
"type": "string",
"description": "Optional: exact parent show title, if known and feed_id is unavailable. Matched only when it resolves to EXACTLY ONE existing show."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Transcribe URL",
"readOnlyHint": false,
"destructiveHint": false
}
}