`fx_template_preview`

Preview an FX template

App-only, provider-free preview of one checked-in opener or outro template using its exact supported details. Returns the canonical renderer HTML without creating media or changing an Episode.

Surface: App-only

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.

App descriptor

{
  "name": "fx_template_preview",
  "title": "Preview an FX template",
  "description": "App-only, provider-free preview of one checked-in opener or outro template using its exact supported details. Returns the canonical renderer HTML without creating media or changing an Episode.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID."
      },
      "template_key": {
        "type": "string",
        "description": "Key from identity_read_project.options.fx_templates."
      },
      "params": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 120
          },
          "subtitle": {
            "type": "string",
            "maxLength": 180
          },
          "accent": {
            "type": "string",
            "pattern": "^#[0-9A-Fa-f]{6}$"
          },
          "sting": {
            "type": "string",
            "enum": [
              "none",
              "chime",
              "bass",
              "glitch",
              "shutter"
            ]
          }
        },
        "additionalProperties": false
      },
      "aspect_ratio": {
        "type": "string",
        "enum": [
          "9:16",
          "16:9",
          "1:1"
        ]
      }
    },
    "required": [
      "project_id",
      "template_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "app"
      ]
    },
    "openai/widgetAccessible": true,
    "openai/visibility": "private"
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "schema": {
        "type": "string"
      },
      "project_id": {
        "type": "string"
      },
      "template": {
        "type": "object"
      },
      "aspect_ratio": {
        "type": "string"
      },
      "canvas": {
        "type": "object"
      },
      "html": {
        "type": "string"
      },
      "receipt": {
        "type": "object"
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "project_not_found",
  "invalid_input"
]

Examples

[]