# get_segments List the storyboard's segments (narration span, type, duration, creative direction). The 1-based segment_number is the handle every segment tool takes (update/split/combine/continuation/regenerate) — you never need a UUID. Each segment also reports continues_from_segment. When set, this shot is a CONTINUATION of that earlier segment: its rendered frame carries over (same composition, characters, and setting) and only the delta changes — an added overlay, a shifted expression, a closer angle, a slow reframe. Null means a fresh, independent shot. The storyboard plans these chains automatically; adjust them with set_segment_continuation. Agent View of the PolicyLayer registry record for `get_segments`. HTML page: https://policylayer.com/tools/com-framesail-framesail/get-segments ## Facts - Tool: `get_segments` - Server: Framesail (`https://api.framesail.com/mcp`) — https://policylayer.com/tools/com-framesail-framesail.md - Homepage: https://github.com/https://api.framesail.com/mcp - Risk category: Read (Low risk) - Registry record: grade F, identity unverified - Server auth posture: open - Server rate-limited: no - Parameters: 1 (1 required) - Recommended policy verdict: Allowed ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `project_id` | string | yes | Project ID, as returned by create_project or list_projects | Parameters from the server's own tool schema. ## Example call (MCP tools/call, JSON-RPC 2.0) ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_segments", "arguments": { "project_id": "" } } } ``` ## Why get_segments is rated Low This tool performs a read-only query operation that retrieves and lists existing storyboard segment data without any side effects, modifications, or triggering external processes. It is a straightforward data retrieval function used to inspect the current state of a video project's storyboard. From the tool's own definition: "Tool name is 'get_segments' and description explicitly states 'List the storyboard's segments', with no mention of modifications, deletions, or execution of operations." Risk signals: Bulk/mass operation — affects multiple targets ## Use case AI agents call get_segments to retrieve information from Framesail without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere. ## Recommended policy (PolicyLayer) Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Framesail: ```json { "version": "1", "default": "deny", "tools": { "get_segments": {} } } ``` ## Other tools on Framesail (67) - `delete_asset` — Destructive — https://policylayer.com/tools/com-framesail-framesail/delete-asset.md - `delete_project` — Destructive — https://policylayer.com/tools/com-framesail-framesail/delete-project.md - `delete_style` — Destructive — https://policylayer.com/tools/com-framesail-framesail/delete-style.md - `director_note` — Destructive — https://policylayer.com/tools/com-framesail-framesail/director-note.md - `remove_music_track` — Destructive — https://policylayer.com/tools/com-framesail-framesail/remove-music-track.md - `scan_script` — Destructive — https://policylayer.com/tools/com-framesail-framesail/scan-script.md - `analyze_style` — Execute — https://policylayer.com/tools/com-framesail-framesail/analyze-style.md - `build_scenes` — Execute — https://policylayer.com/tools/com-framesail-framesail/build-scenes.md - `export_video` — Execute — https://policylayer.com/tools/com-framesail-framesail/export-video.md - `regenerate_segment_asset` — Execute — https://policylayer.com/tools/com-framesail-framesail/regenerate-segment-asset.md - `await_jobs` — Read — https://policylayer.com/tools/com-framesail-framesail/await-jobs.md - `browse_audio_library` — Read — https://policylayer.com/tools/com-framesail-framesail/browse-audio-library.md - `get_credit_balance` — Read — https://policylayer.com/tools/com-framesail-framesail/get-credit-balance.md - `get_pipeline_progress` — Read — https://policylayer.com/tools/com-framesail-framesail/get-pipeline-progress.md - `get_project` — Read — https://policylayer.com/tools/com-framesail-framesail/get-project.md - `get_script` — Read — https://policylayer.com/tools/com-framesail-framesail/get-script.md - `get_section_template` — Read — https://policylayer.com/tools/com-framesail-framesail/get-section-template.md - `get_segment_assets` — Read — https://policylayer.com/tools/com-framesail-framesail/get-segment-assets.md - `get_style` — Read — https://policylayer.com/tools/com-framesail-framesail/get-style.md - `get_video_url` — Read — https://policylayer.com/tools/com-framesail-framesail/get-video-url.md - `get_workflow_status` — Read — https://policylayer.com/tools/com-framesail-framesail/get-workflow-status.md - `list_assets` — Read — https://policylayer.com/tools/com-framesail-framesail/list-assets.md - `list_channels` — Read — https://policylayer.com/tools/com-framesail-framesail/list-channels.md - `list_models` — Read — https://policylayer.com/tools/com-framesail-framesail/list-models.md - `list_music_tracks` — Read — https://policylayer.com/tools/com-framesail-framesail/list-music-tracks.md - `list_projects` — Read — https://policylayer.com/tools/com-framesail-framesail/list-projects.md - `list_provider_keys` — Read — https://policylayer.com/tools/com-framesail-framesail/list-provider-keys.md - `list_scenes` — Read — https://policylayer.com/tools/com-framesail-framesail/list-scenes.md - `list_style_presets` — Read — https://policylayer.com/tools/com-framesail-framesail/list-style-presets.md - `list_styles` — Read — https://policylayer.com/tools/com-framesail-framesail/list-styles.md - …and 37 more: https://policylayer.com/tools/com-framesail-framesail.md ## For agents This record is a snapshot. Live verdicts and the full registry: - Check every server in your MCP config at once: `npx -y policylayer stack` - Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md) - Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events` --- Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=com-framesail-framesail · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/com-framesail-framesail