listennotes

ListenNotes MCP Server

Overview

The ListenNotes MCP server is designed to provide extensive tools for searching and fetching metadata related to podcasts and episodes. It allows users to explore almost all available podcasts and episodes on the internet, offering detailed insights and recommendations. The server aims to support developers and users in creating and enhancing podcast applications or services by delivering rich and structured podcast data.

Features

Search and Discovery

• Full-text Search: This tool enables searching for episodes or podcasts by various criteria, such as relevance or date. It supports filtering by genre, language, and explicit content.

• Typeahead Suggestions: Offers smart suggestions for search terms, helping users find relevant podcasts or episodes quickly.

Directory and Metadata

• Fetch Supported Countries/Regions: Provides a list of countries and regions where best podcasts are available, assisting in regional filtering.

• Fetch Supported Languages: Lists languages supported in the ListenNotes database, useful for language-specific searches.

• Fetch Podcast Genres: Returns a list of podcast genres that can be used to filter search results by specific genres.

Recommendations and Curation

• Podcast Recommendations: Offers up to 8 podcast recommendations based on a given podcast ID.

• Episode Recommendations: Provides up to 8 episode recommendations based on a given episode ID.

• Curated Lists of Podcasts: Fetches curated lists of podcasts, offering a selection of recommended content.

Batch and Random Fetching

• Batch Fetch Metadata for Episodes: Allows fetching basic metadata for up to 10 episodes in one request, useful for creating custom playlists.

• Batch Fetch Metadata for Podcasts: Enables fetching metadata for up to 10 podcasts, facilitating features like OPML import.

• Fetch a Random Podcast Episode: Retrieve a random podcast episode for discovery or entertainment purposes.

Usage Guidelines

Display Requirements

• Any application displaying data fetched from the ListenNotes MCP server must include a "Powered by Listen Notes" logo on the same page or screen.

Content Handling

• Applications should not pre-fetch, cache, index, or store any content fetched from the server. However, the podcast or episode IDs used for identification are exempt from this restriction.

Free Promotion

• Applications using the ListenNotes MCP server may qualify for free promotion. To apply, send an application logo, URL, and a short description to the designated contact channel.

By leveraging the tools and capabilities of the ListenNotes MCP server, developers can enhance their applications with comprehensive podcast data, leading to enriched user experiences and improved content discovery.