# account_context_set

Canonical HTML page: https://bitterclip.com/docs/assistants/tools/account_context_set

Surface: default model and app

Product release: 1dce717408a55fac1047e7d779177fa3ef8ede51
Public contract commit: 1ce47f7857ae3d9b6933fe83d5c33de3ae5efc64
Public contract SHA-256: 241d47d25e4b4c1dae9d2263793874d06fc4ba7bc3c78d4cf2bc63fbb32ed7dc
Descriptor SHA-256: 885d46f3ca3939dec2ace0cd6e93611c8b3f741f2d8f7a82e0adfe1452cc9a9e
Captured: 2026-09-24T16:39:30.100Z
Source: https://app.bitterclip.com/api/v1/mcp_descriptors.json

Confirm the OWNER's optional studio-wide working context — one bounded paragraph of standing context that spans Projects. OWNER-ONLY: it fails closed as not-found for guests and non-owner members. It is WEAKER than Project direction: a confirmed Project working brief always wins, and the person's explicit request wins over both. Use it only when the owner explicitly states or corrects studio-level standing context — NEVER infer it from conversation history; it replaces the whole context, so carry forward anything still current. Read the current context first (account_context_get) and pass that exact revision as expected_revision (0 when none exists); a stale revision fails without overwriting. Retrying the exact same confirmation with the same idempotency_key replays as a no-op, even after a later confirmation; the same key with different text fails closed. Pass an empty context to clear it. Confirming never touches sibling account settings, never changes any Project's working brief or direction, and causes no Program edit, Clip, Render, media, publication, or public-link effect.

The JSON blocks below are the exact MCP descriptor projections served by Rails for the named profiles at capture time. Security schemes and resource URIs may vary by connected host.

## Default model descriptor

```json
{
  "name": "account_context_set",
  "title": "Confirm the studio working context",
  "description": "Confirm the OWNER's optional studio-wide working context — one bounded paragraph of standing context that spans Projects. OWNER-ONLY: it fails closed as not-found for guests and non-owner members. It is WEAKER than Project direction: a confirmed Project working brief always wins, and the person's explicit request wins over both. Use it only when the owner explicitly states or corrects studio-level standing context — NEVER infer it from conversation history; it replaces the whole context, so carry forward anything still current. Read the current context first (account_context_get) and pass that exact revision as expected_revision (0 when none exists); a stale revision fails without overwriting. Retrying the exact same confirmation with the same idempotency_key replays as a no-op, even after a later confirmation; the same key with different text fails closed. Pass an empty context to clear it. Confirming never touches sibling account settings, never changes any Project's working brief or direction, and causes no Program edit, Clip, Render, media, publication, or public-link effect.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "brief": {
        "type": "string",
        "maxLength": 1000,
        "description": "The complete working context text to confirm — it replaces the current context. An empty string clears it. Limited to 1000 characters."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "description": "The current working-context revision from a fresh account_context_get. Pass 0 when no context has been confirmed yet."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for an exact safe retry of this one confirmation."
      }
    },
    "required": [
      "brief",
      "expected_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}
```

## App descriptor

```json
{
  "name": "account_context_set",
  "title": "Confirm the studio working context",
  "description": "Confirm the OWNER's optional studio-wide working context — one bounded paragraph of standing context that spans Projects. OWNER-ONLY: it fails closed as not-found for guests and non-owner members. It is WEAKER than Project direction: a confirmed Project working brief always wins, and the person's explicit request wins over both. Use it only when the owner explicitly states or corrects studio-level standing context — NEVER infer it from conversation history; it replaces the whole context, so carry forward anything still current. Read the current context first (account_context_get) and pass that exact revision as expected_revision (0 when none exists); a stale revision fails without overwriting. Retrying the exact same confirmation with the same idempotency_key replays as a no-op, even after a later confirmation; the same key with different text fails closed. Pass an empty context to clear it. Confirming never touches sibling account settings, never changes any Project's working brief or direction, and causes no Program edit, Clip, Render, media, publication, or public-link effect.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "brief": {
        "type": "string",
        "maxLength": 1000,
        "description": "The complete working context text to confirm — it replaces the current context. An empty string clears it. Limited to 1000 characters."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "description": "The current working-context revision from a fresh account_context_get. Pass 0 when no context has been confirmed yet."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for an exact safe retry of this one confirmation."
      }
    },
    "required": [
      "brief",
      "expected_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "schema": {
        "type": "string"
      },
      "account_id": {
        "type": "string"
      },
      "brief": {
        "type": "string",
        "description": "The exact current confirmed context text after this call."
      },
      "revision": {
        "type": "integer",
        "description": "The current monotonic context revision."
      },
      "confirmed_by_public_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "confirmed_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "already_applied": {
        "type": "boolean",
        "description": "true when this exact confirmation had already been applied and nothing changed."
      },
      "applied_revision": {
        "type": "integer",
        "description": "The revision this confirmation originally produced; equals revision unless a later confirmation superseded it."
      }
    },
    "required": [],
    "additionalProperties": false
  }
}
```

## Live Workspace descriptor

```json
{
  "name": "account_context_set",
  "title": "Confirm the studio working context",
  "description": "Confirm the OWNER's optional studio-wide working context — one bounded paragraph of standing context that spans Projects. OWNER-ONLY: it fails closed as not-found for guests and non-owner members. It is WEAKER than Project direction: a confirmed Project working brief always wins, and the person's explicit request wins over both. Use it only when the owner explicitly states or corrects studio-level standing context — NEVER infer it from conversation history; it replaces the whole context, so carry forward anything still current. Read the current context first (account_context_get) and pass that exact revision as expected_revision (0 when none exists); a stale revision fails without overwriting. Retrying the exact same confirmation with the same idempotency_key replays as a no-op, even after a later confirmation; the same key with different text fails closed. Pass an empty context to clear it. Confirming never touches sibling account settings, never changes any Project's working brief or direction, and causes no Program edit, Clip, Render, media, publication, or public-link effect.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "brief": {
        "type": "string",
        "maxLength": 1000,
        "description": "The complete working context text to confirm — it replaces the current context. An empty string clears it. Limited to 1000 characters."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "description": "The current working-context revision from a fresh account_context_get. Pass 0 when no context has been confirmed yet."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for an exact safe retry of this one confirmation."
      }
    },
    "required": [
      "brief",
      "expected_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "schema": {
        "type": "string"
      },
      "account_id": {
        "type": "string"
      },
      "brief": {
        "type": "string",
        "description": "The exact current confirmed context text after this call."
      },
      "revision": {
        "type": "integer",
        "description": "The current monotonic context revision."
      },
      "confirmed_by_public_id": {
        "type": [
          "string",
          "null"
        ]
      },
      "confirmed_at": {
        "type": [
          "string",
          "null"
        ]
      },
      "already_applied": {
        "type": "boolean",
        "description": "true when this exact confirmation had already been applied and nothing changed."
      },
      "applied_revision": {
        "type": "integer",
        "description": "The revision this confirmation originally produced; equals revision unless a later confirmation superseded it."
      }
    },
    "required": [],
    "additionalProperties": false
  }
}
```

## Errors

```json
[
  "account_not_found",
  "stale_context_revision",
  "idempotency_conflict",
  "invalid_input"
]
```

## Examples

```json
[
  {
    "label": "Set optional studio-wide standing context",
    "input": {
      "brief": "Two-person dev studio. Audience: technical founders. Keep cuts dense and unhyped.",
      "expected_revision": 0,
      "idempotency_key": "context-2026-08-14-a"
    }
  }
]
```