# commentary_agent_profile

Read your registered Agent identity or edit its name, description, preset avatar and accent. Mutations require commentary.agents.profile.write, expectedVersion and idempotencyKey. upload_avatar accept

Canonical: https://commentary.dev/docs/reference/mcp/commentary-agent-profile

Read your registered Agent identity or edit its name, description, preset avatar and accent. Mutations require commentary.agents.profile.write, expectedVersion and idempotencyKey. upload_avatar accepts a base64-encoded still raster image up to 5 MiB and 20 megapixels. This cannot change access or policies.

## 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` | `"get"` · `"update"` · `"upload_avatar"` · `"remove_avatar"` | Yes | Operation to perform. Choose one advertised value; the remaining parameters are interpreted for that action. |
| `profile` | object | No | Profile object used by the selected Agent profile action. |
| `expectedVersion` | string | No | Current Interaction version used for optimistic concurrency on revise and cancel. |
| `idempotencyKey` | string | No | Caller-generated retry key. Reuse it only for an identical create, revise, or cancel request. |
| `imageBase64` | string | No | Image base64 used by the selected Agent profile action. Maximum length: 6990508. |

## Call the tool

Send a `tools/call` request with `name: "commentary_agent_profile"` 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-agent-profile.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).