Get current podcast chart rankings (Apple Podcasts, Spotify) by country. Shows the top podcasts for a given market.

Explore the knowledge graph extracted from transcribed audio. Given an entity (person, company, topic...), returns its typed relationships (employed_by, founded, supports, opposes, competes_with, invested_in, ...) with quote evidence from the source audio (episode + timestamp). With second_entity, returns how two entities are connected , including co-occurrence evidence when no typed relationship exists. Relationships are machine-extracted claims with evidence, not verified facts.

START HERE for summaries and key takeaways: one small response with the episode's chapters (titled, timestamped), speakers, most-mentioned entities, and metadata. Orders of magnitude cheaper than reading the transcript. Drill into any chapter with get_transcript(episode_id, start_time=chapter.start_time); use search_audio to find specific quotes.

Get a speaker's bio and audio appearances (across podcasts and uploads). Use search_speakers first to find the person_slug.

Get the transcript and metadata for one audio item , works for both podcast episodes and uploaded audio. For summaries/takeaways call get_episode_overview FIRST (chapters are far cheaper than reading everything). Returns speaker-identified segments with timestamps. Long episodes are paged to stay under client response limits: check the coverage object (first key in the response) , if truncated=true, call again with start_time=next_start_time until truncated=false; a truncated page means pagination, NOT missing transcription. A 3-hour episode is typically 3-5 calls.

Check the status of a transcription job submitted via transcribe_audio. Returns status ('pending', 'running', 'waiting', 'completed', 'failed'), current pipeline stage, and when complete an episode_id you can use with search_audio or get_transcript. 'waiting' means the recording is stored and starts by itself when the workspace's allowance allows , relay the message, do not retry. When the file turned out to be a recording already in the workspace, the reply says so, reports that recording's status and episode_id, and no minutes were used , use that episode_id with get_transcript. A long recording is transcribed in parts: while 'running', a `progress` object says how many parts are done and whether get_transcript can already return them as a PARTIAL transcript (its coverage note says so; speaker labels are provisional until the last part lands) , never present a partial as the final transcript.

Currently trending people, topics, and organizations across recently transcribed audio.

List the libraries (curated workspaces) the user is subscribed to, and the datasets inside each. Use this FIRST when the user asks what audio is available, what they have access to, or before scoping a search. Returns each library's curator, role, and dataset counts (podcasts, episodes, duration).

List the user's own recordings and transcripts, newest first (audio they uploaded or had transcribed; private to them , does not include the public podcast corpus). Each row carries the file's original filename. Use this for "my latest transcript", "my last recording", "my uploads", and BEFORE transcribe_audio when the user may have sent the file before (a new chat has no memory of earlier uploads; the recording is still here). Natural follow-up after transcribe_audio. To find specific recordings by name ("my call with Acme", "the Meridian and Helios calls"), pass query (matched against titles and filenames; separate several names with commas) instead of paging; created_after/created_before narrow by date. When has_more is true the list is cut off: narrow with query or page with next_offset before concluding a recording is missing.

List transcribed episodes within one podcast show, newest first, under a `coverage` header. Use search_podcasts first to find the podcast_id. READ `coverage` BEFORE the list: if `current` is false, our transcripts for this show stop at `last_transcribed` , tell the user that date plainly and offer transcribe_audio for newer episodes rather than searching again. An empty `episodes` page with transcribed_episodes=0 means the show is catalog-only (no transcripts yet).

List the newest episodes in the public library (podcasts and other public sources), ordered by publish date, newest first. Use podcast_ids to scope to specific shows. This is NOT the user's own recordings: for "my latest transcript", "my last recording" or "what did I upload", call list_my_uploads instead.

Compatibility search returning episode-level citable documents (id/title/url only). Clients with rich-result support should prefer search_audio, which returns the matching segments with timestamps, speakers, and snippets.

