Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@PodHome MCP Server Schedule 'The Future of AI' for my-main-podcast for next Friday."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for the Podhome Integration API with multi-show support.
cd podhome-mcp
uv syncRelated MCP server: Podbean MCP Server
Set the following environment variables:
PODHOME_BASE_URL - Base URL for the API (default: https://serve.podhome.fm)
PODHOME_SHOWS - JSON string mapping show slugs to API keys
Example:
export PODHOME_SHOWS='{"my-main-podcast": "phk_abc123...", "weekly-tech-show": "phk_xyz789..."}'uv run podhome-mcpThe server runs over stdio and is designed to be used with an MCP client like OpenClaw.
{
"agents": {
"main": {
"mcpServers": {
"podhome": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/podhome-mcp", "podhome-mcp"],
"env": {
"PODHOME_BASE_URL": "https://serve.podhome.fm",
"PODHOME_SHOWS": "{\"my-main-podcast\": \"phk_abc123def456...\", \"weekly-tech-show\": \"phk_789xyz...\"}"
}
}
}
}
}
}create_episode - Create a new episode for a specific show
list_episodes - List episodes for a specific show (with optional filters)
schedule_episode - Schedule or publish an episode
modify_episode - Modify an episode's metadata
create_clip - Create a clip (soundbite) from an episode
list_webhooks - List all registered webhooks
register_webhook - Register a new webhook
delete_webhook - Delete a webhook
test_webhook - Test webhooks
list_shows - List all configured show slugs
# Install dev dependencies
uv sync --group dev
# Run tests
pytest
# Type check
mypy src/podhome_mcp
# Lint
ruff check src/podhome_mcpCreate a clip (soundbite) from an episode.
Args: show: One of the slugs configured in PODHOME_SHOWS episode_id: ID of the episode to clip title: Title of the clip start_time: Start time in seconds (can be fractional) duration: Duration in seconds (can be fractional)
Inputs: show (required), episode_id (required), title (required), start_time (required), +1 more. Returns: result
Create a new episode for a specific show.
Args: show: One of the slugs configured in PODHOME_SHOWS (e.g., "my-main-podcast") file_url: Publicly accessible URL to the media file title: Episode title description: Optional episode description (can contain HTML) link: Optional canonical link for the episode publish_date: UTC ISO-8601 future date to schedule publishing use_podhome_ai: Run Podhome AI to generate transcript and artifacts suggest_chapters: Generate chapters (requires use_podhome_ai=true) suggest_details: Generate description and title suggestions suggest_clips: Generate clips (requires use_podhome_ai=true) enhance_audio: Run audio enhancement (paid feature)
Inputs: show (required), file_url (required), title (required), description, +7 more. Returns: result
Delete a webhook.
Args: show: One of the slugs configured in PODHOME_SHOWS integration_id: The ID of the webhook to delete
Inputs: show (required), integration_id (required). Returns: result
List episodes for a specific show.
Args: show: One of the slugs configured in PODHOME_SHOWS status: Optional status filter (0-5) include_transcript: Include transcript in response include_chapters: Include chapters in response include_downloads: Include download counts include_people: Include people in response
Inputs: show (required), status, include_transcript, include_chapters, +2 more. Returns: result
List all configured Podhome show slugs.
Inputs: no named parameters. Returns: result
List all registered webhooks for a specific show.
Args: show: One of the slugs configured in PODHOME_SHOWS
Inputs: show (required). Returns: result
Modify an episode's metadata.
Args: show: One of the slugs configured in PODHOME_SHOWS episode_id: ID of the episode to modify title: New episode title description: New description (can contain HTML) episode_nr: Episode number season_nr: Season number image_url: Image URL image_data: Base64 encoded image data
Inputs: show (required), episode_id (required), title, description, +4 more. Returns: result
Register a new webhook.
Args: show: One of the slugs configured in PODHOME_SHOWS url: Webhook endpoint URL action_type: Action type - "episode_published" or "episode_live"
Inputs: show (required), url (required), action_type (required). Returns: result
Schedule or publish an episode.
Args: show: One of the slugs configured in PODHOME_SHOWS episode_id: The ID of the episode to schedule publish_now: Publish immediately publish_date: Future UTC ISO-8601 publish date
Inputs: show (required), episode_id (required), publish_now, publish_date. Returns: result
Test webhooks. Your webhook is called with data from the latest published or live episode.
Args: show: One of the slugs configured in PODHOME_SHOWS integration_id: Optional specific webhook ID to test
Inputs: show (required), integration_id. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Each tool has a clearly distinct purpose targeting specific resources and actions: create_clip, create_episode, delete_webhook, list_episodes, list_shows, list_webhooks, modify_episode, register_webhook, schedule_episode, and test_webhook. There is no overlap in functionality, making tool selection unambiguous for an agent.
All tool names follow a consistent verb_noun pattern (e.g., create_clip, list_episodes, modify_episode) with clear, descriptive verbs and nouns. There are no deviations in naming conventions, making the set predictable and easy to understand.
With 10 tools, the count is well-scoped for podcast management, covering key operations like episode and clip creation, listing, modification, scheduling, and webhook handling. Each tool serves a distinct and necessary function without redundancy or bloat.
The tool set provides comprehensive coverage for podcast management, including CRUD operations for episodes and webhooks, plus scheduling and AI features. A minor gap is the lack of a delete_episode tool, but agents can work around this using modify_episode or other methods, and core workflows are well-supported.
An MCP server that provides tools to discover and retrieve podcast episodes transcripts.
Manage Podhome podcasts: episodes, chapters, transcripts, clips, people and analytics.
Podcast booking-intelligence MCP server: search shows, match profiles, draft pitches, read replies.
PostHero MCP server — schedule and publish social media posts from any MCP-compatible AI tool
