podbeanMCP

podbeanMCP

0
entertainment_and_mediaai_chatbotdeveloper_tools

Podbean MCP Server is an MCP server facilitating podcast management via the Podbean API. It connects AI assistants to enable natural conversational management of podcasts, episodes, and analytics. Key features include authentication, podcast and episode management, file handling, and access to analytics.

🎙️ Podbean MCP Server 🎧

An MCP server for managing your podcast through the Podbean API.

🎉 Overview

This MCP server connects any MCP-compatible AI assistant to the Podbean API. Whether you're using Claude Desktop, or any other MCP client, you can now manage your podcasts, episodes, and analytics through natural conversation!

✨ Features

🔐 Authentication

  • Client credentials authentication for managing your own podcasts
  • OAuth flow for third-party access (when needed)
  • Token management for multiple podcasts - juggle them all!

🎙️ Podcast Management

  • List all your awesome podcasts in one place
  • Get the nitty-gritty details about your shows
  • Peek at your stats and analytics (who's listening?)
  • Browse podcast categories to find your niche

📝 Episode Management

  • See all episodes for your podcast at a glance
  • Dig into the details of any episode
  • Publish new episodes with ease (no more complex forms!)
  • Update existing episodes when you need a tweak
  • Delete episodes that didn't quite hit the mark

📁 File Management

  • Get green lights for file uploads to Podbean
  • Upload your audio masterpieces and eye-catching images
  • Use those uploaded files when creating episodes

📊 Analytics

  • Check out how many downloads your podcast is getting
  • Track your daily listener counts (watching them grow!)
  • See how users are interacting with your content

🌐 Public Podcast Access

  • Access public podcast data through oEmbed
  • Get the scoop on any public episode out there

🧰 Prerequisites

  • Python 3.10 or higher (time to upgrade if you haven't already!)
  • A Podbean account with API access (free or paid - they're all welcome)
  • Podbean API credentials (Client ID and Secret - your magical keys to the kingdom)

🚀 Installation

  1. Grab the code:

    git clone cd PodbeanMCP

  2. Set up a virtual environment using the super-speedy uv tool:

    uv venv source .venv/bin/activate

  3. Install the package and its dependencies:

    Using uv (faster)

    uv pip install -e .

  4. Create a .env file with your secret Podbean powers:

    PODBEAN_CLIENT_ID=your_client_id PODBEAN_CLIENT_SECRET=your_client_secret

🏃‍♂️ Running the Server

Fire it up! It's as easy as:

python server.py

🔌 Connecting to Any MCP Client

  1. Open your favorite MCP-compatible AI assistant.
  2. Find the MCP server connection settings in your client.
  3. Add a new MCP server with the URL where your server is running.

🔧 Available Tools

🔑 Authentication Tools

  • Authenticate with Podbean
  • Collect tokens for podcasts

🎙️ Podcast Tools

  • List podcasts
  • Get podcast info
  • Get podcast stats

🎧 Episode Tools

  • Round up all episodes

💾 File Upload Tools

  • Authorize file upload
  • Upload files to Podbean

🌐 Public Access Tools

  • Get embeddable goodies for any Podbean URL

🔗 OAuth Tools

  • Generate OAuth URL
  • Exchange OAuth code

📚 Available Resources

  • podbean://auth
  • podbean://podcast/{podcast_id}

💬 Available Prompts

  • Podcast summary
  • Episode transcript

🛠️ Error Handling

  • Authentication issues guidance
  • API troubleshooting messages

🚧 Limitations

  • Requires extra setup for file uploads
  • Rate limits exist

👩‍💻 Contributing

Fork, code, and send a Pull Request.

📃 License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.

👏 Acknowledgments

  • Podbean API documentation
  • MCP SDK creators