MCP Radar
MCP Server

PodLearn

io.github.blutrich/podlearn
Education Media & Content Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Searches podcasts and YouTube, transcribes episodes, searches transcripts, generates structured lessons, and creates LinkedIn posts.

Capabilities

Tools

25 tools
browse_episodes
Browse episodes
Open an interactive episode picker (card grid with thumbnails) 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.
Read only
Input schema 
{'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}
generate_lesson
Generate a structured AI lesson (summary, key takeaways, sections) from a completed transcription. Requires the episode to have transcription_status "completed". Consumes 1 credit, or one unit of subscription quota, on first generation for an episode; subsequent calls return the cached lesson at no cost.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['episode_id'], 'properties': {'episode_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
generate_linkedin_post
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.
Input schema 
{'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}
get_episode_details
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.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['episode_id'], 'properties': {'episode_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_episode_usage
Get the caller's episode-access usage stats — how many episodes they've transcribed/read this billing period.
Read only
Input schema 
{'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}
get_lesson_content
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.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['lesson_id'], 'properties': {'lesson_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_podcast_details
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).
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['podcast_id'], 'properties': {'podcast_id': {'type': 'integer', 'description': 'Local podcast id'}}, 'additionalProperties': False}
get_saved_items
List the caller's saved/bookmarked episodes and lessons.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_subscription_status
Get the caller's subscription plan + active/expired status + period end.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_transcription
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.
Read only
Input schema 
{'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}
get_transcription_segments
Fetch timestamped transcript segments. Use when the user wants timestamps — "jump to where they discuss X", chapter boundaries, durations of specific parts.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['episode_id'], 'properties': {'episode_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
get_user_credits
Get the caller's remaining transcription credits.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
list_episodes
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.
Read only
Input schema 
{'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}
list_feed_episodes
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.
Read only
Input schema 
{'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 â\x80\x94 published AFTER'}, 'before': {'type': 'integer', 'description': 'Unix seconds â\x80\x94 published BEFORE (pagination)'}, 'feed_id': {'type': 'string', 'description': 'PodcastIndex feed_id (the `id` from a search_podcasts result)'}}, 'additionalProperties': False}
list_lessons
List the calling user's saved AI-generated lessons.
Read only
Input schema 
{'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}
list_podcasts
List podcasts already in the PodLearn library, optionally filtered by category. Returns most-recently-added first. For discovery beyond the library use search_podcasts.
Read only
Input schema 
{'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}
remove_saved_item
Permanently remove a saved/bookmarked episode or lesson from the caller's collection. The saved_item_id comes from get_saved_items.
Destructive
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['saved_item_id'], 'properties': {'saved_item_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
save_item
Bookmark an episode or lesson for the caller.
Input schema 
{'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}
search_episodes
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.
Read only
Input schema 
{'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}
search_podcasts
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.
Read only
Input schema 
{'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}
search_transcription
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.
Read only
Input schema 
{'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}
search_youtube
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`; to ingest one, confirm cost and call transcribe_url(url, title).
Read only
Input schema 
{'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}
start_transcription
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).
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['episode_id'], 'properties': {'episode_id': {'type': 'string', 'format': 'uuid'}}, 'additionalProperties': False}
transcribe_feed
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 subscription quota) — CONFIRM the cost with the user first. Enqueue-and-poll: returns each enqueued episode_id; poll get_episode_details until transcription_status is "completed".
Input schema 
{'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}
transcribe_url
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".
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['audio_url', 'title'], 'properties': {'title': {'type': 'string', 'minLength': 1, 'description': "Episode title â\x80\x94 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 â\x80\x94 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}
History

Recent tool changes

Added
browse_episodes
Sept. 17, 2026, 12:40 p.m.
Added
search_youtube
Sept. 17, 2026, 12:40 p.m.
Added
generate_linkedin_post
Sept. 17, 2026, 12:40 p.m.
Added
remove_saved_item
Sept. 17, 2026, 12:40 p.m.
Added
save_item
Sept. 17, 2026, 12:40 p.m.
Added
get_saved_items
Sept. 17, 2026, 12:40 p.m.
Added
get_episode_usage
Sept. 17, 2026, 12:40 p.m.
Added
get_user_credits
Sept. 17, 2026, 12:40 p.m.
Added
get_subscription_status
Sept. 17, 2026, 12:40 p.m.
Added
generate_lesson
Sept. 17, 2026, 12:40 p.m.
Added
get_lesson_content
Sept. 17, 2026, 12:40 p.m.
Added
list_lessons
Sept. 17, 2026, 12:40 p.m.
Added
get_transcription_segments
Sept. 17, 2026, 12:40 p.m.
Added
search_transcription
Sept. 17, 2026, 12:40 p.m.
Added
get_transcription
Sept. 17, 2026, 12:40 p.m.
Added
start_transcription
Sept. 17, 2026, 12:40 p.m.
Added
transcribe_feed
Sept. 17, 2026, 12:40 p.m.
Added
transcribe_url
Sept. 17, 2026, 12:40 p.m.
Added
get_episode_details
Sept. 17, 2026, 12:40 p.m.
Added
list_episodes
Sept. 17, 2026, 12:40 p.m.
Added
list_feed_episodes
Sept. 17, 2026, 12:40 p.m.
Added
search_episodes
Sept. 17, 2026, 12:40 p.m.
Added
get_podcast_details
Sept. 17, 2026, 12:40 p.m.
Added
list_podcasts
Sept. 17, 2026, 12:40 p.m.
Added
search_podcasts
Sept. 17, 2026, 12:40 p.m.
Discover

Similar MCP servers

Soluble(s) — Podcast de journalisme de solutions

io.github.petitsolu/solubles

Searches French solutions-journalism podcast episodes and transcripts, including child-friendly versions and practical actions.

Social Fetch

io.github.social-freak-ltd/socialfetch

Retrieves public content and metadata from social networks, music services, Facebook Marketplace, events, profiles, posts, commen…

Heista

co.heista/api

Analyzes video advertising, builds brand intelligence profiles, researches markets, and generates advertising scripts and creativ…

concordance

com.narrowhighway/concordance

Provides deterministic claim verification and audit receipts, along with Bible references, commentary, geography, indexed knowled…

Lodi Kids Activities

com.lodikidsactivities/lodi-kids-activities

Searches and manages a directory of youth programs, family events, and licensed daycares in Lodi, California, including listings,…

VarynForge

com.varynforge/server

Supports SEO research and content planning through niche analysis, competitor and keyword research, opportunity discovery, and wr…

Tmdb

io.github.pipeworx-io/tmdb

Provides TMDB-based movie, television, and people discovery, metadata, credits, recommendations, videos, and trend-related entert…

AfterLaunch: the agentic growth marketing engine

io.afterlaunch/agentic-growth-marketing

Runs growth-marketing workflows covering SEO, AI-search visibility, competitor analysis, content planning, distribution channels,…