Audioscrape

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

get_charts

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.

request_upload_url

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

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

search_entities

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_podcasts

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

search_speakers

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_audio

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.

transcribe_audio

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.

get_transcription_status

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

get_trending