MCP: Reviewer Feedback and Task Checklists

OpenTrain MCP 0.14.0 exposes the complete Reviewer Feedback and adaptive Task Checklist employer workflows in both the local stdio server and the hosted OpenTrain MCP endpoint.

Confirm npm view @opentrain-ai/mcp version reports 0.14.0 or later and call opentrain_capabilities before using these tools. Reviewer Feedback results are employer-private and must never be copied into a worker-visible context.

Every tool returns a compact text block plus machine-readable structuredContent with apiBaseUrl and the exact API result. API failures return isError: true and preserve the HTTP status, code, request ID, and structured details.

Reviewer Feedback tools

Tool	Purpose
`opentrain_job_feedback_settings`	Read the per-job switch even while it is off.
`opentrain_job_feedback_set_enabled`	Enable or disable the feature with explicit confirmation and an idempotency key.
`opentrain_job_feedback_list`	Filter and page employer-private reports with authoritative status counts.
`opentrain_job_feedback_get`	Read one report and its oldest-first append-only event history.
`opentrain_job_feedback_summary`	Read authoritative total, unresolved, status, per-person, and unlinked aggregates.
`opentrain_job_feedback_roster`	Discover canonical subject people and every contract they held.
`opentrain_job_feedback_submit`	Submit one employer-authored report about a canonical subject.
`opentrain_job_feedback_triage`	Change lifecycle status with the exact `updatedAtIso` concurrency token.
`opentrain_job_feedback_link_subject`	Link a legacy unlinked report to one canonical subject, once.
`opentrain_job_feedback_access_list`	List active-contract reviewer candidates and grant state.
`opentrain_job_feedback_access_set`	Grant or revoke one reviewer.
`opentrain_job_feedback_access_bulk`	Grant or revoke up to 200 reviewers transactionally.

Start with settings, then enable and configure reviewer access. Use roster for the canonical subjectUserId and optional subjectContractId before submitting employer feedback. A suggested action is only a recommendation; it never performs a warning, retraining assignment, or offboarding automatically. Every feedback mutation takes an explicit idempotencyKey. triage also requires the report’s latest updatedAtIso; refresh with get after a 409 rather than blind-retrying.

Task Checklist tools

Tool	Purpose
`opentrain_job_checklists_capabilities`	Read live operations, schema limits, and optional job state.
`opentrain_job_checklists_list`	List ordered definitions and the per-job enabled state.
`opentrain_job_checklists_get`	Read one employer builder draft, versions, validation issues, and publish impact.
`opentrain_job_checklists_create`	Create one complete draft atomically.
`opentrain_job_checklists_manage`	Update the draft with CAS, retire it, or restore it.
`opentrain_job_checklists_validate`	Validate an inline local bundle or a stored draft/published tree without writing.
`opentrain_job_checklists_resolve`	Resolve sample raw answers, branches, repeated blocks, validity, and progress without storing.
`opentrain_job_checklists_preview`	Mint a browser URL bound to an exact draft or immutable published revision.
`opentrain_job_checklists_publish`	Publish an immutable version with draft/live revision guards and explicit confirmation.
`opentrain_job_checklists_reorder`	Reorder the complete definition set using a compare-and-set precondition.
`opentrain_job_checklists_versions`	List immutable versions or read one exact version.
`opentrain_job_checklists_submissions`	List filtered submission rows or read one version-pinned result.
`opentrain_job_checklists_set_enabled`	Enable worker visibility, or disable it with explicit confirmation.

Checklist authoring works while the job feature is off. Follow this order:

Call capabilities and list.
Validate the complete proposed title, required mode, and typed tree inline.
Create a complete draft, or get and CAS-update an existing draft.
Resolve representative answers for every branch and repeat count.
Mint and open an exact-revision preview URL in an authenticated browser.
Publish with the expected draft revision, expected live version, and confirmPublish: true.
Re-read the canonical definition and inspect the applied impact and sweep counts.
Enable the job only after every published definition is ready.

Visual review

opentrain_job_checklists_preview never silently resolves an unspecified draft revision. Choose one source mode:

draft with expectedDraftVersion
published with versionNumber
published-latest, which resolves once and reports the immutable version it bound

The returned previewUrl contains a short-lived capability in its fragment. Open the URL directly; the page exchanges the capability in a request body and strips the fragment from browser history. The response also reports the exact content hash and expiration time.

Submission privacy

Checklist submission detail includes the submitted version’s title, tree, required mode, and active valid answers. Hidden, orphaned, and stale answer paths appear only as inactive audit metadata; their raw values and hashes are not returned. Reviewer Feedback has a stronger boundary: only the employer side can call its tools. The reported AI trainer never receives the report, author, severity, suggested action, notes, event history, or aggregate counts through MCP.

HTTP reference

Exact REST paths, schemas, examples, and error recovery.

CLI reference

File-first checklist authoring and employer report management from a shell.

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

MCP: Reviewer Feedback and Task Checklists

Reviewer Feedback tools

Task Checklist tools

Visual review

Submission privacy

HTTP reference

CLI reference

​Reviewer Feedback tools

​Task Checklist tools

​Visual review

​Submission privacy

​Related

HTTP reference

CLI reference

Reviewer Feedback tools

Task Checklist tools

Visual review

Submission privacy

Related