Propose a series
Propose a SERIES for the brand: posts, an article and/or short 9:16 videos on one topic, with one shared design kit.
POST /api/v1/propose_series · MCP tool propose_series · scope drafts + spend
Propose a SERIES for the brand: posts, an article and/or short 9:16 videos on one topic, with one shared design kit. Returns 3 options (design kit, real preview videos from the example library, cost estimate per episode and for the whole series, the $3 per-video cap and the brand's cap) and saves the top option (or kitId) as a PROPOSED series with every episode drafted and cross-linked ('Part N of M', UTM). Generates no video and publishes nothing. A human approves the whole series once in the app. Send your own `episodes` to skip GSE's drafting call. Pass `templateId` (list_media_options kind 'format') to make it like one of the 9 reference formats: its beats, pacing, captions and look, some with a three.js accent (no extra provider cost).
Scope. Save drafts, articles and series proposals to the Inbox, and withdraw your own drafts. Nothing publishes. Every call costs credits, so the key also needs spend.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
topic | string | Yes | What the series is about. |
niche | string | Yes | The brand's niche, e.g. 'developer tools'. |
brandType | string | No | e.g. saas, creator, local clinic. |
mix | object | No | How many of each kind. Default: 5 videos. |
platforms | string[] | No | Platform ids from get_capabilities. |
tier | "lean" | "standard" | "premium" | No | lean = voice + motion design; standard/premium add AI b-roll. |
kitId | "terminal-dev" | "bold-kinetic" | "clean-explainer" | No | Design kit; omitted = the best-ranked option. |
episodes | object[] | No | Your own drafts, one per episode in mix order. Omitted = GSE drafts them (costs model credits). |
title | string | No | |
stem | string | No | Locked caption stem shown on every episode. |
siteUrl | string | No | Brand page every episode links to (UTM added per part). |
networks | object[] | No | Your own reason per network, one sentence each, shown to the person on the series page. Omitted = GSE proposes every connected network that takes the part kinds. |
videoLength | "standard" | "short" | No | Video script length when GSE drafts: standard ≈ 45 s (default), short ≈ 15 s (under ~300 characters of voice). |
templateId | "x-in-100-seconds" | "build-x-in-60s" | "build-your-own-x" | "revenue-number-story" | "day-n-challenge" | "test-you-can-do-now" | "please-dont-get-x" | "before-after" | "locked-numbered-series" | No | 'Make it like this': one of the 9 reference formats (structure, pacing, captions, visual style; some add a three.js accent). See list_media_options kind 'format'. Omitted = the agent picks the format. |
Request
curl -X POST https://growsocialelion.com/api/v1/propose_series \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"topic":"string","niche":"string"}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"reason": "string",
"seriesId": "string"
}Errors use the shared body. See Errors. The full schema is in the API reference.