Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PODHOME_SHOWS | Yes | JSON string mapping show slugs to API keys. Example: {"my-main-podcast": "phk_abc123...", "weekly-tech-show": "phk_xyz789..."} | |
| PODHOME_BASE_URL | No | Base URL for the API (default: https://serve.podhome.fm) | https://serve.podhome.fm |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_shows | List all configured Podhome show slugs. |
| create_episode | 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) |
| list_episodes | 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 |
| schedule_episode | 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 |
| modify_episode | 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 |
| create_clip | Create 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) |
| list_webhooks | List all registered webhooks for a specific show. Args: show: One of the slugs configured in PODHOME_SHOWS |
| register_webhook | 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" |
| delete_webhook | Delete a webhook. Args: show: One of the slugs configured in PODHOME_SHOWS integration_id: The ID of the webhook to delete |
| test_webhook | 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 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |