# commentary_projects

Authorized domain actions. Supply the selected action's full parameters in input; etag and idempotencyKey are transport controls. Linked source access is independent. Literal bounded uploads are suppo

Canonical: https://commentary.dev/docs/reference/mcp/commentary-projects

Authorized domain actions. Supply the selected action's full parameters in input; etag and idempotencyKey are transport controls. Linked source access is independent. Literal bounded uploads are supported; local filesystem collection/watch requires CLI. Agent reports cannot create human Decisions. Use Interaction tools for human requests and immutable receipts.

## Connect and discover

Connect an authenticated [MCP client](/docs/build/mcp). Call `tools/list` to confirm this tool is available to the current credential. Provider, workspace, and agent grants remain separate access checks.

## Input fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `action` | `"create"` · `"list"` · `"get"` · `"status"` · `"progress_policy_get"` · `"progress_policy_set"` · `"update"` · `"archive"` · `"restore"` · `"complete"` · `"resources_list"` · `"resources_link"` · `"resources_unlink"` · `"relationships_list"` · `"relationships_link"` · `"relationships_unlink"` · `"participants_list"` · `"participants_set"` · `"participants_remove"` · `"references_list"` · `"references_link"` · `"references_unlink"` · `"history"` · `"workspaces_link"` · `"activity"` · `"feedback"` | Yes | Implemented domain action. |
| `input` | object | Yes | Exact action input including path identities. |
| `etag` | string | No | Exact resource ETag for conditional writes. Maximum length: 1024. |
| `idempotencyKey` | string | No | Reuse only for the identical operation intent. Maximum length: 200. |

## Call the tool

Send a `tools/call` request with `name: "commentary_projects"` and an `arguments` object containing the required fields above. Choose an advertised action, then supply the fields required by that action. Do not treat a successful request as human approval or verified execution unless the returned contract explicitly records that fact.

## Errors and recovery

Read the returned error and permission requirements. Refresh stale revisions before conditional writes, retain idempotency keys only for exact retries, and reconnect when a credential has expired.

## Complete input contract

[Download the JSON schema](/docs/reference/mcp/commentary-projects.json) for action-specific unions, nested fields, and validation constraints. This schema is generated from the same released definitions as the MCP endpoint. [Browse tools](/docs/reference/mcp-operations).