Cannon Studio

Search public Cannon Studio knowledge when a user asks about products, workflows, pricing, models, comparisons, use cases, or developer API docs. Public read-only: no auth, no state changes, no charges; call fetch with a returned id when full source-backed text is needed.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Natural-language query to search Cannon Studio public knowledge."
    },
    "audience": {
      "type": "string",
      "description": "Optional audience/persona filter such as creators, agencies, marketing teams, or developers."
    },
    "category": {
      "type": "string",
      "description": "Optional category filter such as pricing, developer, comparison, model_availability, use_case, tools, or creator_flow."
    },
    "pain_point": {
      "type": "string",
      "description": "Optional pain point filter such as consistent characters, cost predictability, team review, model choice, or finishing."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum number of results. Defaults to 8 and caps at 20."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch one public Cannon Studio knowledge record by id after search. Public read-only: no auth, no state changes, no charges; use search first when you do not already have a record id.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Record id returned by the search tool."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List public Cannon Studio capabilities for an audience, workflow, or output type. Public read-only: no auth, no state changes, no charges; use search or fetch when the user needs deeper source text.

{
  "type": "object",
  "properties": {
    "audience": {
      "type": "string",
      "description": "Optional persona or buyer filter, such as creators, agencies, marketing teams, filmmakers, developers, or teams."
    },
    "workflow": {
      "type": "string",
      "description": "Optional workflow filter, such as UGC ads, Creator Flow, World Generator, API automation, 3D generation, audio, or post-production."
    },
    "output_type": {
      "type": "string",
      "description": "Optional desired output format, such as image, video, 3D model, 3D location, narration, music, subtitles, or lip sync."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string"
    },
    "stats": {
      "type": "object",
      "additionalProperties": {}
    },
    "matches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "summary",
    "stats",
    "matches"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Recommend a Cannon Studio workflow for a stated creative or developer goal. Public read-only: no auth, no state changes, no charges; use this for planning, not to create generation jobs.

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "minLength": 1,
      "description": "User's desired outcome or problem to solve, such as producing UGC ads, planning a short film, generating 3D assets, or automating API media generation."
    },
    "audience": {
      "type": "string",
      "description": "Optional user or organization type, such as solo creator, agency, brand team, developer, filmmaker, or enterprise team."
    },
    "output_type": {
      "type": "string",
      "description": "Optional final output target, such as image, video, ad, trailer, 3D model, 3D location, audio, subtitles, or API integration."
    },
    "team_size": {
      "type": "string",
      "description": "Optional team context, such as solo, small team, agency team, or enterprise team; used to bias collaboration and review recommendations."
    },
    "budget_sensitivity": {
      "type": "string",
      "description": "Optional cost posture, such as low, medium, high, cost-sensitive, or speed-prioritized; used to frame pricing and iteration tradeoffs."
    }
  },
  "required": [
    "goal"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string"
    },
    "recommendation": {
      "type": "string"
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "goal",
    "recommendation",
    "steps",
    "sources"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare Cannon Studio's fit against named alternatives for a use case. Public read-only: no auth, no state changes, no charges; it returns approved positioning and cautions agents not to invent competitor claims.

{
  "type": "object",
  "properties": {
    "use_case": {
      "type": "string",
      "minLength": 1,
      "description": "Specific job-to-be-done for the comparison, such as UGC ads, AI filmmaking, image generation, 3D workflows, team review, or API media generation."
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional competitor/tool names the user mentioned, such as Runway, LTX Studio, Pika, Midjourney, Higgsfield, or a generic point generator."
    }
  },
  "required": [
    "use_case"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "use_case": {
      "type": "string"
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "positioning": {
      "type": "string"
    },
    "caution": {
      "type": "string"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "use_case",
    "alternatives",
    "positioning",
    "caution",
    "sources"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Explain public Cannon Studio pricing, credits, plans, and usage tradeoffs. Public read-only: no auth, no state changes, no charges; use list_offerings or get_checkout_link only when the user asks for available purchase paths.

{
  "type": "object",
  "properties": {
    "use_case": {
      "type": "string",
      "description": "Optional workload or scenario to price, such as UGC ads, AI video, 3D generation, narration, team workflows, or developer API automation."
    },
    "media_type": {
      "type": "string",
      "description": "Optional media category, such as image, video, 3D, audio, narration, subtitles, lip sync, or post-production."
    },
    "plan": {
      "type": "string",
      "description": "Optional plan or tier name the user mentioned, such as free, hobbyist, creator, pro, team, or enterprise."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string"
    },
    "use_case": {
      "type": [
        "string",
        "null"
      ]
    },
    "media_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "plan": {
      "type": [
        "string",
        "null"
      ]
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "summary",
    "use_case",
    "media_type",
    "plan",
    "sources"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List public Cannon Studio plans, credit packs, and team offerings. Public read-only: no auth, no state changes, no charges; returns first-party checkout or inquiry URLs without creating Stripe sessions or granting credits.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "description": "Optional offering kind filter: free, subscription, credit_pack, or team."
    },
    "interval": {
      "type": "string",
      "description": "Optional subscription interval filter: month or year."
    },
    "include_checkout_links": {
      "type": "boolean",
      "description": "Set false to omit checkout URLs from the response."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "offerings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "priceUsd": {
            "type": [
              "number",
              "null"
            ]
          },
          "interval": {
            "type": [
              "string",
              "null"
            ]
          },
          "credits": {
            "type": [
              "number",
              "null"
            ]
          },
          "checkoutUrl": {
            "type": "string"
          },
          "requiresLogin": {
            "type": "boolean"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "notes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id",
          "kind",
          "label",
          "summary",
          "priceUsd",
          "interval",
          "credits",
          "checkoutUrl",
          "requiresLogin",
          "tags",
          "notes"
        ],
        "additionalProperties": false
      }
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "offerings",
    "notes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the first-party Cannon Studio checkout or inquiry URL for a selected offering. Public read-only: no auth, no state changes, no charges; use list_offerings first to get a valid product_key.

{
  "type": "object",
  "properties": {
    "product_key": {
      "type": "string",
      "minLength": 1,
      "description": "Offering id returned by list_offerings, such as subscription:creator:month or credits:2500."
    }
  },
  "required": [
    "product_key"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "productKey": {
      "type": "string"
    },
    "offering": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "kind": {
          "type": "string"
        },
        "label": {
          "type": "string"
        },
        "summary": {
          "type": "string"
        },
        "priceUsd": {
          "type": [
            "number",
            "null"
          ]
        },
        "interval": {
          "type": [
            "string",
            "null"
          ]
        },
        "credits": {
          "type": [
            "number",
            "null"
          ]
        },
        "checkoutUrl": {
          "type": "string"
        },
        "requiresLogin": {
          "type": "boolean"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "id",
        "kind",
        "label",
        "summary",
        "priceUsd",
        "interval",
        "credits",
        "checkoutUrl",
        "requiresLogin",
        "tags",
        "notes"
      ],
      "additionalProperties": false
    },
    "checkoutUrl": {
      "type": "string"
    },
    "chargeStatus": {
      "type": "string"
    },
    "createsStripeSession": {
      "type": "boolean"
    },
    "nextStep": {
      "type": "string"
    },
    "safety": {
      "type": "string"
    }
  },
  "required": [
    "productKey",
    "offering",
    "checkoutUrl",
    "chargeStatus",
    "createsStripeSession",
    "nextStep",
    "safety"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List public Cannon Studio model availability by product surface. Public read-only: no auth, no state changes, no charges; model availability is surface-specific and does not guarantee account eligibility or remaining credits.

{
  "type": "object",
  "properties": {
    "surface": {
      "type": "string",
      "description": "Optional surface filter, such as image tools, video tools, Creator Flow, World Generator, image-api, video-api, or three-d-api."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "surfaces": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "surfaces",
    "note"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List first-party Cannon Studio image, video, audio, subtitle, editing, Composer, and 3D toolkit surfaces, including which ones are developer-API operations and which should be opened in the app or routed through Director Mode. Public read-only: no auth, no state changes, no charges.

{
  "type": "object",
  "properties": {
    "media_type": {
      "type": "string",
      "description": "Optional media filter such as image, video, audio, subtitles, model3d, script, or timeline."
    },
    "family": {
      "type": "string",
      "description": "Optional toolkit family filter such as image, video, audio, subtitles, editing, motion, composer, script, or 3d."
    },
    "action": {
      "type": "string",
      "description": "Optional action filter such as generate, edit, upscale, trim, stitch, lip_sync, transcribe, or delivery."
    },
    "project_context_only": {
      "type": "boolean",
      "description": "Set true to return only toolkit surfaces that can operate from selected project or Director Mode asset context."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "toolkits": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {}
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "toolkits",
    "note"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return public docs for Cannon Studio developer API operations and payload shapes. Public read-only: no auth, no state changes, no charges; use this before estimate_generation_cost or create_generation_request when operation/input fields are unclear.

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "description": "Optional operation id such as image.generate, video.generate, three_d.model.generate, three_d.location.generate, narration.generate, or subtitles.generate."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "text": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url",
          "summary",
          "text"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "operations"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check authenticated Cannon Studio account/API connectivity before estimating or creating requests. Requires OAuth or a developer API key; may update key/token usage metadata, but does not spend credits, enqueue jobs, change assets, or expose secrets.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "status": {
      "type": "number"
    },
    "response": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "ok",
    "status",
    "response"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Estimate credits for a Cannon Studio generation request before creating billable work. Requires OAuth or a developer API key; it may update key/token usage metadata but does not spend credits, enqueue jobs, or change assets. Use get_api_operation first if operation or input fields are unclear, then pass the same operation/input pair to create_generation_request after user approval.

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "minLength": 1,
      "description": "Cannon Studio developer API operation id to price. Use get_api_operation first if unsure. Examples: image.generate, video.generate, three_d.model.generate, three_d.location.generate, music.generate, narration.generate, subtitles.generate."
    },
    "input": {
      "type": "object",
      "additionalProperties": {},
      "description": "Operation-specific request payload to estimate. Use the exact shape documented by get_api_operation for the selected operation, for example image.generate expects fields like prompt/model/aspect_ratio, video.generate expects prompt/model/duration/aspect_ratio, and three_d.location.generate expects description with optional source_image_urls and angle_context."
    }
  },
  "required": [
    "operation",
    "input"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "status": {
      "type": "number"
    },
    "response": {
      "type": "object",
      "additionalProperties": {}
    },
    "operation": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "estimatedCredits": {
      "type": [
        "number",
        "null"
      ]
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create billable async Cannon Studio generation work only after explicit user approval. Requires OAuth or a developer API key; can spend credits up to max_credits and cannot be cancelled through MCP after submission. Use estimate_generation_cost first, then set confirmed=true and a user-approved max_credits cap. This tool does not create API keys, charge payment methods directly, or delete assets.

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "minLength": 1,
      "description": "Cannon Studio developer API operation id to run. Use get_api_operation first if unsure. Examples: image.generate, video.generate, three_d.model.generate, three_d.location.generate, music.generate, narration.generate, subtitles.generate."
    },
    "input": {
      "type": "object",
      "additionalProperties": {},
      "description": "Operation-specific request payload. Use the exact shape documented by get_api_operation for the selected operation; this is the billable payload that will be submitted if confirmed and within max_credits."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Optional HTTPS URL that Cannon Studio calls when the request reaches a terminal succeeded or failed state. Omit when polling with get_generation_request."
    },
    "idempotency_key": {
      "type": "string",
      "description": "Optional stable retry key for the same operation and payload. Reuse it when retrying after a network/client error; do not generate a new key for the same intended request."
    },
    "confirmed": {
      "type": "boolean",
      "description": "Must be true only after the user explicitly approves this billable generation request, including operation, payload, and max_credits. Missing or false returns a confirmation error and creates no job."
    },
    "max_credits": {
      "type": "number",
      "minimum": 0,
      "description": "Highest credit spend the user explicitly approved for this request. The tool rejects the request when the current estimate is greater than this cap."
    }
  },
  "required": [
    "operation",
    "input"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "status": {
      "type": "number"
    },
    "response": {
      "type": "object",
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "estimatedCredits": {
      "type": "number"
    },
    "maxCredits": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Poll and sync an existing Cannon Studio generation request by id. Requires OAuth or a developer API key; not a pure read because it may update lastPolledAt, sync downstream task state, update logs, and deliver one pending terminal webhook. It does not create work, spend credits, cancel jobs, delete data, or change assets. Poll sparingly using poll_after_ms or 10-30 second intervals.

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "minLength": 1,
      "description": "Cannon Studio request id returned by create_generation_request or POST /api/v1/requests. This is not a provider task id."
    },
    "include_logs": {
      "type": "boolean",
      "description": "Set true only when the user explicitly asks to inspect retained request logs for this request."
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "status": {
      "type": "number"
    },
    "response": {
      "type": "object",
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Discover your owned and shared Creator Flow projects with IDs, roles, direct links, and final videos. May backfill legacy collaboration indexes. Start here when the user mentions their project.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Maximum returned records."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Last returned ID, for the next page."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Inspect an accessible project's saved chapters, scenes, shots, visual readiness, linked media, and scoped assets. Returns a versioned snapshot. Use export_creator_flow_project when the user wants a visual overview or file.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Project ID returned by list_creator_flow_projects."
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a blank Creator Flow project with one scene and shot in an owned world, or a new world when world_id is omitted. This creates draft records only; no generation or credit spend.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "world_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Existing owned world. Omit to create a new world."
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "summary": {
      "type": "string",
      "maxLength": 4000
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Edit an accessible project's title, summary, or visual style. Requires editor access and respects another collaborator's active edit lease. Does not regenerate media.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Project ID returned by list_creator_flow_projects."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "summary": {
      "type": "string",
      "maxLength": 4000
    },
    "visualStyle": {
      "$ref": "#/properties/summary"
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Preview deletion by default. Only the owner can permanently delete the project and its story/collaboration records. Keep dry_run=true until the user approves the stated impact; then set dry_run=false, confirmed=true, and expected_title from the preview. Preserves world/library assets.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Project ID returned by list_creator_flow_projects."
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "Preview deletion impact; defaults to true."
    },
    "confirmed": {
      "type": "boolean",
      "default": false,
      "description": "True only when the user explicitly requested this deletion after seeing its impact."
    },
    "expected_title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Exact current title from the preview. Required when deleting."
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Export a standalone HTML project overview or versioned JSON snapshot as an embedded file resource. Save the resource text verbatim to the returned filename and open the file for the user. HTML shows chapters/scenes/shots, images, videos, audio, missing visuals, search, print/PDF, and JSON download. Media is linked, not bundled, and needs network access. Private export: share only as requested.

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Project ID returned by list_creator_flow_projects."
    },
    "format": {
      "type": "string",
      "enum": [
        "html",
        "json"
      ],
      "default": "html",
      "description": "HTML is a standalone visual overview with a JSON download; JSON is machine-readable project state."
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Page through your owned worlds with titles, descriptions, media, and direct links. Returns a next_cursor when more worlds exist.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Maximum returned records."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Last returned ID, for the next page."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read an owned world's summary and media. Use list_world_assets to inspect its library and list_creator_flow_projects for project discovery.

{
  "type": "object",
  "properties": {
    "world_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "World ID returned by list_worlds."
    }
  },
  "required": [
    "world_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create an owned world with title, description, genre, visual style, lore, and production cues. No media generation or credit spend.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "description": {
      "type": "string",
      "maxLength": 4000
    },
    "genre": {
      "type": "string",
      "maxLength": 120
    },
    "theme": {
      "$ref": "#/properties/description"
    },
    "visualStyle": {
      "$ref": "#/properties/description"
    },
    "importantLore": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 240
      },
      "maxItems": 50
    },
    "videoProductionCues": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 240
      },
      "maxItems": 50
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Update an owned world's descriptive fields. Omitted fields remain unchanged; empty strings/arrays clear optional fields. Does not rewrite existing media.

{
  "type": "object",
  "properties": {
    "world_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "World ID returned by list_worlds."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "description": {
      "type": "string",
      "maxLength": 4000
    },
    "genre": {
      "type": "string",
      "maxLength": 120
    },
    "theme": {
      "$ref": "#/properties/description"
    },
    "visualStyle": {
      "$ref": "#/properties/description"
    },
    "importantLore": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 240
      },
      "maxItems": 50
    },
    "videoProductionCues": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 240
      },
      "maxItems": 50
    }
  },
  "required": [
    "world_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Preview world deletion including its project count. After explicit approval, supply dry_run=false, confirmed=true, expected_title. Deletes world projects/stories/relationships and detaches reusable assets using the app's deletion service.

{
  "type": "object",
  "properties": {
    "world_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "World ID returned by list_worlds."
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "Preview deletion impact; defaults to true."
    },
    "confirmed": {
      "type": "boolean",
      "default": false,
      "description": "True only when the user explicitly requested this deletion after seeing its impact."
    },
    "expected_title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Exact current title from the preview. Required when deleting."
    }
  },
  "required": [
    "world_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Discover asset kinds, then page through owned characters, locations, objects, outfits, abilities, or cameras. Select kind; optionally filter world_id. Returns asset IDs, descriptions, media links, and next_cursor.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Maximum returned records."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600,
      "description": "Last returned ID, for the next page."
    },
    "world_id": {
      "$ref": "#/properties/cursor"
    },
    "kind": {
      "type": "string",
      "enum": [
        "character",
        "location",
        "object",
        "outfit",
        "ability",
        "camera"
      ]
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read one owned library asset's descriptive state and media. Use the kind and world_id from discovery; locations may be world-scoped.

{
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600
    },
    "kind": {
      "type": "string",
      "enum": [
        "character",
        "location",
        "object",
        "outfit",
        "ability",
        "camera"
      ]
    },
    "world_id": {
      "$ref": "#/properties/asset_id"
    }
  },
  "required": [
    "asset_id",
    "kind"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a reusable owned character, location, object, outfit, ability, or camera from descriptive fields and optional existing HTTPS media references. Does not generate or download media and spends no credits.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "description": {
      "type": "string",
      "maxLength": 4000
    },
    "summary": {
      "$ref": "#/properties/description"
    },
    "imageUrl": {
      "type": "string",
      "format": "uri",
      "maxLength": 8192
    },
    "referenceImages": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "maxLength": 8192
      },
      "maxItems": 20
    },
    "notes": {
      "$ref": "#/properties/description"
    },
    "imagePromptAddon": {
      "$ref": "#/properties/description"
    },
    "videoPromptAddon": {
      "$ref": "#/properties/description"
    },
    "kind": {
      "type": "string",
      "enum": [
        "character",
        "location",
        "object",
        "outfit",
        "ability",
        "camera"
      ]
    },
    "world_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600
    }
  },
  "required": [
    "name",
    "kind"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Edit an owned reusable asset's descriptive fields and existing media references using the app's asset service. Does not generate new media.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 180
    },
    "description": {
      "type": "string",
      "maxLength": 4000
    },
    "summary": {
      "$ref": "#/properties/description"
    },
    "imageUrl": {
      "type": "string",
      "format": "uri",
      "maxLength": 8192
    },
    "referenceImages": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "maxLength": 8192
      },
      "maxItems": 20
    },
    "notes": {
      "$ref": "#/properties/description"
    },
    "imagePromptAddon": {
      "$ref": "#/properties/description"
    },
    "videoPromptAddon": {
      "$ref": "#/properties/description"
    },
    "asset_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600
    },
    "kind": {
      "type": "string",
      "enum": [
        "character",
        "location",
        "object",
        "outfit",
        "ability",
        "camera"
      ]
    },
    "world_id": {
      "$ref": "#/properties/asset_id"
    }
  },
  "required": [
    "asset_id",
    "kind"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Preview an owned library asset deletion. Only after explicit approval set dry_run=false, confirmed=true, expected_title. Existing projects may lose references to the deleted asset.

{
  "type": "object",
  "properties": {
    "asset_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600
    },
    "kind": {
      "type": "string",
      "enum": [
        "character",
        "location",
        "object",
        "outfit",
        "ability",
        "camera"
      ]
    },
    "world_id": {
      "$ref": "#/properties/asset_id"
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "Preview deletion impact; defaults to true."
    },
    "confirmed": {
      "type": "boolean",
      "default": false,
      "description": "True only when the user explicitly requested this deletion after seeing its impact."
    },
    "expected_title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Exact current title from the preview. Required when deleting."
    }
  },
  "required": [
    "asset_id",
    "kind"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}