# Listen Notes — how to use (mcp.ai)

Connect your Listen Notes account and use 26 tools for video and audio straight from your AI agent. Connect with your own API key. Listen Notes is a powerful podcast search engine and database that allows you to discover, explore, and listen to millions of podcasts and episodes worldwide.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_listennotes?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `listennotes_batch_fetch_basic_meta_data_for_episodes`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/listennotes`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/listennotes/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/listennotes/batch/fetch/basic/meta/data/for/episodes` — The listennotestest_episodes_post endpoint allows users to retrieve metadata for multiple podcast episodes in a single request. This POST endpoint accepts a list of episode IDs and returns detailed in
  - body: { ids: string }
- `POST https://api.mcp.ai/api/listennotes/batch/fetch/basic/meta/data/for/podcasts` — The listennotestest_podcasts_post endpoint allows users to retrieve information about multiple podcasts using various identifiers such as Listen Notes IDs, RSS feed URLs, Apple Podcasts IDs, or Spotif
  - body: { ids?: string, rsses?: string, itunes_ids?: string, spotify_ids?: string, show_latest_episodes?: integer, next_episode_pub_date?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/a/curated/list/of/podcasts/by/id` — Retrieves detailed information about a specific curated podcast using its unique identifier. This endpoint allows users to access comprehensive data about a carefully selected podcast collection, incl
  - body: { id: string }
- `POST https://api.mcp.ai/api/listennotes/fetch/a/list/of/best/podcasts/by/genre` — The getBestPodcasts endpoint retrieves a curated list of the best podcasts from the Listen Notes platform. It allows users to access a collection of top-rated or popular podcasts, which can be filtere
  - body: { page?: integer, sort?: string, region?: string, genre_id?: string, language?: string, safe_mode?: integer, publisher_region?: string }
- `POST https://api.mcp.ai/api/listennotes/fetch/a/list/of/podcast/genres` — The GetGenres endpoint retrieves a comprehensive list of available genres within the listennotestest platform. This endpoint is designed to provide users with up-to-date information on content categor
  - body: { top_level_only?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/a/list/of/your/playlists` — Retrieves a list of playlists from the Listen Notes platform. This endpoint allows users to fetch all available playlists associated with their account or publicly accessible playlists. It should be u
  - body: { page?: integer, sort?: string }
- `POST https://api.mcp.ai/api/listennotes/fetch/a/random/podcast/episode` — The 'just_listen' endpoint is a basic listener or health check mechanism for the listennotestest app. It allows users to verify the availability and responsiveness of the service without requiring any
- `POST https://api.mcp.ai/api/listennotes/fetch/audience/demographics/for/a/podcast` — Retrieves audience information for a specific podcast identified by its unique ID. This endpoint allows users to access demographic data, listening statistics, or other audience-related metrics for a 
  - body: { id: string }
- `POST https://api.mcp.ai/api/listennotes/fetch/curated/lists/of/podcasts` — Retrieves a list of curated podcasts from the Listen Notes platform. This endpoint provides access to a collection of handpicked and organized podcasts, likely curated by experts or algorithms. It's u
  - body: { page?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/detailed/meta/data/for/an/episode/by/id` — Retrieves detailed information about a specific episode using its unique identifier. This endpoint allows users to access comprehensive data about an individual episode, which may include metadata suc
  - body: { id: string, show_transcript?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/podcast/episodes/by/id` — Retrieves detailed information about a specific podcast using its unique identifier. This endpoint allows users to fetch comprehensive data about a particular podcast, including but not limited to its
  - body: { id: string, sort?: string, next_episode_pub_date?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/podcast/languages` — Retrieves a list of supported languages in the Listen Notes API. This endpoint provides information about the languages available for use within the platform, which can be crucial for internationaliza
- `POST https://api.mcp.ai/api/listennotes/fetch/podcasts/by/a/publisher/s/domain/name` — Retrieves a list of podcasts associated with a specified domain name. This endpoint allows users to discover podcasts that are produced or hosted by a particular website or organization. It's useful f
  - body: { page?: integer, domain_name: string }
- `POST https://api.mcp.ai/api/listennotes/fetch/recommendations/for/a/podcast` — Retrieves a list of podcast recommendations based on a specified podcast ID. This endpoint is designed to help users discover new podcasts that are similar or related to a podcast they already enjoy. 
  - body: { id: string, safe_mode?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/recommendations/for/an/episode` — Retrieves a list of recommended podcast episodes based on a specific episode ID. This endpoint utilizes the Listen Notes API to generate personalized content suggestions, helping users discover new ep
  - body: { id: string, safe_mode?: integer }
- `POST https://api.mcp.ai/api/listennotes/fetch/related/search/terms` — Retrieves a list of related search queries based on the current context or user's recent search activity. This endpoint is useful for enhancing user experience by suggesting alternative or complementa
  - body: { q: string }
- `POST https://api.mcp.ai/api/listennotes/fetch/supported/regions` — Retrieves information about available regions in the listennotestest platform. This endpoint allows users to fetch a list of regions, which can be used for filtering content, setting up notifications,
- `POST https://api.mcp.ai/api/listennotes/fetch/trending/search/terms` — Retrieves a list of currently trending search terms related to podcasts. This endpoint provides real-time insights into popular topics and interests among podcast listeners. It's particularly useful f
- `POST https://api.mcp.ai/api/listennotes/find/episodes/by/title` — The search_episode_titles endpoint allows users to search for and retrieve episode titles based on specified criteria. It provides a powerful way to find relevant episodes quickly, supporting real-tim
  - body: { q: string, podcast_id?: string, podcast_id_type?: string }
- `POST https://api.mcp.ai/api/listennotes/full/text/search` — The search endpoint allows users to query notifications or events within the listennotestest platform. It provides a way to find specific notifications based on keywords or identifiers, helping users 
  - body: { q: string, ncid?: string, ocid?: string, type?: string, offset?: integer, region?: string, len_max?: integer, len_min?: integer, only_in?: string, language?: string, genre_ids?: string, page_size?: integer, safe_mode?: integer, sort_by_date?: integer, sponsored_only?: integer, interviews_only?: integer, published_after?: integer, unique_podcasts?: integer, update_freq_max?: integer, update_freq_min?: integer, published_before?: integer, episode_count_max?: integer, episode_count_min?: integer }
- `POST https://api.mcp.ai/api/listennotes/get/playlist/by/id` — Retrieves detailed information about a specific playlist using its unique identifier. This endpoint allows users to fetch comprehensive data about a playlist, including its name, description, creator,
  - body: { id: string, sort?: string, type?: string, last_timestamp_ms?: integer }
- `POST https://api.mcp.ai/api/listennotes/refresh/rss/feed/of/a/podcast` — Retrieves or generates an RSS feed for a specific podcast identified by its unique ID. This endpoint allows users to access the podcast's content in a standardized RSS format, which can be used for sy
  - body: { id: string }
- `POST https://api.mcp.ai/api/listennotes/request/to/delete/a/podcast` — Deletes a specific podcast from the system based on its unique identifier. This endpoint should be used when you want to permanently remove a podcast and all its associated data from the platform. It'
  - body: { id: string, reason?: string }
- `POST https://api.mcp.ai/api/listennotes/spell/check/on/a/search/term` — The spellcheck endpoint provides a spell-checking service for text input. It allows users to verify the spelling of words or phrases, likely related to audio content or podcast descriptions within the
  - body: { q: string }
- `POST https://api.mcp.ai/api/listennotes/submit/a/podcast/to/listen/notes/database` — The submit_podcast endpoint allows users to submit a podcast for inclusion in the Listen Notes database. This tool should be used when a user wants to add a new podcast to the Listen Notes platform or
  - body: { rss: string, email?: string }
- `POST https://api.mcp.ai/api/listennotes/typeahead/search` — The typeahead endpoint provides real-time search suggestions as users type their queries. It's designed to enhance the user experience by offering relevant autocomplete options, making it easier for u
  - body: { q: string, safe_mode?: integer, show_genres?: integer, show_podcasts?: integer }

## Example prompts
- "What can I do in Listen Notes?"
- "Show me a summary of my Listen Notes account"

## More
- Page: https://mcp.ai/listennotes
- Agent spec (llms.txt): https://mcp.ai/listennotes/llms.txt
- Postman collection: https://mcp.ai/listennotes/postman.json