---
title: "Read Story"
method: POST
path: "/api/mcp/read_story"
tags: ["mcp"]
---

# Read Story

`POST /api/mcp/read_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/read_story`
- Auth: none declared

Read exact text by address: a chapter + 0-based paragraph range
(latest revision). Omit `para_end` for the rest of the chapter. Returns
`{job_id, chapter, para_start, para_end, text, total_paras}`.

## Request body

- ReadStoryInput
  - `job_id` string, required: The story job id.
  - `chapter` integer, required: 1-based chapter number.
  - `para_start` integer: 0-based first paragraph (inclusive).
  - `para_end` integer, nullable: 0-based last paragraph (inclusive); omit for end of chapter.

## Response `200`

Successful Response

- ReadStoryResponse
  - `job_id` string, nullable
  - `text` string, nullable
  - `chapters` object[], nullable
  - `spans` unknown[], nullable
    - unknown

## 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)