get_podcast_card
ClaudeUse this when the user shares a getkorva.co/card link or asks about one specific card from earlier Korva results. Reads that one public card by its id or link and returns the Korva insight, speaker when known, episode, creator, and getkorva.co link. Reports when Korva can't show the card. Do not use this to search by topic or to find a show or episode.
lookup_podcast_or_episode
ClaudeUse this when the user names a specific podcast, host, or episode, or shares a link to one Apple Podcasts, Spotify, or YouTube episode or to a getkorva.co source or creator page, and wants its takeaways or Korva cards. Finds the closest show or episode on Korva and returns up to 5 of its public cards unless limit is set (1 to 10), plus up to 4 other matches by name. Reports when Korva has no cards for it. When a name (not a link) has no cards and kind is not "show", also returns up to 3 related cards found by meaning, marked close or loose. Do not use this for a topic across many podcasts (search_podcast_cards does that) or for transcripts.
search_podcast_cards
ClaudeUse this when the user asks what podcasts, YouTube videos, hosts, or guests said about a topic, or asks for podcast insights, takeaways, or Korva cards on a subject. Matches public Korva cards by meaning, not exact words. A card is a Korva insight from a podcast episode, YouTube video, or article. Returns up to 5 cards unless limit is set (1 to 10), each with its id, episode, creator, speaker when known, and getkorva.co link. If no card matches closely, returns up to 3 of the nearest cards marked as loose matches. Do not use this for one named show or episode (lookup_podcast_or_episode does that), for transcripts, news, or web search.
show_podcast_cards
ClaudeUse this when the user asks to see Korva cards, or when search_podcast_cards, lookup_podcast_or_episode, or get_podcast_card returns cards for the user's request, to display those cards. Takes 1 to 8 card ids from those results, so one of those tools runs first. In chat apps that display app views, shows a row of cards with the episode artwork when there is one, card text, speaker, episode, creator, and a getkorva.co link, and returns the same cards as text. Cards Korva can't show here are left out. Do not use this to search.
suggest_episode_to_korva
ClaudeUse this when the user asks Korva to add a specific podcast episode, asks to suggest or request one for Korva, or says yes after being asked whether Korva should add an episode that search_podcast_cards or lookup_podcast_or_episode found no cards for. Records the suggestion for a person at Korva to review. Nothing is added automatically, and the episode may not be added. Provide an Apple Podcasts, Spotify, or YouTube link to the episode, or the show name and episode title. Send no other details about the user or the conversation. Do not use this without the user asking or agreeing. Do not use this to recommend episodes to the user, or for whole shows or playlists.
