Reply to a record
create_replyAnswer an existing packet by creating a new linked reply, leaving the original untouched. Supports question, clarification, objection, counter-decision, and confirmation types.
Instructions
Use to answer a specific packet — question, clarification, counter-decision, objection, or confirmation — instead of editing it; the reply is written as a new packet linked back to the parent, and the parent is never modified. parentId must match exactly one record in the store, and the reply is written privately whenever the parent is private or seed, or private is set.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| refs | No | Project-relative paths to reference without copying; each is recorded as a file source link. | |
| tags | No | Lowercase slug tags (a-z, 0-9, hyphen) for later filtering; must be unique. | |
| files | No | Project-relative file paths copied into the reply as artifacts, optionally suffixed with a purpose ('diff.patch:source'). Valid purposes are asset, source, reference, and output, plus common aliases. | |
| title | No | Short title for the reply; defaults to 'Reply to <parent title>'. | |
| toRepo | No | Override the recipient repository; when replying to a received packet this defaults to the parent's origin project. | |
| private | No | When true, write the reply into the private inbox instead of the outbox. Default false; replies to private or seed parents are private regardless. | |
| summary | Yes | The reply itself — the question, correction, or confirmation being sent back. | |
| toAgent | No | Override the recipient agent; by default the reply inherits the parent packet's recipient. | |
| parentId | Yes | Record ID of the packet being replied to; must match exactly one record in the store, private records included. | |
| toPerson | No | Override the recipient person; by default the reply inherits the parent packet's recipient. | |
| actorName | No | Name recorded as the author of this write; defaults to the server's configured actor, or 'mcp-client'. | |
| nextSteps | No | What the recipient should do next; rendered as its own section of the reply. | |
| replyType | Yes | What kind of response this is; recorded on the reply and used by readers to triage it. | |
| sourceLinks | No | Context links to record (kind: file, url, commit, issue, record, command, or repo); file links must resolve inside the project root. |