Fountain

What each part of Fountain does, and what to ask your agent. Start with Getting Started, then read the guides you need.

• Getting StartedConnect an agent to Fountain, then ask it for what you want in your own words.
• Finding ClipsAsk for clips from an episode and get drafts with the posts already written.
• Styling ClipsSet your captions, overlays and colours once, and every clip uses them.
• Publishing ClipsApprove the drafts you like, render them and post them to your channels.
• Daily GrowthEvery morning, your agent checks the news and drafts clips from episodes that match.

37 endpoints across 6 groups, for building against Fountain directly.

• Project7 endpointsYour API project: credits, feeds and shows, preferences, email reports
• Content4 endpointsLoad shows, episodes, albums and tracks; load and generate enriched transcripts
• Search3 endpointsSearch across Fountain: content, transcripts, and Nostr profiles
• Publishing12 endpointsHost podcasts on Fountain: manage feeds and items. A feed/item is the internal representation of a public show/episode.
• Uploads3 endpointsUpload media; shared by the Publishing and Social APIs.
• Social8 endpointsConnect social channels and publish posts to them.

The 29 data structures the API returns, grouped the same way the endpoints are.

• Project1 modelYour API project and what it is connected to.
• Content4 modelsShows, episodes and their transcripts.
• Search1 modelSearch results other than content, such as Nostr profiles.
• Publishing8 modelsThe feeds and items you host, and how they perform.
• Uploads4 modelsMedia files uploaded to Fountain.
• Social10 modelsConnected channels, and the posts published to them.
• Shared1 modelTypes used across more than one part of the API.

Every page here has a Markdown twin: add .md to any docs URL, or start from docs.md for the whole reference in one file. Agents connected through Fountain MCP don’t need these files. They are for agents without the connection.