Practical filming plans for AI assistants. Shot-plan checks are not yet available to customers.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Return truthful Shoot Plan scope, availability, privacy and commercial state.
This tool takes no arguments.
Return truthful Shoot Plan scope, availability, privacy and commercial state.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Create a plan for an authenticated organisation after authoritative payment confirmation.
| Argument | Type | Description |
|---|---|---|
| intake* | any | |
| orderId* | string | The order id, or the customer-facing order reference shown on the website (for example A140A800). |
| idempotencyKey* | string |
{
"type": "object",
"required": [
"orderId",
"intake",
"idempotencyKey"
],
"properties": {
"intake": {
"oneOf": [
{
"type": "object",
"required": [
"title",
"briefText",
"beats",
"safetyAcknowledged"
],
"properties": {
"beats": {
"type": "array",
"items": {
"type": "string",
"maxLength": 240,
"minLength": 3
},
"maxItems": 20,
"minItems": 1
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 3
},
"briefText": {
"type": "string",
"maxLength": 20000,
"minLength": 20
},
"constraints": {
"type": "object",
"properties": {
"lightNotes": {
"type": "string",
"maxLength": 1000
},
"soundNotes": {
"type": "string",
"maxLength": 1000
},
"accessNotes": {
"type": "string",
"maxLength": 1000
},
"safetyNotes": {
"type": "string",
"maxLength": 1000
},
"locationNotes": {
"type": "string",
"maxLength": 1000
},
"mobilityNotes": {
"type": "string",
"maxLength": 1000
},
"availableMinutes": {
"type": "integer",
"maximum": 1440,
"minimum": 15
},
"locationTransferMinutes": {
"type": "integer",
"maximum": 720,
"minimum": 0
}
},
"additionalProperties": false
},
"beatLocations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"maxItems": 20,
"minItems": 1
},
"safetyAcknowledged": {
"const": true
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"intakeVersion",
"title",
"requirements",
"locations",
"beats",
"safetyAcknowledged"
],
"properties": {
"beats": {
"type": "array",
"items": {
"type": "object",
"required": [
"beatId",
"label",
"purpose",
"requirementIds",
"locationId"
],
"properties": {
"label": {
"type": "string",
"maxLength": 120,
"minLength": 3
},
"beatId": {
"type": "string",
"pattern": "^B-[0-9]{2}$"
},
"speech": {
"enum": [
"none",
"on_camera",
"voiceover"
]
},
"purpose": {
"enum": [
"interview_answer",
"voiceover_line",
"process_step",
"result_reveal",
"place_context",
"closing_action",
"live_moment",
"dialogue_exchange"
]
},
"dependsOn": {
"type": "array",
"items": {
"type": "string",
"pattern": "^B-[0-9]{2}$"
},
"maxItems": 19,
"description": "Earlier stages that must finish first. Omit to follow the preceding process/result stage in input order. Use [] only for a genuinely independent or already prepared result.",
"uniqueItems": true
},
"keyDetail": {
"type": "string",
"maxLength": 160,
"minLength": 3
},
"locationId": {
"type": "string",
"pattern": "^L-[0-9]{2}$"
},
"repeatable": {
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether this key moment can be filmed again. When omitted, it is treated as not confirmed repeatable, so it is planned as one take."
},
"actionSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 5
},
"participantIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^P-[0-9]{2}$"
},
"maxItems": 12,
"uniqueItems": true
},
"requirementIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^RQ-[0-9]{2}$"
},
"maxItems": 10,
"minItems": 1,
"uniqueItems": true
},
"eventStartMinute": {
"type": "integer",
"maximum": 1440,
"minimum": 0
},
"continuousMinutes": {
"type": "integer",
"maximum": 480,
"minimum": 1
},
"eventStartFlexible": {
"const": true
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 3
},
"context": {
"type": "string",
"maxLength": 20000,
"description": "Optional private context. Never interpreted or used to change the plan."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"locationId",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"acoustics": {
"enum": [
"quiet",
"noise_controllable",
"noise_fixed",
"unknown"
]
},
"locationId": {
"type": "string",
"pattern": "^L-[0-9]{2}$"
},
"accessWindow": {
"type": "object",
"required": [
"startMinute",
"endMinute"
],
"properties": {
"endMinute": {
"type": "integer",
"maximum": 1440,
"minimum": 1
},
"startMinute": {
"type": "integer",
"maximum": 1440,
"minimum": 0
}
},
"additionalProperties": false
},
"quieterPosition": {
"enum": [
"permitted",
"not_permitted",
"unknown"
]
}
},
"additionalProperties": false
},
"maxItems": 4,
"minItems": 1
},
"resources": {
"type": "object",
"properties": {
"equipment": {
"type": "array",
"items": {
"enum": [
"phone",
"camera",
"tripod",
"gimbal",
"external_microphone",
"lights",
"drone"
]
},
"minItems": 1,
"uniqueItems": true
},
"operators": {
"type": "integer",
"maximum": 4,
"minimum": 1
},
"captureDevices": {
"type": "integer",
"maximum": 4,
"minimum": 1
}
},
"additionalProperties": false
},
"noAiImagery": {
"const": true,
"description": "Legacy compatibility field; omit or send true. The customer films their own material."
},
"participants": {
"type": "array",
"items": {
"type": "object",
"required": [
"participantId",
"label"
],
"properties": {
"label": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"window": {
"type": "object",
"required": [
"startMinute",
"endMinute"
],
"properties": {
"endMinute": {
"type": "integer",
"maximum": 1440,
"minimum": 1
},
"startMinute": {
"type": "integer",
"maximum": 1440,
"minimum": 0
}
},
"additionalProperties": false
},
"participantId": {
"type": "string",
"pattern": "^P-[0-9]{2}$"
}
},
"additionalProperties": false
},
"maxItems": 12
},
"requirements": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirementId",
"text",
"importance"
],
"properties": {
"text": {
"type": "string",
"maxLength": 240,
"minLength": 3
},
"importance": {
"enum": [
"essential",
"useful",
"optional"
]
},
"requirementId": {
"type": "string",
"pattern": "^RQ-[0-9]{2}$"
}
},
"additionalProperties": false
},
"maxItems": 40,
"minItems": 1
},
"intakeVersion": {
"const": 2
},
"ownFootageOnly": {
"const": true,
"description": "Customer films their own material. Same meaning as noAiImagery; omit or send true."
},
"safetyAcknowledged": {
"const": true
},
"planningConstraints": {
"type": "object",
"properties": {
"transfers": {
"type": "array",
"items": {
"type": "object",
"required": [
"fromLocationId",
"toLocationId",
"minutes"
],
"properties": {
"minutes": {
"type": "integer",
"maximum": 720,
"minimum": 0
},
"toLocationId": {
"type": "string"
},
"fromLocationId": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 1
},
"framingLimit": {
"enum": [
"any",
"wide_only"
]
},
"orientations": {
"type": "array",
"items": {
"enum": [
"landscape",
"portrait",
"square"
]
},
"maxItems": 2,
"minItems": 1,
"uniqueItems": true
},
"cameraMovement": {
"enum": [
"free",
"locked_position"
]
},
"transferMinutes": {
"type": "integer",
"maximum": 720,
"minimum": 0
},
"availableMinutes": {
"type": "integer",
"maximum": 1440,
"minimum": 15
},
"multiOrientationMethod": {
"enum": [
"separate_takes",
"crop_from_one",
"unknown"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
},
"orderId": {
"type": "string",
"description": "The order id, or the customer-facing order reference shown on the website (for example A140A800)."
},
"idempotencyKey": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}Return a synthetic example plan generated by the real planner, with its provenance.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Return a full plan: shots in filming order (priority must = essential), setup groups per location or visit, checklist, coverage risks, progress (item keys already ticked), progressSummary with counts, each tick's time and source (web, field or agent), and timeSummary when the plan has timing. Structured shots have a unique title and whole filming minutes (at least 1); older free-text shots omit both. Use a shot's shotId for progress. Read-only. Use the full taskId from shoot_plan_list (not planId). A unique eight-character task prefix or orderReference also works. Connections see only their own live or owner-test plans.
| Argument | Type | Description |
|---|---|---|
| taskId* | string |
{
"type": "object",
"required": [
"taskId"
],
"properties": {
"taskId": {
"type": "string"
}
},
"additionalProperties": false
}List the authenticated organisation's Shoot Plans, most recently changed first, without returning private intake or full plan content. Archived plans are left out unless includeArchived is true. Each plan's taskId is the ID every other plan tool takes. Structured result: {plans:[...]}.
| Argument | Type | Description |
|---|---|---|
| includeArchived | boolean | Also list plans the owner archived. Default false. |
{
"type": "object",
"properties": {
"includeArchived": {
"type": "boolean",
"description": "Also list plans the owner archived. Default false."
}
},
"additionalProperties": false
}Tick or untick shots and checklist items. Each op: itemKey "shot:<shotId>" or "check:<itemId>" from shoot_plan_get, basePlanVersion = the plan's version, a new random UUID v4 as opId, state "complete" or "incomplete". Retry-safe: resending the same opId does nothing twice. An op made against an older basePlanVersion still applies when that item is unchanged in the current version; otherwise its result is item_changed_in_current_version and nothing changes. Ticking records that the person checked the shot, not its technical quality. Use the full taskId from shoot_plan_list (not planId). A unique eight-character task prefix or orderReference also works. Connections see only their own live or owner-test plans.
| Argument | Type | Description |
|---|---|---|
| ops* | array | |
| taskId* | string |
{
"type": "object",
"required": [
"taskId",
"ops"
],
"properties": {
"ops": {
"type": "array",
"items": {
"type": "object",
"required": [
"opId",
"basePlanVersion",
"itemKey",
"state"
],
"properties": {
"opId": {
"type": "string",
"format": "uuid"
},
"state": {
"enum": [
"complete",
"incomplete"
]
},
"itemKey": {
"type": "string",
"pattern": "^(shot|check):"
},
"recordedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"basePlanVersion": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1
},
"taskId": {
"type": "string"
}
},
"additionalProperties": false
}Calculate a deterministic public quote from non-private project metadata. Do not send a script or brief.
| Argument | Type | Description |
|---|---|---|
| equipment | array | |
| sceneCount* | integer | |
| noAiImagery | any | Legacy compatibility field; omit or send true. The customer films their own material. |
| orientation* | string | |
| peopleCount* | integer | |
| projectType* | string | |
| shootMinutes* | integer | |
| coverageNeeds | array | |
| locationCount* | integer | |
| ownFootageOnly |
Use the plan's one included revision. This cannot be undone and uses up that revision, so call shoot_plan_revision_preview first and confirm with the person. For structured plans, change filming time or transfer time (constraintUpdates.availableMinutes, locationTransferMinutes), framing, or structuredChanges. Use the full taskId from shoot_plan_list (not planId). A unique eight-character task prefix or orderReference also works. Connections see only their own live or owner-test plans.
| Argument | Type | Description |
|---|---|---|
| taskId* | string | |
| request* | string | |
| framingMode | string | |
| audioPriority | string | |
| idempotencyKey* | string | |
| replacementBeats | array | |
| constraintUpdates | object | |
| structuredChanges | object | Structured plans only: typed changes that stay within the plan's scope. |
Structured plans only; older free-text plans cannot be previewed. Preview a revision without using it: what would change, which checked shots would be cleared, and whether it still fits. For example constraintUpdates.availableMinutes: 30 answers "what if I only had 30 minutes?". Never uses the included revision. Use the full taskId from shoot_plan_list (not planId). A unique eight-character task prefix or orderReference also works. Connections see only their own live or owner-test plans.
| Argument | Type | Description |
|---|---|---|
| taskId* | string | |
| framingMode | string | |
| audioPriority | string | |
| replacementBeats | array | |
| constraintUpdates | object | |
| structuredChanges | object | Structured plans only: typed changes that stay within the plan's scope. |
{
"type": "object",
"required": [
"taskId"
],
"properties": {
"taskId": {
"type": "string"
},
"framingMode": {
"enum": [
"closer",
"wide_locked"
],
"type": "string"
},
"audioPriority": {
"enum": [
"clean"
],
"type": "string"
},
"replacementBeats": {
"type": "array",
"items": {
"type": "string",
"maxLength": 240,
"minLength": 3
},
"maxItems": 20,
"minItems": 1
},
"constraintUpdates": {
"type": "object",
"properties": {
"lightNotes": {
"type": "string",
"maxLength": 1000
},
"soundNotes": {
"type": "string",
"maxLength": 1000
},
"accessNotes": {
"type": "string",
"maxLength": 1000
},
"safetyNotes": {
"type": "string",
"maxLength": 1000
},
"locationNotes": {
"type": "string",
"maxLength": 1000
},
"mobilityNotes": {
"type": "string",
"maxLength": 1000
},
"availableMinutes": {
"type": "integer",
"maximum": 1440,
"minimum": 15
},
"locationTransferMinutes": {
"type": "integer",
"maximum": 720,
"minimum": 0
}
},
"additionalProperties": false
},
"structuredChanges": {
"type": "object",
"properties": {
"beatRepeatable": {
"type": "array",
"items": {
"type": "object",
"required": [
"beatId",
"repeatable"
],
"properties": {
"beatId": {
"type": "string",
"pattern": "^B-[0-9]{2}$"
},
"repeatable": {
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether this key moment can be filmed again. A one-time live moment cannot be switched to repeatable."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
},
"removeEquipment": {
"type": "array",
"items": {
"enum": [
"phone",
"camera",
"tripod",
"gimbal",
"external_microphone",
"lights",
"drone"
]
},
"minItems": 1,
"uniqueItems": true
}
},
"description": "Structured plans only: typed changes that stay within the plan's scope.",
"additionalProperties": false
}
},
"additionalProperties": false
}Return a plan's status, version, whether its included revision is used, its customer-facing order reference, and progress (essential shots ticked, next shot, when the last tick was made). Read-only. Use the full taskId from shoot_plan_list (not planId). A unique eight-character task prefix or orderReference also works. Connections see only their own live or owner-test plans.
| Argument | Type | Description |
|---|---|---|
| taskId* | string |
{
"type": "object",
"required": [
"taskId"
],
"properties": {
"taskId": {
"type": "string"
}
},
"additionalProperties": false
}Structured plans only (not older free-text plans). Compare planned and actual filming time between consecutive ticks in field mode. plannedSeconds is the planned time of those measured tick-to-tick steps, not the whole plan; planPlannedSeconds is the whole plan's planned shot work when present. Read-only. Use the full taskId from shoot_plan_list (not planId). A unique eight-character task prefix or orderReference also works. Connections see only their own live or owner-test plans.
| Argument | Type | Description |
|---|---|---|
| taskId* | string |
{
"type": "object",
"required": [
"taskId"
],
"properties": {
"taskId": {
"type": "string"
}
},
"additionalProperties": false
}| any |
| Customer films their own material. Same meaning as noAiImagery; omit or send true. |
| targetRuntimeSeconds* | integer |
{
"type": "object",
"required": [
"projectType",
"targetRuntimeSeconds",
"sceneCount",
"locationCount",
"peopleCount",
"shootMinutes",
"orientation"
],
"properties": {
"equipment": {
"type": "array",
"items": {
"enum": [
"phone",
"camera",
"tripod",
"gimbal",
"external_microphone",
"lights",
"drone"
],
"type": "string"
},
"uniqueItems": true
},
"sceneCount": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"noAiImagery": {
"const": true,
"description": "Legacy compatibility field; omit or send true. The customer films their own material."
},
"orientation": {
"enum": [
"landscape",
"portrait",
"square",
"mixed"
],
"type": "string"
},
"peopleCount": {
"type": "integer",
"maximum": 50,
"minimum": 0
},
"projectType": {
"enum": [
"interview",
"promo",
"tutorial",
"event",
"narrative"
],
"type": "string"
},
"shootMinutes": {
"type": "integer",
"maximum": 1440,
"minimum": 15
},
"coverageNeeds": {
"type": "array",
"items": {
"enum": [
"interview",
"demonstration",
"dialogue",
"live_event",
"night",
"moving_subject",
"product_detail",
"voiceover"
],
"type": "string"
},
"uniqueItems": true
},
"locationCount": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"ownFootageOnly": {
"const": true,
"description": "Customer films their own material. Same meaning as noAiImagery; omit or send true."
},
"targetRuntimeSeconds": {
"type": "integer",
"maximum": 7200,
"minimum": 15
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"taskId",
"request",
"idempotencyKey"
],
"properties": {
"taskId": {
"type": "string"
},
"request": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"framingMode": {
"enum": [
"closer",
"wide_locked"
],
"type": "string"
},
"audioPriority": {
"enum": [
"clean"
],
"type": "string"
},
"idempotencyKey": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"replacementBeats": {
"type": "array",
"items": {
"type": "string",
"maxLength": 240,
"minLength": 3
},
"maxItems": 20,
"minItems": 1
},
"constraintUpdates": {
"type": "object",
"properties": {
"lightNotes": {
"type": "string",
"maxLength": 1000
},
"soundNotes": {
"type": "string",
"maxLength": 1000
},
"accessNotes": {
"type": "string",
"maxLength": 1000
},
"safetyNotes": {
"type": "string",
"maxLength": 1000
},
"locationNotes": {
"type": "string",
"maxLength": 1000
},
"mobilityNotes": {
"type": "string",
"maxLength": 1000
},
"availableMinutes": {
"type": "integer",
"maximum": 1440,
"minimum": 15
},
"locationTransferMinutes": {
"type": "integer",
"maximum": 720,
"minimum": 0
}
},
"additionalProperties": false
},
"structuredChanges": {
"type": "object",
"properties": {
"beatRepeatable": {
"type": "array",
"items": {
"type": "object",
"required": [
"beatId",
"repeatable"
],
"properties": {
"beatId": {
"type": "string",
"pattern": "^B-[0-9]{2}$"
},
"repeatable": {
"enum": [
"yes",
"no",
"unknown"
],
"description": "Whether this key moment can be filmed again. A one-time live moment cannot be switched to repeatable."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
},
"removeEquipment": {
"type": "array",
"items": {
"enum": [
"phone",
"camera",
"tripod",
"gimbal",
"external_microphone",
"lights",
"drone"
]
},
"minItems": 1,
"uniqueItems": true
}
},
"description": "Structured plans only: typed changes that stay within the plan's scope.",
"additionalProperties": false
}
},
"additionalProperties": false
}