Servers Playground How we check Add a server Log in

PodLearn

Working · 3.2 s

io.github.blutrich/podlearnv1.1.0

Search 4M+ podcasts & YouTube, transcribe any episode, search transcripts, generate AI lessons.

Education News & Media

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://podlearn.ai/mcp

Authorization (optional)

Optional: Bearer pl_mcp_... personal token for headless clients. Interactive clients sign in with OAuth.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

browse_episodes Read-only

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.

limitinteger

querystring

Optional title/host filter

PodLearn MCP server | mcptry

Tools (25)

browse_episodes

read-only

Argument	Type	Description
limit	integer
query	string	Optional title/host filter

Input schema (JSON)

{
  "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.

Argument	Type	Description
episode_id*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
lesson_id	string
episode_id	string

Input schema (JSON)

{
  "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

Argument	Type	Description
episode_id*	string

Input schema (JSON)

{
  "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

Argument	Type	Description
limit	integer
offset	integer

Input schema (JSON)

{
  "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

Argument	Type	Description
lesson_id*	string

Input schema (JSON)

{
  "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

Argument	Type	Description
podcast_id*	integer	Local podcast id

Input schema (JSON)

{
  "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

Argument	Type	Description
limit	integer
offset	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50
    },
    "offset": {
      "type": "integer",
      "default": 0
    }
  },
  "additionalProperties": true
}

get_subscription_status

Get the caller's subscription plan + active/expired status + period end.

read-only

No arguments.

Input schema (JSON)

{
  "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

Argument	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

Input schema (JSON)

{
  "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

Argument	Type	Description
end_time	number	End time in seconds (optional)
episode_id*	string
start_time	number	Start time in seconds (optional)

Input schema (JSON)

{
  "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
}

get_user_credits

Get the caller's remaining transcription credits.

read-only

No arguments.

Input schema (JSON)

{
  "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

Argument	Type	Description
limit	integer
offset	integer
status	string
podcast_id*	integer	Local podcast_id from search_podcasts

Input schema (JSON)

{
  "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

Argument	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)

Input schema (JSON)

{
  "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
}

list_lessons

List the calling user's saved AI-generated lessons.

read-only

Argument	Type	Description
limit	integer
offset	integer
episode_id	string	Optional: only lessons for this episode UUID

Input schema (JSON)

{
  "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
}

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

Argument	Type	Description
limit	integer
offset	integer
category	string	Filter by category (e.g. "Technology")

Input schema (JSON)

{
  "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

Argument	Type	Description
saved_item_id*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
item_id*	string	UUID of the episode or lesson to save
item_type*	string

Input schema (JSON)

{
  "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

Argument	Type	Description
limit	integer
query*	string	Topic, keyword, or host name
offset	integer
status	string

Input schema (JSON)

{
  "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

Argument	Type	Description
query*	string	Search keywords or a podcast URL

Input schema (JSON)

{
  "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

Argument	Type	Description
query*	string	Topic, phrase, or speaker name
episode_id*	string

Input schema (JSON)

{
  "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

Argument	Type	Description
max	integer
query*	string

Input schema (JSON)

{
  "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).

Argument	Type	Description
episode_id*	string

Input schema (JSON)

{
  "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".

Argument	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)

Input schema (JSON)

{
  "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".

Argument	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.