View as Markdown

Default model tools

project_brief_set

Confirm the Project working brief

Confirms the Project's working brief: the durable steering text every host and ingest synthesis reads for this Project (what to make, tone, audience, what to avoid). It is standing direction for Project work; the person's explicit current request takes precedence over it. It records standing direction for the Project as a whole as the person states or corrects it, and each confirmation replaces the whole brief. Requires the current brief revision as expected_revision (0 when no brief exists yet); episode_read on an Episode in the Project renders the exact current PROJECT WORKING BRIEF block with its revision; a stale revision fails without overwriting a newer confirmation. 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. An empty brief clears steering. Confirming never touches sibling direction settings such as canonical vocabulary or copy preferences, and causes no Program edit, Clip, Render, publication, or public-link effect. Episode metadata is episode_update, and channel/package copy is publish_prepare / publish_update.

Surface: Default model and app

Product release eb8538f4a297f331d0399351c1e175bffcd212d2
Public contract commit 20688e11af473a363145ed880d5019c90a7ec1e2
Public contract SHA-256 87a94b85a84dc19245fc03f9b544c70d64bd9f5e08585dcccb38157cace5700d
Captured 2026-10-04T11:55:45.577Z. 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": "project_brief_set",
  "title": "Confirm the Project working brief",
  "description": "Confirms the Project's working brief: the durable steering text every host and ingest synthesis reads for this Project (what to make, tone, audience, what to avoid). It is standing direction for Project work; the person's explicit current request takes precedence over it. It records standing direction for the Project as a whole as the person states or corrects it, and each confirmation replaces the whole brief. Requires the current brief revision as expected_revision (0 when no brief exists yet); episode_read on an Episode in the Project renders the exact current PROJECT WORKING BRIEF block with its revision; a stale revision fails without overwriting a newer confirmation. 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. An empty brief clears steering. Confirming never touches sibling direction settings such as canonical vocabulary or copy preferences, and causes no Program edit, Clip, Render, publication, or public-link effect. Episode metadata is episode_update, and channel/package copy is publish_prepare / publish_update.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID (show_...) or UUID from projects_list / episode_read."
      },
      "brief": {
        "type": "string",
        "maxLength": 2000,
        "description": "The complete working brief text to confirm — it replaces the current brief. An empty string clears steering. Limited to 2000 characters."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "description": "The current working-brief revision from a fresh episode_read (its PROJECT WORKING BRIEF block states the revision). 0 for a Project with no confirmed brief yet."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for an exact safe retry of this one confirmation."
      }
    },
    "required": [
      "project_id",
      "brief",
      "expected_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Confirm the Project working brief",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}

App descriptor

{
  "name": "project_brief_set",
  "title": "Confirm the Project working brief",
  "description": "Confirms the Project's working brief: the durable steering text every host and ingest synthesis reads for this Project (what to make, tone, audience, what to avoid). It is standing direction for Project work; the person's explicit current request takes precedence over it. It records standing direction for the Project as a whole as the person states or corrects it, and each confirmation replaces the whole brief. Requires the current brief revision as expected_revision (0 when no brief exists yet); episode_read on an Episode in the Project renders the exact current PROJECT WORKING BRIEF block with its revision; a stale revision fails without overwriting a newer confirmation. 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. An empty brief clears steering. Confirming never touches sibling direction settings such as canonical vocabulary or copy preferences, and causes no Program edit, Clip, Render, publication, or public-link effect. Episode metadata is episode_update, and channel/package copy is publish_prepare / publish_update.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID (show_...) or UUID from projects_list / episode_read."
      },
      "brief": {
        "type": "string",
        "maxLength": 2000,
        "description": "The complete working brief text to confirm — it replaces the current brief. An empty string clears steering. Limited to 2000 characters."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "description": "The current working-brief revision from a fresh episode_read (its PROJECT WORKING BRIEF block states the revision). 0 for a Project with no confirmed brief yet."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for an exact safe retry of this one confirmation."
      }
    },
    "required": [
      "project_id",
      "brief",
      "expected_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Confirm the Project working brief",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "schema": {
        "type": "string"
      },
      "project_id": {
        "type": "string"
      },
      "brief": {
        "type": "string",
        "description": "The exact current confirmed brief after this call."
      },
      "revision": {
        "type": "integer",
        "description": "The current monotonic brief 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": "project_brief_set",
  "title": "Confirm the Project working brief",
  "description": "Confirms the Project's working brief: the durable steering text every host and ingest synthesis reads for this Project (what to make, tone, audience, what to avoid). It is standing direction for Project work; the person's explicit current request takes precedence over it. It records standing direction for the Project as a whole as the person states or corrects it, and each confirmation replaces the whole brief. Requires the current brief revision as expected_revision (0 when no brief exists yet); episode_read on an Episode in the Project renders the exact current PROJECT WORKING BRIEF block with its revision; a stale revision fails without overwriting a newer confirmation. 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. An empty brief clears steering. Confirming never touches sibling direction settings such as canonical vocabulary or copy preferences, and causes no Program edit, Clip, Render, publication, or public-link effect. Episode metadata is episode_update, and channel/package copy is publish_prepare / publish_update.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID (show_...) or UUID from projects_list / episode_read."
      },
      "brief": {
        "type": "string",
        "maxLength": 2000,
        "description": "The complete working brief text to confirm — it replaces the current brief. An empty string clears steering. Limited to 2000 characters."
      },
      "expected_revision": {
        "type": "integer",
        "minimum": 0,
        "description": "The current working-brief revision from a fresh episode_read (its PROJECT WORKING BRIEF block states the revision). 0 for a Project with no confirmed brief yet."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for an exact safe retry of this one confirmation."
      }
    },
    "required": [
      "project_id",
      "brief",
      "expected_revision",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Confirm the Project working brief",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "schema": {
        "type": "string"
      },
      "project_id": {
        "type": "string"
      },
      "brief": {
        "type": "string",
        "description": "The exact current confirmed brief after this call."
      },
      "revision": {
        "type": "integer",
        "description": "The current monotonic brief 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

[
  "project_not_found",
  "stale_brief_revision",
  "idempotency_conflict",
  "invalid_input"
]

Examples

[
  {
    "label": "Set standing direction for a Project",
    "input": {
      "project_id": "show_...",
      "brief": "Audience: prospective customers. Tone: direct, no hype. Prefer moments showing the product working.",
      "expected_revision": 0,
      "idempotency_key": "brief-2026-08-13-a"
    }
  }
]