View as Markdown

All MCP tools

account_context_set

Confirm the studio working context

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.

Surface: Default model and app

Product release 1dce717408a55fac1047e7d779177fa3ef8ede51
Public contract commit 1ce47f7857ae3d9b6933fe83d5c33de3ae5efc64
Public contract SHA-256 241d47d25e4b4c1dae9d2263793874d06fc4ba7bc3c78d4cf2bc63fbb32ed7dc
Captured 2026-09-24T16:39:30.100Z. Review or improve this contract on GitHub.

These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.

Default model descriptor

{
  "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

{
  "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

{
  "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

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

Examples

[
  {
    "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"
    }
  }
]