Search across all transcribed audio , public podcast episodes plus your own uploaded recordings , for any topic, phrase, or speaker. The wider 360,000-podcast catalog is discoverable via search_podcasts but is not all transcribed, and per-show coverage varies by date: check `searchable` AND `coverage` there before scoping by podcast_ids or promising recent episodes. Returns matching segments with timestamps you can cite; matches and `total` count SPOKEN transcript text only (episode/show metadata affects ranking, never whether something is a hit). Text mode needs the words spoken close together in one short segment , use 1-2 distinctive words, or search_type='semantic' for conceptual questions. To read a whole episode, use get_transcript (paged), not repeated searches. Scope with filters.podcast_ids (ids from search_podcasts) and date filters. When the query names a known person/company/topic, entity_matches identifies it , follow up with get_entity_graph or search_entities for relationships and evidence.

Search the knowledge graph for people, companies, locations, topics, and other entities mentioned in any transcribed audio.

Find a podcast show by name. Matches the title, the publisher ("The Daily New York Times" finds The Daily), initials ("LPOTL"), punctuation-free forms, typos, or a numeric podcast id. Each hit carries `searchable` (has ANY transcript) and `coverage` (how much and how recent: transcribed_episodes, last_transcribed, newest_feed_episode, current). Results with searchable=true are listed first , only those can return hits when used with search_audio filters.podcast_ids. When `coverage.current` is false, tell the user the show is covered through `last_transcribed` and offer transcribe_audio for newer episodes. When `podcasts` is EMPTY: do NOT retry with title variants , the reply already tried them. Read `suggestions` (near-matches to confirm with the user) and `hint`; the two real exits are search_audio for the topic (spoken words across every show) or transcribe_audio if the user has an episode link.

Search speakers and hosts by name across all transcribed audio. Returns matching people with their slug , use get_speaker for their full appearance history.

Create a shareable URL for a specific audio moment that unfurls with a social-media preview card on Twitter, Slack, LinkedIn, etc. Useful when the user wants to share a moment they found via search.

Get a one-time URL to upload an audio/video file the user attached in this chat when it cannot be passed as a link: PUT the raw file bytes to upload_url (e.g. run `curl -T <file> "<upload_url>"` from where the file is), within 15 minutes. The response of that PUT contains job_id , then poll get_transcription_status. Use transcribe_audio instead when you have a direct link, a Drive/Dropbox/OneDrive share link, or the client supports file inputs (audio_file). On Claude.ai and the Claude desktop app the upload only works after the user adds mcp.audioscrape.com under Settings → Create and edit files → Allowed domains; the response says so in client_setup , relay it, or prefer asking the user for a share link, which needs no setting.

Transcribe an audio or video FILE with speaker diarization; the result is indexed into the user's private workspace for search_audio and get_transcript. Give the file ONE of two ways. (1) audio_url: a direct link to the media file, or a Google Drive / Dropbox / OneDrive share link (share links are converted to direct downloads automatically , the file must be shared 'anyone with the link'). (2) audio_file: a file the user attached in this chat, when the client supports file inputs. NEVER pass a chat-sandbox path (sandbox:/..., /mnt/data/...) or a chatgpt.com URL as audio_url , those cannot be fetched and are rejected with a hint. If the client cannot pass attachments (Claude.ai and the Claude desktop app cannot), the path that needs no permission is a share link: ask the user to share the recording from Google Drive, Dropbox or OneDrive with 'anyone with the link' and pass that link as audio_url. Only fall back to request_upload_url when a share link is not possible; on Claude that upload needs mcp.audioscrape.com under Settings → Create and edit files → Allowed domains first. Web PAGE links (TikTok/Instagram/YouTube pages) are not files and are rejected. Returns a job_id , poll get_transcription_status. Transcription typically takes a few minutes. If the user refers to a recording they already sent , in this chat or an earlier one , call list_my_uploads first (it lists filenames) and read it with get_transcript instead of sending the file again. A file whose bytes are already in the workspace is matched, not transcribed twice, and uses no minutes; the status reply says so and points at the existing recording.