Genvid's Boundary Tool Contract

Genvid’s governed boundary publishes 27 supported tools. The table below is the full contract. It is generated from the same file our smoke tests run against, _boundary_tools.yaml in the agent-skills pack, and it carries the contract version it was generated from, 0.7.7.

Each tool carries a risk classification. A read_only tool is free and never asks for confirmation. An additive tool creates new records. A billable tool spends money. A destructive tool overwrites existing work, and your MCP client asks you before it runs.

The classification describes the risk of a call. The audit record is a separate question. Creating, changing, or removing a project, sequence, scene, beat, shot, asset, screenplay, media, or signed manifest is written to a log that only grows, and so is any change to the links binding those records to one another. A few tools record elsewhere. review_write files a decision record, and a task’s status changes are kept in the review history that review_read returns. The contract states where each tool writes its record.

A blank Skill cell means no pack skill teaches that tool yet. The tool’s own description over MCP is the reference.

Tool	Classification	Parameters	Skill
`discovery_read`	read_only	`method`, `project_id`, `query`, `model_type`, `source_type`, `source_id`, `run_id`	genvid-propagate-change
`analytics_read`	read_only	`method`, `project_id`, `project_ids`, `breakdown_by`, `date_from`, `date_to`, `asset_type`
`propagate_change`	billable	`source_type`, `source_id`, `option`	genvid-propagate-change
`media_read`	read_only	`project_id`, `media_ids`	genvid-agent-generation
`ingest_generated_media`	additive	`project_id`, `link_type`, `shot_id`, `asset_id`, `source_url`, `image_base64`, `filename`, `model_provider`, `model_name`, `render_type`, `prompt`, `params`, `input_media_ids`, `input_link_type`	genvid-agent-generation
`register_media`	additive	`project_id`, `link_type`, `shot_id`, `asset_id`, `filename`, `mime_type`, `proxy_filename`, `storage_class`, `connection_name`	genvid-media-registration
`finalize_media_registration`	additive	`project_id`, `media_id`, `link_type`, `shot_id`, `asset_id`, `content_hash`, `fingerprint_iscc`, `fingerprint_iscc_content`, `filename`, `mime_type`, `size_bytes`, `duration_seconds`, `timecode`, `locator`, `locator_type`, `pre_signed_c2pa_manifest`, `input_media_ids`, `storage_class`, `connection_name`	genvid-media-registration
`resolve_media`	read_only	`project_id`, `media_id`	genvid-agent-generation
`verify_media`	additive	`project_id`, `media_id`, `content_hash`, `locator`, `locator_type`	genvid-media-registration
`connect_media`	additive	`project_id`, `media_id`, `locator`, `connection_name`	genvid-media-registration
`approve_media`	destructive	`project_id`, `media_id`, `selection_status`
`export_provenance_report`	read_only	`project_id`, `format`
`production_read`	read_only	`method`, `project_id`, `resource_type`, `resource_id`, `assigned_to`, `task_type`, `generation_type`, `model_id`	genvid-agent-generation
`production_write`	destructive	`method`, `project_id`, `resource_type`, `resource_id`, `task_type`, `assigned_to_email`, `workflow_status`, `priority`	genvid-agent-generation
`review_read`	read_only	`method`, `resource_type`, `resource_id`, `task_type`, `page`, `page_size`	genvid-agent-generation
`review_write`	additive	`method`, `project_id`, `media_id`, `assignment_id`, `note`, `critique_tags`, `scope_target`, `dimension`, `severity`, `chain_id`	genvid-agent-generation
`screenplay_read`	read_only	`method`, `project_id`	genvid-screenplay-breakdown
`screenplay_write`	destructive	`method`, `project_id`, `content`, `message`	genvid-screenplay-breakdown
`assets_read`	read_only	`method`, `project_id`, `asset_id`, `asset_type`, `render_type`, `budget_preference`, `shot_complexity`, `max_results`	genvid-agent-generation
`assets_write`	destructive	`method`, `project_id`, `asset_id`, `name`, `asset_type`, `description`, `assets`	genvid-screenplay-breakdown
`locations_write`	destructive	`method`, `project_id`, `scene_id`, `location_id`
`scenes_read`	read_only	`method`, `project_id`, `scene_id`	genvid-scene-shot-design
`scenes_write`	destructive	`method`, `project_id`, `scene_id`, `linked_assets`	genvid-scene-shot-design
`shots_read`	read_only	`method`, `project_id`, `shot_id`, `limit`, `cursor`, `detail`	genvid-scene-shot-design
`shots_write`	destructive	`method`, `project_id`, `shot_id`, `prompt`, `description`, `shot_size`, `camera_angle`, `camera_movement`, `shot_framing`, `transition`	genvid-scene-shot-design
`storyboard_write`	destructive	`method`, `project_id`, `scenes`, `scene_id`, `beat`, `shots`	genvid-scene-shot-design
`get_storyboard`	read_only	`project_id`	genvid-scene-shot-design