MCP quickstart

Podviva, in your agent's toolbelt.

Claude Desktop, Cursor, Windsurf, or your own MCP host — pick your flavour, paste the config, restart the client. You're holding the reins to a full podcast platform.

Org slug

Anything — this tool generates a placeholder config. Real tokens appear in your Studio's API & MCP page once you sign up.

Preview

org acme-audio
token pv_mcp_htbnrrkq2txcrb6jcyr7uveu

claude_desktop_config.json

{
  "mcpServers": {
    "podviva": {
      "url": "https://podviva.fm/mcp",
      "headers": {
        "authorization": "Bearer pv_mcp_htbnrrkq2txcrb6jcyr7uveu",
        "x-podviva-org": "acme-audio"
      }
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\\Claude\\claude_desktop_config.json (Windows). Restart Claude Desktop after saving.

Once wired, your agent can call

list_showsList every show the caller owns.
create_showSpin up a new show — agent- or human-authored.
create_episodeKick off an episode — agent topic or upload.
get_episodeFetch pipeline + distribution state.
approve_stageResume a paused pipeline stage.
translate_episodeRequest transcripts in a specific language.
publish_episodeFan out to RSS, YouTube, Apple, Spotify, webhooks.

Ready to mint a real token? The Studio generates one, scoped to your org and rotatable at any time. Plain REST works too — same surface, same tokens.

Get a real token