MCP / Tools / Story Workflows / genre_contract

genre_contract

writebetaauth: project:writeapproval: suggeststatus: v1

Apply the selected Genre Movie contract. Read and preview using genre_contract_query.

When to use

Apply the selected Genre Movie contract. Read and preview using genre_contract_query.

When not to use

Do not use for direct card text edits after cards are active; use story/card mutation tools for field-level edits.
Do not use for non-Genre Movie templates.

Examples

“Use genre_contract operation=apply for project 123.”

Anti-examples

Change dialogue in scene 5.
Generate a screenplay from an outline.

Backend capabilities

genre.contract

Linked resources

Tool calls may return resource_links pointing at these resource families.

project_canon_summary

Input schema

genre_contract input

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "operation",
    "project_id"
  ],
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "apply"
      ]
    },
    "project_id": {
      "type": "integer"
    },
    "primary_genre_id": {
      "type": "string"
    },
    "secondary_genre_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 3
    },
    "enabled_card_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disabled_card_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "enabled_local_card_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disabled_local_card_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "card_order_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "enabled_overlay_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "disabled_overlay_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "if_match_updated_at": {
      "type": "string",
      "description": "Reserved for optimistic concurrency. Genre contract apply currently validates through backend project access."
    }
  },
  "allOf": [
    {
      "if": {
        "properties": {
          "operation": {
            "enum": [
              "preview",
              "apply"
            ]
          }
        }
      },
      "then": {
        "required": [
          "primary_genre_id"
        ]
      }
    }
  ],
  "additionalProperties": false
}

Output schema

genre_contract output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "operation",
    "project_id",
    "result",
    "genre_contract_updated_at"
  ],
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "apply"
      ]
    },
    "project_id": {
      "type": "integer"
    },
    "genre_contract_updated_at": {
      "type": [
        "string",
        "null"
      ],
      "description": "Updated-at value for the genre contract if available."
    },
    "result": {
      "type": "object"
    }
  },
  "additionalProperties": true
}