mcp

Writer Thinking Endpoint

Show the writer's approach before applying a chapter revision.

Direct MCP form of the website's start_chat_operation(kind="writer_thinking"). Returns rendered editorial_summary for human inspection plus compact thinking data that can be passed to revise_chapter.writer_thinking.

Client path (authoring_mode='client' / server_llm=false):

  • without client_thinking: no-LLM brief (contract + prompt + base_plan_hash)
  • with client_thinking + base_plan_hash: commit client approach, no server LLM
post/api/mcp/writer_thinking

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/writer_thinking
  • Auth: none declared

Request body

job_idstring required

The story job ID.

chapterinteger required
planobject nullable

Structured revision plan (short_plan, long_plan, beats) to preview the writer's execution for. Alias of structured_plan.

structured_planobject nullable

Alias accepted for pass-through from revise_chapter. Same shape as plan: {short_plan, long_plan, beats[]}.

target_wordsinteger nullable

Target word count for the write.

modelstring nullable

Model override.

revisioninteger nullable

Base revision (used for the default target word count).

authoring_mode'server' | 'client' nullable

Set to 'client' to return a no-LLM writer-thinking brief or commit client_thinking without server LLM usage.

server_llmboolean nullable

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

client_thinkingobject nullable

Client-authored writer approach/thinking payload to commit in client mode. Same contract as submit_client_writer_approach.approach: require chapter_strategy + segments[]. Alias of client_approach.

client_approachobject nullable

Alias for client_thinking (writer approach payload).

base_plan_hashstring nullable

Hash returned by the no-LLM writer_thinking brief; required when submitting client_thinking so the approach matches the planned beats.

plan_idstring nullable

Optional accepted revision-plan id. When submitting client_thinking, stores the approach on that pending client plan (parity with submit_client_writer_approach).

editorial_summarystring nullable

Optional human-readable approach summary when committing client_thinking.

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_thinking 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.