Exposes episode creation and series management as MCP tools so Claude Code can create episodes conversationally — with dynamic directions, quality feedback loops, and no batch scripts needed.
Four tools with reasonable naming (verb_noun pattern) and present descriptions, but significant gaps in schema completeness and parameter documentation. create_series and create_character have detailed input schemas with descriptions, but list_series and get_series lack visible input validation. Output schemas are not documented. Descriptions are adequate (100-200 chars) but lack dependency hints and recovery guidance. No error handling patterns visible. Tool composition is reasonable but lacks idempotency guarantees.
Add a character to a series. Call once per character after create_series. Appearance and personality are stored and injected into every image + screenplay prompt.
Create a new drama series in Scenarix. Returns the new series ID. Call this first, then create_character for each character.
Get full state of a series: metadata, characters, active plot threads, pinned threads, last cliffhanger, episode summaries, and series bible. Call this before create_episode to understand the current story state.
List all drama series in Scenarix with their episode count and last cliffhanger.
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., seriesId from create_series response). Agents must guess what fields are returned.
list_series and get_series have empty input schemas ({}). No pagination parameters visible (limit, offset, cursor). Large result sets will blow context window without pagination support.
No error handling guidance. Descriptions lack recovery hints (e.g., 'If series not found, call list_series first'). Agents cannot self-correct on failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
create_series and create_character descriptions lack dependency hints. Users must infer the call order (create_series first, then create_character). Should state: 'Call create_series first, then create_character for each character.'
No idempotency guarantees documented. Agents retry on ambiguous failures, create_series and create_character could produce duplicates if retried. Should declare idempotency or support deduplication keys.