---
title: "Suggest Cover Scenes Route"
method: POST
path: "/api/mcp/suggest_cover_scenes"
tags: ["mcp"]
---

# Suggest Cover Scenes Route

`POST /api/mcp/suggest_cover_scenes`

## 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/suggest_cover_scenes`
- Auth: none declared

Suggest distinct one-line, non-spoiler establishing cover-scene ideas.

Call on open for the first 3 ideas. Call again for MORE options — pass the
already-shown lines in `exclude` and any steer in `message` (and the running
`messages`). Returns `{chapter, scenes: [str], editorial_summary}`.

## Request body

- SuggestCoverScenesInput
  - `job_id` string, required
  - `chapter` integer, required
  - `message` string: Optional user guidance for the next batch of ideas.
  - `messages` object[]: Running cover-chat conversation.
  - `exclude` string[]: Scene lines already shown — propose different ones.
  - `count` integer
  - `model` string, nullable: LLM override for scene ideation.

## Response `200`

Successful Response

- GenericToolResponse: Fallback for tools whose payload is still being tightened.
  - `story_url` string, nullable
  - `article_url` string, nullable
  - `job_id` string, nullable
  - `status` string, nullable
  - `is_terminal` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api.md) · [All operations](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api/revisions/ce5e2a89ab4d?raw)