MCP tools

Tool set 2026-10-14, served at https://adminapi.commspliant.com/mcp. Each tool has a strict input schema. Read tools are annotated read-only. Submit, approval, and delete require confirm: true and are annotated destructive.

ToolAdmin API
get_current_userGET /api/v1/auth/session
list_templates, get_template, create_template/api/v1/templates
list_template_versions, get_template_version/api/v1/templates/{templateId}/versions
create_template_version, update_template_versionversion create and PATCH
get_sample_data, set_sample_data/api/v1/templates/{templateId}/sample-data
list_assets, get_asset, upload_asset/api/v1/assets
submit_for_approvalPOST .../approval
get_approval_statusGET .../approval
decide_approvalPOST .../approval/decision
delete_template_versionDELETE .../versions/{versionId}
preview_pdfPOST /api/v1/render/preview/pdf
create_render_job, get_render_job, get_render_outputs/api/v1/render-jobs
get_template_audit_reportGET /api/v1/templates/{templateId}/audit-report
get_evidence_packGET /api/v1/templates/{templateId}/evidence-pack
list_audit_eventsGET /api/v1/audit-events

update_template_version must send expectedRevision from the latest read. A stale write returns 409 or 412 with currentRevision and does not overwrite the newer letter. Read the version again, reconcile, and retry.

preview_pdf is a draft preview. It is not an evidence record. create_render_job on an approved version is the generation the evidence pack should cite.

get_evidence_pack returns the template audit report, MCP actions, and the complaint, fix, and re-check trail from version reasons and approval decisions.

Errors

StatusCodeWhat the model should do
401Connect the account again
403not_version_authorStop. Only the version author can edit, submit, or delete
403mcp_not_entitledTell the user MCP is not on this plan
403mcp_disabledTell the user an administrator must enable MCP
403mcp_read_onlyDo not retry a write
403mcp_tool_not_allowedUse a tool on the allow-list
403insufficient_scopeThe connection was authorised read-only
409 / 412revision_conflictRead the latest revision and reconcile
429rate_limitedWait for Retry-After