mcp

Attach Article Research

Attach Codex/Claude research to an article job.

Default server mode stores the handoff, writes the first draft with the server article writer, and returns the review URL. Client mode (authoring_mode="client" or server_llm=false) stores the handoff and returns a no-server-LLM drafting brief; call this same tool again with base_text_hash and text to commit the client-authored draft.

post/api/mcp/attach_article_research

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

Request body

job_idstring required

The story job ID.

authoring_mode'server' | 'client' nullable

Set to 'client' to store the research and return a no-server-LLM drafting brief, or to commit client-authored Markdown when text is supplied.

server_llmboolean nullable

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

base_text_hashstring nullable

Hash returned by the client drafting brief; required when submitting client-authored text.

textstring nullable

Client-authored full article Markdown to commit 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 article drafts.

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.