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.
| Tool | Admin API |
|---|---|
get_current_user | GET /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_version | version 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_approval | POST .../approval |
get_approval_status | GET .../approval |
decide_approval | POST .../approval/decision |
delete_template_version | DELETE .../versions/{versionId} |
preview_pdf | POST /api/v1/render/preview/pdf |
create_render_job, get_render_job, get_render_outputs | /api/v1/render-jobs |
get_template_audit_report | GET /api/v1/templates/{templateId}/audit-report |
get_evidence_pack | GET /api/v1/templates/{templateId}/evidence-pack |
list_audit_events | GET /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
| Status | Code | What the model should do |
|---|---|---|
| 401 | Connect the account again | |
| 403 | not_version_author | Stop. Only the version author can edit, submit, or delete |
| 403 | mcp_not_entitled | Tell the user MCP is not on this plan |
| 403 | mcp_disabled | Tell the user an administrator must enable MCP |
| 403 | mcp_read_only | Do not retry a write |
| 403 | mcp_tool_not_allowed | Use a tool on the allow-list |
| 403 | insufficient_scope | The connection was authorised read-only |
| 409 / 412 | revision_conflict | Read the latest revision and reconcile |
| 429 | rate_limited | Wait for Retry-After |