.svg){kind=small}
.svg){kind=small}
DEVELOPER DOCUMENTATION
MCP: Reviewer Feedback and Task Checklists
Local and hosted MCP tools for private reviewer reports, access grants, adaptive checklist authoring, exact previews, and submission review.
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.
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
Section titled “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
Section titled “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
capabilitiesandlist. - 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
Section titled “Visual review”opentrain_job_checklists_preview never silently resolves an unspecified draft revision. Choose one source mode:
draftwithexpectedDraftVersionpublishedwithversionNumberpublished-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
Section titled “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.