mcp

Plan Chapter

Create or register a versioned initial beat plan for an unwritten chapter.

post/api/mcp/plan_chapter

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_chapter
Auth: none declared

job_idstring required

The story job ID.

chapterinteger required

Unwritten chapter number to plan.

messagestring

Planning instruction for the initial chapter plan.

modelstring nullable

Model override for server-side planning.

target_wordsinteger nullable

Target word count for the future chapter.

authoring_mode'server' | 'client' nullable

Set to 'client' to return a no-LLM planning brief or commit 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.

selectboolean

When storing a plan, make it the selected initial plan consumed by write_chapter.

notesstring[]

Optional comments/notes to attach to this initial chapter plan artifact.

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.

auto_saveboolean

Reserved for future chapter-plan chat persistence. Currently ignored.

request_idstring nullable

Optional idempotency key for clients.

Successful Response

story_urlstring nullable

article_urlstring nullable

job_idstring nullable

statusstring nullable

is_terminalboolean nullable

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