# Listen Notes — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/listennotes

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_listennotes?ms=1787295960000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/listennotes/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/listennotes/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/listennotes/skill.md
Postman collection (v2.1): https://mcp.ai/listennotes/postman.json

## Tools
- listennotes_batch_fetch_basic_meta_data_for_episodes(ids: string) — 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
- listennotes_batch_fetch_basic_meta_data_for_podcasts(ids?: string, rsses?: string, itunes_ids?: string, spotify_ids?: string, show_latest_episodes?: integer, next_episode_pub_date?: integer) — 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
- listennotes_fetch_a_curated_list_of_podcasts_by_id(id: string) — 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
- listennotes_fetch_a_list_of_best_podcasts_by_genre(page?: integer, sort?: string, region?: string, genre_id?: string, language?: string, safe_mode?: integer, publisher_region?: string) — 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
- listennotes_fetch_a_list_of_podcast_genres(top_level_only?: integer) — 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
- listennotes_fetch_a_list_of_your_playlists(page?: integer, sort?: string) — 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
- 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
- listennotes_fetch_audience_demographics_for_a_podcast(id: string) — 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 
- listennotes_fetch_curated_lists_of_podcasts(page?: integer) — 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
- listennotes_fetch_detailed_meta_data_for_an_episode_by_id(id: string, show_transcript?: integer) — 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
- listennotes_fetch_podcast_episodes_by_id(id: string, sort?: string, next_episode_pub_date?: integer) — 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
- 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
- listennotes_fetch_podcasts_by_a_publisher_s_domain_name(page?: integer, domain_name: string) — 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
- listennotes_fetch_recommendations_for_a_podcast(id: string, safe_mode?: integer) — 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. 
- listennotes_fetch_recommendations_for_an_episode(id: string, safe_mode?: integer) — 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
- listennotes_fetch_related_search_terms(q: string) — 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
- 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,
- 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
- listennotes_find_episodes_by_title(q: string, podcast_id?: string, podcast_id_type?: string) — 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
- listennotes_full_text_search(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) — 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 
- listennotes_get_playlist_by_id(id: string, sort?: string, type?: string, last_timestamp_ms?: integer) — 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,
- listennotes_refresh_rss_feed_of_a_podcast(id: string) — 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
- listennotes_request_to_delete_a_podcast(id: string, reason?: string) — 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'
- listennotes_spell_check_on_a_search_term(q: string) — 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
- listennotes_submit_a_podcast_to_listen_notes_database(rss: string, email?: string) — 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
- listennotes_typeahead_search(q: string, safe_mode?: integer, show_genres?: integer, show_podcasts?: integer) — 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

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

## Links
Docs: https://mcp.ai/docs/mcps/listennotes
Website: https://mcp.ai/mcps/listennotes