API

The HTTP API is the PodBox origin your agent reads. GET /skill is the setup guide.

Owner routes live under /api/v1. Each one takes a Clerk bearer token.

POST /api/v1/checkout with sku BM1 or BA1 returns a Stripe link. Checkout is not an MCP tool.

GET /api/v1/openapi.json is the route document.

MCP

POST /mcp/v1 is the agent endpoint on that same origin. The agent sends the person's access token.

A 401 response names the protected-resource metadata. The agent signs the person in there and does not ask for a pasted token.

The tools are cancel_subscription, balance, retention, set_retention, update_show, set_cover, rotate_feed, feed_url, hold_episode, complete_episode, update_episode, delete_episode, create_speech_episode, list_speech_presets, and read_episode.

When a tool fails, the response includes next. The agent follows next. Usage, billing, and checkout stay on HTTP. They are not tools.