# Podbean Podcast Hosting MCP > Podbean Podcast Hosting connects your AI agent directly to Podbean's platform. You can list, create, publish, and manage every episode in your catalog using natural language commands. Get download stats for specific shows or track performance trends across your entire podcast portfolio without opening the web dashboard. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** podcasting, audio-hosting, content-publishing, analytics, media-distribution, rss-feeds ## Description Podbean Podcast Hosting connects your AI agent straight into Podbean’s platform. This means you can manage every single thing on your podcast catalog using nothing but natural language commands. You don't gotta open up a clunky web dashboard—your agent handles it all, keeping you in the flow of work. **Finding Your Content** Your AI client gives you total visibility over what you’ve got running. If you need to see every show you manage across Podbean, your agent pulls a complete list of all associated podcasts. Need to know which episodes are available? You can ask it for a full rundown of every episode attached to the account. This lets you quickly map out your entire back catalog. **Publishing and Updating Episodes** When you're ready for new material, simply tell your agent to publish an episode; it sends that brand-new content live and available for listeners right away. If you’ve got a finished script or recording but haven't hit the button yet, it can get that episode published for you. You aren't limited to just publishing, either. If you need to tweak something on an older post—maybe the description is weak or the title needs punching up—you can use your agent to update existing content metadata. It’ll change titles or descriptions for episodes that are already out there. **Cleaning Up and Maintaining Your Catalog** Sometimes, you just gotta clear house. If an episode is totally finished, outdated, or shouldn't be public anymore, your agent can permanently delete it from the podcast feed. It’s a clean sweep, so you don't have to worry about old junk clogging up your directory. **Getting the Numbers** Knowing how things perform is everything in this business. You never gotta guess where the traffic comes from or which episodes hit different. Your agent lets you check performance stats for an entire show, pulling overall download numbers and tracking trends across your whole portfolio. If you only care about one specific episode—say, 'The Deep Dive on Crypto'—you can ask it to get that individual episode’s analytics, giving you total listens or trend data just for that single piece of content. Your agent gives you control over listing all podcasts, pulling a list of every single episode in the catalog, getting detailed metadata about one specific podcast episode, publishing new episodes live, updating old titles and descriptions, deleting outdated content, checking overall show analytics, and reviewing individual episode performance stats. You’ll run your whole operation from plain conversation. ## Tools ### get_episode_details Gets all the metadata, like title and description, for one specific podcast episode. ### get_episode_analytics Retrieves download numbers and performance data for a single specific episode. ### get_podcast_analytics Retrieves overall download numbers and performance data for an entire show/podcast. ### list_episodes Gets a full list of all episodes connected to the account. ### list_podcasts Retrieves a list of every podcast show associated with your account. ### publish_episode Makes a new, written episode live and available to listeners. ### update_episode Changes the title, description, or other details of an existing podcast episode. ### delete_episode Permanently removes an episode from your podcast feed. ## Prompt Examples **Prompt:** ``` List all my podcast episodes. ``` **Response:** ``` Retrieving episodes... I found several episodes, including 'Episode 1: The Beginning' (Published) and 'Episode 2: Deep Dive' (Draft). Would you like the details for any specific one? ``` **Prompt:** ``` Show me the download analytics for episode ID '12345'. ``` **Response:** ``` Retrieving analytics for episode '12345'... Total downloads to date: 12,450. Engagement is highest in the first 48 hours after release. ``` ## Capabilities ### List and retrieve all episodes The agent pulls a list of every podcast episode associated with your account. ### Get performance stats for an episode You pull specific download analytics, like total listens or trend data, for one chosen episode. ### Publish new episodes The agent sends a brand-new podcast episode live to the public feed. ### Update existing content metadata You change details—like descriptions or titles—for an episode that's already published. ### List all managed podcasts The agent provides a list of every podcast show you run on the platform. ## Use Cases ### Checking immediate launch success A podcaster just dropped a new episode and wants to know the impact. Instead of waiting an hour to check the site, they prompt their agent: 'Run `get_episode_analytics` for the latest ID.' The agent pulls the live data instantly. ### Cleaning up old content A Content Manager realizes several episodes from last year are outdated. They first run `list_episodes` to see all IDs, then they call `delete_episode` on the handful that need removing before publishing new material. ### Quick metadata correction The marketing team spots a typo in an episode's description. They use the agent to run `get_episode_details`, see the current text, and then call `update_episode` with the corrected information, all without opening the web UI. ### Cross-show performance audit An analyst needs a quarterly review. They use `list_podcasts` to get all show IDs, and then run `get_podcast_analytics` on each one sequentially to pull the total download numbers for the quarter. ## Benefits - Get immediate performance data. Instead of clicking into a separate analytics tab, you simply ask the agent to run `get_episode_analytics` and get the total download count right away. - Streamline publishing. Need to drop an episode? Use `publish_episode`. The agent handles the upload process without you needing to navigate the main dashboard. - Maintain consistency across shows. By using `list_podcasts` and then running `get_episode_details`, you can audit metadata for dozens of shows in minutes. - Manage content lifecycle end-to-end. You can use `update_episode` to fix a typo or change the show notes, and then use `delete_episode` when an episode is officially retired. - Track big picture trends. Don't just look at one file. Use `get_podcast_analytics` to see how your overall podcast performance stacks up month over month. ## How It Works The bottom line is: you manage your podcasting empire by talking to the API instead of clicking through dashboards. 1. Subscribe to this server and provide your Podbean Access Token (you get this from the developer portal). 2. Tell your AI agent exactly what you need—for example, 'Get analytics for my latest episode.' 3. The agent runs the necessary tool, retrieves the data, and gives you a direct answer in the chat. ## Frequently Asked Questions **How do I check the total downloads using get_episode_analytics?** You ask your agent to run `get_episode_analytics` and provide the specific episode ID. The tool returns the accumulated download count for that single show. **Can I list all my podcasts with list_podcasts?** Yes, running `list_podcasts` gives you a clean list of every podcast show associated with your account's credentials. This is key for tracking multiple shows. **What if I need to change an episode title? Do I use update_episode?** Yep, that’s exactly what `update_episode` does. You provide the episode ID and the new metadata (like a different title or description), and the tool makes the change. **Is there a way to publish a brand-new episode?** You use the `publish_episode` tool. Just give it the content, and the agent handles running the full publishing workflow on Podbean's side. **What happens when I run `delete_episode`? Is this permanent?** It permanently removes the episode record from Podbean. This action is irreversible; there's no trash bin or recovery function for deleted episodes. **If I need comprehensive metadata, should I use `get_episode_details` instead of listing episodes?** Yes, you must use `get_episode_details`. While `list_episodes` gives a quick list, this tool pulls all the specific data points for that episode, like descriptions and publishing dates. **What access level is required to successfully run `list_episodes`?** You need an active Podbean Access Token with read permissions for your podcast account. If the token lacks scope, running this tool will throw an authorization error. **How does `get_podcast_analytics` differ from getting episode analytics?** `get_podcast_analytics` tracks download trends across the entire show catalog. It provides a high-level view of overall performance, unlike `get_episode_analytics`, which is limited to one file. **How do I get a Podbean Access Token?** You must register as a developer at the [**Podbean Developer Portal**](https://developers.podbean.com/). Once you create an application, you can use the OAuth 2.0 flow to generate an access token for your account. **Can I upload audio files through this agent?** The current version of this MCP server is optimized for metadata management and publishing. For initial audio file uploads, we recommend using the Podbean dashboard to obtain a `media_key`, which can then be used by the agent to publish the episode.