PodHome Server

MCP server for the Podhome Integration API with multi-show support.

Installation

cd podhome-mcp
uv sync

Configuration

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..."}'

Usage

uv run podhome-mcp

The server runs over stdio and is designed to be used with an MCP client like OpenClaw.

OpenClaw Registration

{
  "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...\"}"
          }
        }
      }
    }
  }
}

Tools

Episodes

• 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

Clips

• create_clip - Create a clip (soundbite) from an episode

Webhooks

• list_webhooks - List all registered webhooks
• register_webhook - Register a new webhook
• delete_webhook - Delete a webhook
• test_webhook - Test webhooks

Utility

• list_shows - List all configured show slugs

Development

# Install dev dependencies
uv sync --group dev

# Run tests
pytest

# Type check
mypy src/podhome_mcp

# Lint
ruff check src/podhome_mcp