Ask your agent in plain language. Each of these maps to a real tool on the server.
get_podcast
Fetch detailed metadata for a podcast by its Listen Notes ID. Returns full podcast information including title, publisher, description, RSS feed URL, genre IDs, listen score, and recent episodes. Use **nextEpisodePubDate** for paginating through a podcast's episode list.
submit_podcast
Submit a podcast RSS feed URL to the Listen Notes database. If the RSS URL already exists, returns the podcast metadata immediately. Otherwise, the podcast is reviewed and added within 12 hours. Optionally provide an email to receive a notification when the podcast is added.
search_podcasts
Full-text search across millions of podcasts, episodes, and curated lists. Supports filtering by content type, genre, language, region, publish date range, and audio length. Results include highlighted matches and relevance scoring. Use **type** to search podcasts, episodes, or curated lists.
get_episode
Fetch detailed metadata for a podcast episode by its Listen Notes ID. Returns full episode information including title, description, audio URL, duration, publish date, and parent podcast metadata. Optionally include transcript if available (PRO/ENTERPRISE plans).
batch_fetch
Fetch metadata for multiple podcasts or episodes in a single request (up to 10). For podcasts, you can look them up by Listen Notes IDs, RSS URLs, iTunes IDs, or Spotify IDs. For episodes, provide Listen Notes episode IDs. Requires PRO/ENTERPRISE plan.
typeahead_search
Search-as-you-type suggestions for podcast search. Returns autocomplete term suggestions and optionally matching podcasts and genres. Omit the query to retrieve trending search terms.
curated_lists
Browse and fetch curated podcast lists. Without a curatedListId, returns a paginated list of available curated collections. With a curatedListId, returns the full details and podcasts in that specific curated list.
get_recommendations
Get similar podcast or episode recommendations based on a given podcast or episode ID. Returns up to 8 recommendations that are similar in content and style.
best_podcasts
Browse the best and most popular podcasts by genre. Returns curated lists of top podcasts with pagination support. Filter by genre, region, publisher region, language, and sort order. Use the "Get Genres & Regions" tool to discover available genre IDs and region codes.
get_playlists
Fetch your Listen Notes playlists. Without a playlistId, returns a paginated list of all your playlists. With a playlistId, returns the full playlist with its items (episodes or podcasts).
random_episode
Get a random podcast episode from Listen Notes ("Just Listen"). Great for discovering new content or providing serendipitous recommendations.
delete_podcast
Request removal of a podcast from the Listen Notes database. This is primarily used by podcast hosting services to handle content removal requests on behalf of podcasters.
get_genres_and_regions
Fetch the directory of podcast genres, supported languages, and supported regions. Use this to discover valid genre IDs, language names, and region codes for filtering search and discovery results.
remove_playlist_item
Remove an item from a playlist. Repeating removal of the same item succeeds. The podcast or episode remains in the podcast database.
create_playlist
Create an empty Listen Later playlist for collecting podcasts or episodes. Returns its ID and saved metadata.
delete_playlist
Permanently delete a playlist and all its saved item references and notes. Episodes and podcasts remain in the podcast database. Obtain explicit confirmation before calling this tool.
update_playlist
Update a playlist name, description, visibility, or default view. Omitted fields remain unchanged. Switching visibility to private rotates the RSS secret.
update_playlist_item
Replace the notes on an existing playlist item. Send an empty string to clear the notes. The item ID and added timestamp remain unchanged.
add_playlist_item
Add a podcast or episode to a playlist. Existing active items are reused; deleted items are restored. Omitted notes preserve existing notes, including on restoration.
search_episode_titles
Find episodes by title, optionally restricted to a podcast identified by Listen Notes ID, Apple Podcasts ID, Spotify ID, or RSS URL. Useful for matching episodes imported from another platform.
get_podcasts_by_domain
Discover podcasts published by a domain such as npr.org or nytimes.com. Returns up to 10 podcasts per page with pagination information.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.
Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.
Send, edit, and delete messages in channels. Manage servers (guilds), channels, roles, members, invites, webhooks, threads, scheduled events, auto moderation rules, audit logs, application commands, and custom guild emojis.
Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.
Manage web application sites, deploys, builds, build hooks, deployed files, metadata, and hosting on Netlify. Create, update, configure, list, and delete sites. Manage environment variables with per-context values and scopes. Access and manage form submissions, including spam filtering. Configure DNS zones and records. Inject JavaScript or HTML snippets into site pages. Create and manage split tests (A/B testing) for traffic routing between branches. Set up notification hooks for deploy and form submission events. Purge CDN cached content by site or cache tag.
Search, browse, and retrieve metadata for millions of podcasts and episodes. Perform full-text search across episode titles, descriptions, and podcast metadata with filters for language, genre, region, and publish date. Fetch detailed podcast and episode information including titles, descriptions, audio URLs, images, and cross-platform links (Spotify, Apple Podcasts, YouTube). Discover trending and recommended podcasts, browse curated "best podcasts" lists by genre, and find similar shows. Retrieve episode transcripts where available. Manage playlists of podcasts and episodes. Submit new podcast RSS feeds to the database. Look up podcasts by Apple Podcasts/iTunes IDs for cross-platform matching. Browse the full taxonomy of podcast genres and supported languages.
Common questions about connecting Listen Notes to AI agents with Metorial.
