mcp

Plan Story

Granular alternative to generate_story — runs the PLANNER ONLY.

Creates a fresh job and kicks off the planner in the background. Settles at status='outlining' with the plan committed; does NOT auto-chain into characterizer or setting research. Use this when you want explicit control over each phase (call generate_cast and regenerate_setting separately afterwards).

For one-shot "give me a complete story foundation" use generate_story.

Returns immediately with {job_id, status: "pending", story_url?}; poll get_job_status / wait_for_status for progress.

post/api/mcp/plan_story

Request

  • Base URL: https://writer.swapp1990.org (the document declares no server; this is the origin it was published from)
  • URL: https://writer.swapp1990.org/api/mcp/plan_story
  • Auth: none declared

Request body

job_idstring nullable

Client-authoring continuation id. Omit to create a new story shell; include when submitting client_plan.

premisestring required

The premise for the new story.

chapter_countinteger required

The number of chapters to outline.

target_words_per_chapterinteger nullable

Target word count per chapter (used by the writer later).

nsfwboolean

Content-rating metadata; does not override client safety policies.

modelstring nullable

Model override (e.g. 'grok-4').

authoring_mode'server' | 'client' nullable

Set to 'client' to use the caller's own model/knowledge; the server returns a skill-equivalent planning brief or commits client_plan without server LLM usage.

server_llmboolean nullable

Set false as an alias for authoring_mode='client'. Do not send model in this mode.

client_planobject nullable

Client-authored story plan to commit through plan_story in client mode.

client_namestring

Client identity for no-LLM provenance.

client_modelstring nullable

Client-side model name for no-LLM provenance. Never used for server API calls.

artifact_versionstring

Version label for submitted client_plan artifacts.

Response

Successful Response

story_urlstring nullable
article_urlstring nullable
job_idstring nullable
statusstring nullable
is_terminalboolean nullable

Changes

No recorded changes to this operation across all 1 revision of this API.