---
title: "Agent Stage"
method: POST
path: "/agent/stage"
---

# Agent Stage

`POST /agent/stage`

## Request

- Base URL: `https://api.local-mcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.local-mcp.com/agent/stage`
- Auth: none declared

§5.4: a stage the reader reports for its own messages, under its (instance, epoch).

## Request body

- StageBody: lmcp-api#426: one stage, reported by the reader for its own messages (§5.4).
  - `agent_id` string, required
  - `instance_id` string, uuid, required
  - `epoch` integer, required
  - `wake_state` string, nullable
  - `wake_reason` string, nullable
  - `stage` string, required
  - `message_ids` integer[], required
  - `attempt_id` string, uuid, nullable
  - `token_sha256` string, nullable
  - `detail` string, nullable
  - `cap_id` string, nullable
  - `plan_sha256` string, nullable
  - `steps` integer, nullable
  - `step` integer, nullable
  - `execution_id` string, uuid, nullable
  - `observation_sha256` string, nullable
  - `evidence_kind` string, nullable
  - `evidence_ref` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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