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 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Captured 2026-10-29T03:35:56.855Z. 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"
    }
  }
]