# PodHome MCP Server
MCP server for the Podhome Integration API with multi-show support.
## Installation
```bash
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:
```bash
export PODHOME_SHOWS='{"my-main-podcast": "phk_abc123...", "weekly-tech-show": "phk_xyz789..."}'
```
## Usage
```bash
uv run podhome-mcp
```
The server runs over stdio and is designed to be used with an MCP client like OpenClaw.
## OpenClaw Registration
```json
{
"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
```bash
# Install dev dependencies
uv sync --group dev
# Run tests
pytest
# Type check
mypy src/podhome_mcp
# Lint
ruff check src/podhome_mcp
```
