davinci-resolve-mcp 2.215.2 → 2.216.0

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
 
+## What's New in v2.216.0 — twelve Resolve 21.1 read-only controls, in both server modes
+
+Contributed by @legionsound (#206), live-measured on Studio 21.1.0.14.
+
+### Added
+
+- **Twelve readers for data 21.1 exposes natively**, each as a compound
+  action and a granular tool: `resolve_control is_studio`,
+  `get_keyboard_presets`, `get_current_keyboard_preset`; `project_settings
+  get_project_settings_presets`; `render get_audio_formats`,
+  `get_audio_codecs(format)`; `timeline get_normalize_audio_modes`,
+  `get_output_blanking`; `timeline_item get_speed`, `get_fades`,
+  `get_output_blanking`, `get_use_timeline_for_output_blanking`. Native
+  values pass through untouched, including `false`, empty inherited blanking
+  and fractional fade durations; the four blanking values are pixel
+  coordinates, not margins. A build without the method returns an explicit
+  "requires DaVinci Resolve 21.1+" error — confirmed here on Studio 19.1.3.7,
+  where all twelve refuse cleanly. The granular count moves from 353 to 365
+  tools; docs, generated agent rules, the version ledger and the coverage
+  reference are updated together. `GetProjectLastModifiedTime` was deferred
+  because it returned `None` for existing projects on the test install.
+  See `docs/reference/resolve211-read-controls.md`.
+
+### Validation
+
+- The PR's offline contracts (absent methods, argument forwarding, preserved
+  false/empty payloads, invalid locators), the full offline suite, drift
+  guards and the advanced Node suite. Positive payloads are the contributor's
+  measurement on 21.1.0.14 through both interfaces; the version-floor refusal
+  is measured here on 19.1.3.7.
+
 ## What's New in v2.215.2 — the granular server accepts Resolve 21.1's lowercase item types; the 21.1 typed API ships as reference
 
 Both contributed by @legionsound (#204, #205), measured on Studio 21.1.0.14.

package/README.md

@@ -2,10 +2,10 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.215.2-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.216.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
-[![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#server-modes)
+[![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(365%20full)-blue.svg)](#server-modes)
 [![Advanced](https://img.shields.io/badge/Advanced%20(offline)-18%20tools-blueviolet.svg)](#server-modes)
 [![Tested](https://img.shields.io/badge/Live%20Tested-93.6%25-green.svg)](docs/reference/api-coverage.md#test-results)
 [![DaVinci Resolve](https://img.shields.io/badge/DaVinci%20Resolve-18.5+-darkred.svg)](https://www.blackmagicdesign.com/products/davinciresolve)
@@ -133,7 +133,7 @@ The command starts a loopback-only server and opens the control panel in your br
 | Mode | Entry point | Tools | Best for |
 |------|-------------|-------|----------|
 | Compound | `src/server.py` | 36 | Default mode for most assistants. Related Resolve operations are grouped behind action parameters to keep context usage low. |
-| Full / granular | `src/server.py --full` or `src/resolve_mcp_server.py` | 353 | Power users who want one MCP tool per Resolve API method. |
+| Full / granular | `src/server.py --full` or `src/resolve_mcp_server.py` | 365 | Power users who want one MCP tool per Resolve API method. |
 
 The compound server is recommended unless you specifically need the granular one-tool-per-method surface.
 
@@ -365,7 +365,7 @@ The default server is a local stdio process launched by your MCP client; it does
 
 | Metric | Value |
 |--------|-------|
-| MCP Tools | **36** compound / **353** granular (live server) |
+| MCP Tools | **36** compound / **365** granular (live server) |
 | Advanced (offline) tools | **18** — .drp/.drt/.drx + DB authoring, no Resolve running |
 | Kernel Actions | **136** guarded workflow actions across 9 compound tools |
 | API Methods Covered | **361/361** (100%) |

package/README.zh-CN.md

@@ -2,17 +2,17 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.215.2-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.216.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
-[![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#服务器模式)
+[![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(365%20full)-blue.svg)](#服务器模式)
 [![Advanced](https://img.shields.io/badge/Advanced%20(offline)-18%20tools-blueviolet.svg)](#服务器模式)
 [![Tested](https://img.shields.io/badge/Live%20Tested-93.6%25-green.svg)](docs/reference/api-coverage.md#test-results)
 [![DaVinci Resolve](https://img.shields.io/badge/DaVinci%20Resolve-18.5+-darkred.svg)](https://www.blackmagicdesign.com/products/davinciresolve)
 [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> 本翻译对应 v2.215.2 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.216.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 
@@ -88,7 +88,7 @@ venv/bin/python -m src.control_panel
 | 模式 | 入口 | 工具数 | 适合谁 |
 |------|------|--------|--------|
 | Compound（复合） | `src/server.py` | 36 | 大多数助手的默认模式。相关的 Resolve 操作按 action 参数分组，压低上下文占用。 |
-| Full / granular（细粒度） | `src/server.py --full` 或 `src/resolve_mcp_server.py` | 353 | 想要"一个 Resolve API 方法 = 一个 MCP 工具"的重度用户。 |
+| Full / granular（细粒度） | `src/server.py --full` 或 `src/resolve_mcp_server.py` | 365 | 想要"一个 Resolve API 方法 = 一个 MCP 工具"的重度用户。 |
 
 除非你明确需要一方法一工具的细粒度界面，否则推荐复合模式。
 
@@ -226,7 +226,7 @@ DRX 调色写入**针对 Resolve Studio 做过实机校准**：调色参数默
 
 | 指标 | 数值 |
 |------|------|
-| MCP 工具 | **36** 复合 / **353** 细粒度（实时服务器） |
+| MCP 工具 | **36** 复合 / **365** 细粒度（实时服务器） |
 | Advanced（离线）工具 | **18**——.drp/.drt/.drx + 数据库创作，无需 Resolve 运行 |
 | 内核 action | 9 个复合工具下 **136** 个带护栏的工作流 action |
 | API 方法覆盖 | **361/361**（100%） |

package/docs/SKILL.md

@@ -345,7 +345,11 @@ to the user as verified.
 | Mode | Entry point | Tool count | Use when |
 |---|---|---|---|
 | Compound (default) | `src/server.py` | 36 tools | Most workflows — keeps context lean |
-| Granular (full) | `src/server.py --full` | 353 tools | Power users needing one tool per API method |
+| Granular (full) | `src/server.py --full` | 365 tools | Power users needing one tool per API method |
+
+Resolve 21.1 adds [twelve read-only discovery controls](reference/resolve211-read-controls.md)
+for edition, presets, audio formats/codecs, normalization modes, speed, fades
+and blanking in both server interfaces. These readers do not invoke setters.
 
 This skill document covers the **compound server** (the default). Each compound
 tool accepts an `action` string and an optional `params` object.

package/docs/contributing.md

@@ -64,7 +64,7 @@ davinci-resolve-mcp/
 ├── install.py                    # Universal installer (macOS/Windows/Linux)
 ├── src/
 │   ├── server.py                # Compound MCP server — 36 tools (default)
-│   ├── resolve_mcp_server.py    # Thin full-server entrypoint — 353 tools
+│   ├── resolve_mcp_server.py    # Thin full-server entrypoint — 365 tools
 │   ├── granular/                # Modular full-server implementation
 │   └── utils/                   # Platform detection, Resolve connection helpers
 ├── tests/                       # offline suite (test_*.py) + live harnesses (live_*.py):

package/docs/install.md

@@ -144,7 +144,7 @@ The MCP server comes in two modes:
 | Mode | File | Tools | Best For |
 |------|------|-------|----------|
 | **Compound** (default) | `src/server.py` | 36 | Most users — fast, clean, low context usage |
-| **Full** | `src/resolve_mcp_server.py` | 353 | Power users who want one tool per API method |
+| **Full** | `src/resolve_mcp_server.py` | 365 | Power users who want one tool per API method |
 
 The compound server's `timeline_item` tool includes dedicated actions for common workflows:
 
@@ -159,7 +159,7 @@ The compound server's `timeline_item` tool includes dedicated actions for common
 
 The installer uses the compound server by default. To use the full server:
 ```bash
-python src/server.py --full    # Launch full 353-tool server
+python src/server.py --full    # Launch full 365-tool server
 # Or point your MCP config directly at src/resolve_mcp_server.py
 ```
 

package/docs/reference/api-coverage.md

@@ -1,12 +1,16 @@
 # API Coverage and Test Results
 
-Complete Resolve scripting API coverage, live-test status, and method-by-method reference.
+Legacy-reference coverage, incremental Resolve 21.1 coverage, live-test status,
+and method-by-method reference.
 
 ## Key Stats
 
+The API totals below refer to the bundled legacy README baseline. Resolve 21.1
+additions are tracked separately in the section below.
+
 | Metric | Value |
 |--------|-------|
-| MCP Tools | **36** compound (default) / **353** granular |
+| MCP Tools | **36** compound (default) / **365** granular |
 | Kernel Actions | **136** guarded MCP workflow actions across 9 compound tools |
 | API Methods Covered | **361/361** (100%) |
 | Methods Live Tested | **338/361** (93.6%) |
@@ -17,7 +21,18 @@ Complete Resolve scripting API coverage, live-test status, and method-by-method
 
 ## API Coverage
 
-Every non-deprecated method in the DaVinci Resolve Scripting API is covered. The default compound server exposes **36 tools** that group related operations by action parameter, keeping LLM context windows lean. The full granular server provides **353 individual tools** for power users. Both modes cover all 13 API object classes. MCP-level kernel actions are tracked separately in [Kernel Action Coverage](../kernels/README.md).
+Every non-deprecated method in the bundled legacy README is represented. This
+does not claim complete coverage of the newer Resolve 21.1 typed API. The
+default compound server exposes **36 tools** that group related operations by
+action parameter, keeping LLM context windows lean. The full granular server
+provides **365 individual tools** for power users. The legacy coverage spans
+13 API object classes. MCP-level kernel actions are tracked separately in
+[Kernel Action Coverage](../kernels/README.md).
+
+Twelve additional [Resolve 21.1 read-only controls](resolve211-read-controls.md)
+are implemented in both interfaces and were live-measured by a contributor on
+Studio 21.1.0.14. Their evidence and limitations are recorded separately from
+the historical aggregate above.
 
 The 34th compound tool is `timeline_versioning` (C6) — an MCP-level workflow
 tool, not a wrapper around a Resolve API method. It surfaces the
@@ -28,7 +43,8 @@ for usage.
 Workflow helpers can go beyond one-to-one API method coverage while still using
 only public Resolve calls. For example, `media_pool.setup_multicam_timeline`
 prepares a stacked timeline for Resolve's multicam UI, but native multicam clip
-creation itself is not exposed by the scripting API. Similarly,
+creation is available in Resolve 21.1 through CreateMulticamClip; that native
+route is not implemented by this helper. Similarly,
 `media_analysis.detect_sync_events` is a source-safe FFmpeg/FFprobe helper for
 advisory 2-pop and slate-clap sync points; it is not a Resolve API method.
 `media_analysis.add_sync_event_markers` is an explicit marker-write helper for

package/docs/reference/resolve211-read-controls.md

@@ -0,0 +1,60 @@
+# Resolve 21.1 read-only discovery
+
+Twelve readers expose native 21.1 data in both compound and granular modes.
+They do not load presets, alter timeline settings, create render jobs, change
+clips or perform normalization. Calls require a callable native method; older
+builds without it return an explicit method/version error.
+
+| Compound tool/action | Granular tool | Result |
+|---|---|---|
+| resolve_control is_studio | is_resolve_studio | is_studio boolean |
+| resolve_control get_keyboard_presets | get_keyboard_presets | presets list |
+| resolve_control get_current_keyboard_preset | get_current_keyboard_preset | active preset name |
+| project_settings get_project_settings_presets | get_project_settings_presets | preset records with Name, Width, Height |
+| render get_audio_formats | get_audio_render_formats | format descriptions mapped to extensions |
+| render get_audio_codecs | get_audio_render_codecs | codec descriptions mapped to native codec identifiers |
+| timeline get_normalize_audio_modes | get_normalize_audio_modes | native normalization-mode names |
+| timeline get_output_blanking | get_timeline_output_blanking | blanking dictionary |
+| timeline_item get_speed | get_timeline_item_speed | native speed options |
+| timeline_item get_fades | get_timeline_item_fades | FadeIn/FadeOut frame durations |
+| timeline_item get_output_blanking | get_timeline_item_output_blanking | blanking dictionary; empty when inherited |
+| timeline_item get_use_timeline_for_output_blanking | get_timeline_item_use_timeline_for_output_blanking | use_timeline boolean |
+
+For audio codecs, `format` is a file extension from the audio formats reader,
+for example `wav`, not the display label `Wave`. Empty and non-string inputs
+are refused before making the native call.
+
+Clip readers accept `track_type` (`video` or `audio`), a 1-based `track_index`
+and a 0-based `item_index`; defaults are video, 1, 0. Granular readers refuse
+negative item indexes and invalid track types/indexes before lookup. These are
+the existing compound item-location conventions.
+
+The payload is passed through without coercing false, empty lists/dictionaries
+or fractional frame durations. Empty clip blanking is valid when inheritance
+is enabled. The four blanking values are native pixel coordinates; do not
+reinterpret them as four independent margin widths. The speed reader returns
+the native options rather than trying to derive speed from source/timeline
+frame spans.
+
+## Validation and limits
+
+Contributed live measurement on macOS **DaVinci Resolve Studio 21.1.0.14**,
+September 9, 2026: all twelve readers returned matching domain payloads through
+both interfaces. Compound `_operation` instrumentation is separate from that
+domain payload. No project/preset/clip mutation was invoked.
+
+```sh
+python -m unittest tests.test_resolve211_read_controls
+python tests/live_resolve211_read_controls.py
+```
+
+The live script requires an existing project and timeline with a normal video
+clip on video track 1. Its receipt omits project, clip and preset names.
+Offline contracts exercise all readers, absent methods, preserved false/empty
+values, required argument forwarding, and invalid granular item locators.
+
+This is not a claim of full 21.1 API coverage, or a promise that corresponding
+setters/multicam/transitions/normalization are implemented. The generic
+GetProjectLastModifiedTime reader was intentionally deferred after the native
+API returned None for several existing projects on the test installation.
+That observation needs investigation rather than an advertised timestamp.

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.215.2"
+VERSION = "2.216.0"
 # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
 # Resolve's scripting bridge loads into newer interpreters on recent builds
 # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds
@@ -1543,7 +1543,7 @@ def verify_resolve_connection(python_path, api_path, lib_path):
 
 def print_banner():
     title = f"DaVinci Resolve MCP Server — Installer v{VERSION}"
-    subtitle = "36 compound · 353 full · 3 platforms"
+    subtitle = "36 compound · 365 full · 3 platforms"
     print()
     print(bold("  ╔══════════════════════════════════════════════════════╗"))
     print(bold(f"  ║{title:^54}║"))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "davinci-resolve-mcp",
-  "version": "2.215.2",
+  "version": "2.216.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/src/granular/__init__.py

@@ -10,6 +10,7 @@ from src.granular import (
     media_storage,
     project,
     resolve_control,
+    resolve_211,
     timeline,
     timeline_item,
 )

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.215.2"
+VERSION = "2.216.0"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")

package/src/granular/resolve_211.py

@@ -0,0 +1,148 @@
+"""Read-only discovery added to the typed Resolve 21.1 API surface."""
+from src.granular.common import (
+    mcp, READ_ONLY_TOOL, get_resolve, get_current_project,
+    _get_timeline, _get_timeline_item, _requires_method, has_method,
+)
+
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def is_resolve_studio() -> dict:
+    """Read IsStudio (documented on Resolve 21.1+)."""
+    r = get_resolve()
+    if r is None:
+        return {"error": "Not connected to DaVinci Resolve"}
+    if not has_method(r, "IsStudio"):
+        return {"error": "IsStudio is unavailable on this Resolve build"}
+    return {"is_studio": r.IsStudio()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_keyboard_presets() -> dict:
+    """Read GetKeyboardPresetList (documented on Resolve 21.1+)."""
+    r = get_resolve()
+    if r is None:
+        return {"error": "Not connected to DaVinci Resolve"}
+    missing = _requires_method(r, "GetKeyboardPresetList", "21.1")
+    if missing:
+        return missing
+    return {"presets": r.GetKeyboardPresetList()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_current_keyboard_preset() -> dict:
+    """Read GetCurrentKeyboardPreset (documented on Resolve 21.1+)."""
+    r = get_resolve()
+    if r is None:
+        return {"error": "Not connected to DaVinci Resolve"}
+    missing = _requires_method(r, "GetCurrentKeyboardPreset", "21.1")
+    if missing:
+        return missing
+    return {"name": r.GetCurrentKeyboardPreset()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_project_settings_presets() -> dict:
+    """Read GetProjectSettingsPresetList (documented on Resolve 21.1+)."""
+    _, proj = get_current_project()
+    if proj is None:
+        return {"error": "No project currently open"}
+    missing = _requires_method(proj, "GetProjectSettingsPresetList", "21.1")
+    if missing:
+        return missing
+    return {"presets": proj.GetProjectSettingsPresetList()}
+
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_audio_render_formats() -> dict:
+    """Read GetAudioRenderFormats (documented on Resolve 21.1+)."""
+    _, proj = get_current_project()
+    if proj is None:
+        return {"error": "No project currently open"}
+    missing = _requires_method(proj, "GetAudioRenderFormats", "21.1")
+    if missing:
+        return missing
+    return {"formats": proj.GetAudioRenderFormats()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_audio_render_codecs(format: str) -> dict:
+    """Read GetAudioRenderCodecs (documented on Resolve 21.1+). Pass an audio file extension such as wav."""
+    if not isinstance(format, str) or not format.strip():
+        return {"error": "get_audio_codecs requires a non-empty format string"}
+    _, proj = get_current_project()
+    if proj is None:
+        return {"error": "No project currently open"}
+    missing = _requires_method(proj, "GetAudioRenderCodecs", "21.1")
+    if missing:
+        return missing
+    return {"codecs": proj.GetAudioRenderCodecs(format)}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_normalize_audio_modes() -> dict:
+    """Read GetNormalizeAudioModes (documented on Resolve 21.1+)."""
+    _, tl, error = _get_timeline()
+    if error:
+        return error
+    missing = _requires_method(tl, "GetNormalizeAudioModes", "21.1")
+    if missing:
+        return missing
+    return {"modes": tl.GetNormalizeAudioModes()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_timeline_output_blanking() -> dict:
+    """Read GetOutputBlanking (documented on Resolve 21.1+). Pixel coordinates; clips inheriting timeline blanking return an empty dict."""
+    _, tl, error = _get_timeline()
+    if error:
+        return error
+    missing = _requires_method(tl, "GetOutputBlanking", "21.1")
+    if missing:
+        return missing
+    return {"blanking": tl.GetOutputBlanking()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_timeline_item_speed(track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
+    """Read GetSpeed (documented on Resolve 21.1+)."""
+    if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
+        return {"error": "Use video/audio, a 1-based track index and a non-negative item index"}
+    item, error = _get_timeline_item(track_type, track_index, item_index)
+    if error:
+        return error
+    missing = _requires_method(item, "GetSpeed", "21.1")
+    if missing:
+        return missing
+    return {"speed": item.GetSpeed()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_timeline_item_fades(track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
+    """Read GetFades (documented on Resolve 21.1+). Durations are in frames."""
+    if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
+        return {"error": "Use video/audio, a 1-based track index and a non-negative item index"}
+    item, error = _get_timeline_item(track_type, track_index, item_index)
+    if error:
+        return error
+    missing = _requires_method(item, "GetFades", "21.1")
+    if missing:
+        return missing
+    return {"fades": item.GetFades()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_timeline_item_output_blanking(track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
+    """Read GetOutputBlanking (documented on Resolve 21.1+). Pixel coordinates; clips inheriting timeline blanking return an empty dict."""
+    if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
+        return {"error": "Use video/audio, a 1-based track index and a non-negative item index"}
+    item, error = _get_timeline_item(track_type, track_index, item_index)
+    if error:
+        return error
+    missing = _requires_method(item, "GetOutputBlanking", "21.1")
+    if missing:
+        return missing
+    return {"blanking": item.GetOutputBlanking()}
+
+@mcp.tool(annotations=READ_ONLY_TOOL)
+def get_timeline_item_use_timeline_for_output_blanking(track_type: str = "video", track_index: int = 1, item_index: int = 0) -> dict:
+    """Read GetUseTimelineForOutputBlanking (documented on Resolve 21.1+)."""
+    if track_type not in ("video", "audio") or track_index < 1 or item_index < 0:
+        return {"error": "Use video/audio, a 1-based track index and a non-negative item index"}
+    item, error = _get_timeline_item(track_type, track_index, item_index)
+    if error:
+        return error
+    missing = _requires_method(item, "GetUseTimelineForOutputBlanking", "21.1")
+    if missing:
+        return missing
+    return {"use_timeline": item.GetUseTimelineForOutputBlanking()}

package/src/resolve_mcp_server.py

@@ -34,7 +34,7 @@ from src.utils.update_check import start_background_update_check
 if __name__ == "__main__":
     try:
         start_background_update_check(VERSION, project_dir, logger)
-        logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION} (353 granular tools)")
+        logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION} (365 granular tools)")
         run_fastmcp_stdio(mcp)
     except KeyboardInterrupt:
         logger.info("Server shutdown requested")

package/src/server.py

@@ -8,10 +8,10 @@ Each tool groups related operations via an 'action' parameter.
 
 Usage:
     python src/server.py              # Start the MCP server
-    python src/server.py --full       # Start the 353-tool granular server instead
+    python src/server.py --full       # Start the 365-tool granular server instead
 """
 
-VERSION = "2.215.2"
+VERSION = "2.216.0"
 
 import base64
 import os
@@ -16571,6 +16571,9 @@ def resolve_control(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
     """App-level DaVinci Resolve operations.
 
     Actions:
+      is_studio() -> {is_studio} — documented on Resolve 21.1+.
+      get_keyboard_presets() -> {presets} — documented on Resolve 21.1+.
+      get_current_keyboard_preset() -> {name} — documented on Resolve 21.1+.
       launch(headless?) -> {success, message, running, headless, guidance}
         — Launch DaVinci Resolve if not running. Call this FIRST if any tool returns
           a 'Not connected' error. headless=true starts it with no UI (-nogui):
@@ -16928,6 +16931,21 @@ def resolve_control(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
     if r is None:
         return _not_connected_error()
 
+    if action == "is_studio":
+        if not _has_method(r, "IsStudio"):
+            return _err("IsStudio is unavailable on this Resolve build")
+        return {"is_studio": _ser(r.IsStudio())}
+    if action == "get_keyboard_presets":
+        missing = _requires_method(r, "GetKeyboardPresetList", "21.1")
+        if missing:
+            return missing
+        return {"presets": _ser(r.GetKeyboardPresetList())}
+    if action == "get_current_keyboard_preset":
+        missing = _requires_method(r, "GetCurrentKeyboardPreset", "21.1")
+        if missing:
+            return missing
+        return {"name": _ser(r.GetCurrentKeyboardPreset())}
+
     if action == "get_version":
         update_env = _setup_update_env()
         mcp_update = get_cached_update_status(project_dir, VERSION, env=update_env)
@@ -17048,7 +17066,7 @@ def resolve_control(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
         if err:
             return _err(err)
         return {"success": bool(r.ExportUserPreferencesPreset(clean["name"], clean["path"]))}
-    return _unknown(action, ["launch","runtime_mode","get_version","api_truth","check_version_support","verification_stats","job_status","list_jobs","get_execution_trace","get_execution","list_recent_executions","begin_execution","end_execution","export_execution_report","clear_executions","inspect_operation","list_lifecycle_hooks","mcp_update_status","set_mcp_update_policy","ignore_mcp_update","snooze_mcp_update","clear_mcp_update_preferences","get_page","open_page","get_keyframe_mode","set_keyframe_mode","quit","get_fairlight_presets","set_high_priority","disable_background_tasks_for_current_session","list_user_preferences_presets","save_user_preferences_preset","load_user_preferences_preset","delete_user_preferences_preset","import_user_preferences_preset","export_user_preferences_preset","open_control_panel","control_panel_status","close_control_panel","save_state","restore_state"])
+    return _unknown(action, ["is_studio","get_keyboard_presets","get_current_keyboard_preset","launch","runtime_mode","get_version","api_truth","check_version_support","verification_stats","job_status","list_jobs","get_execution_trace","get_execution","list_recent_executions","begin_execution","end_execution","export_execution_report","clear_executions","inspect_operation","list_lifecycle_hooks","mcp_update_status","set_mcp_update_policy","ignore_mcp_update","snooze_mcp_update","clear_mcp_update_preferences","get_page","open_page","get_keyframe_mode","set_keyframe_mode","quit","get_fairlight_presets","set_high_priority","disable_background_tasks_for_current_session","list_user_preferences_presets","save_user_preferences_preset","load_user_preferences_preset","delete_user_preferences_preset","import_user_preferences_preset","export_user_preferences_preset","open_control_panel","control_panel_status","close_control_panel","save_state","restore_state"])
 
 
 # ─── V2 C4: Per-field corrections with provenance + changelog ────────────────
@@ -19342,6 +19360,7 @@ def project_settings(action: str, params: Optional[Dict[str, Any]] = None) -> Di
     """Project metadata, settings, and color groups.
 
     Actions:
+      get_project_settings_presets() -> {presets} — documented on Resolve 21.1+.
       get_name() -> {name}
       set_name(name) -> {success}
       get_setting(name?) -> {settings}  — omit name for all settings
@@ -19370,6 +19389,12 @@ def project_settings(action: str, params: Optional[Dict[str, Any]] = None) -> Di
     if err:
         return err
 
+    if action == "get_project_settings_presets":
+        missing = _requires_method(proj, "GetProjectSettingsPresetList", "21.1")
+        if missing:
+            return missing
+        return {"presets": _ser(proj.GetProjectSettingsPresetList())}
+
     if action == "get_name":
         return {"name": proj.GetName()}
     elif action == "set_name":
@@ -19497,7 +19522,7 @@ def project_settings(action: str, params: Optional[Dict[str, Any]] = None) -> Di
             result = _ai_result_payload(proj.ResetIntellisearchAnalysis())
             _rec.success = result["success"]
         return result
-    return _unknown(action, ["get_name","set_name","get_setting","set_setting","get_unique_id","get_presets","set_preset","refresh_luts","get_gallery","export_frame_as_still","project_summary","load_burnin_preset","insert_audio","get_color_groups","add_color_group","delete_color_group","apply_fairlight_preset","generate_speech","reset_intellisearch_analysis"])
+    return _unknown(action, ["get_project_settings_presets","get_name","set_name","get_setting","set_setting","get_unique_id","get_presets","set_preset","refresh_luts","get_gallery","export_frame_as_still","project_summary","load_burnin_preset","insert_audio","get_color_groups","add_color_group","delete_color_group","apply_fairlight_preset","generate_speech","reset_intellisearch_analysis"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -20311,6 +20336,8 @@ def render(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, An
     """Render pipeline: jobs, presets, formats, codecs, and rendering.
 
     Actions:
+      get_audio_formats() -> {formats} — documented on Resolve 21.1+.
+      get_audio_codecs(format) -> {codecs} — documented on Resolve 21.1+. Audio file extension, e.g. wav.
       add_job() -> {job_id}
       delete_job(job_id) -> {success}
       delete_all_jobs() -> {success}
@@ -20582,6 +20609,19 @@ def render(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, An
         return _ok()
     elif action == "is_rendering":
         return {"rendering": bool(proj.IsRenderingInProgress())}
+    elif action == "get_audio_formats":
+        missing = _requires_method(proj, "GetAudioRenderFormats", "21.1")
+        if missing:
+            return missing
+        return {"formats": _ser(proj.GetAudioRenderFormats())}
+    elif action == "get_audio_codecs":
+        if not isinstance(p.get("format"), str) or not p["format"].strip():
+            return _err("get_audio_codecs requires a non-empty format string")
+        missing = _requires_method(proj, "GetAudioRenderCodecs", "21.1")
+        if missing:
+            return missing
+        return {"codecs": _ser(proj.GetAudioRenderCodecs(p["format"]))}
+
     elif action == "get_formats":
         return {"formats": _ser(proj.GetRenderFormats())}
     elif action == "get_codecs":
@@ -20699,7 +20739,7 @@ def render(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, An
         return _safe_quick_export(proj, p)
     elif action == "export_render_boundary_report":
         return _export_render_boundary_report(proj, p)
-    return _unknown(action, ["add_job","delete_job","delete_all_jobs","list_jobs","get_job_status","verify_output","start","stop","is_rendering","get_formats","get_codecs","get_format_and_codec","set_format_and_codec","get_mode","set_mode","get_resolutions","get_settings","set_settings","list_presets","load_preset","save_preset","delete_preset","quick_export_presets","quick_export",*_RENDER_KERNEL_ACTIONS])
+    return _unknown(action, ["get_audio_formats","get_audio_codecs","add_job","delete_job","delete_all_jobs","list_jobs","get_job_status","verify_output","start","stop","is_rendering","get_formats","get_codecs","get_format_and_codec","set_format_and_codec","get_mode","set_mode","get_resolutions","get_settings","set_settings","list_presets","load_preset","save_preset","delete_preset","quick_export_presets","quick_export",*_RENDER_KERNEL_ACTIONS])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -25003,6 +25043,7 @@ def edit_engine(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[st
 
 
 _TIMELINE_ACTIONS = [
+    "get_normalize_audio_modes", "get_output_blanking",
     # Offline authoring — served without a Resolve connection, above the _check() gate.
     "author_offline", "offline_fallback_capabilities",
     "list", "get_current", "set_current", "get_name", "set_name", "get_start_frame",
@@ -25051,6 +25092,8 @@ def timeline(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str,
     (resolve_control api_truth "GetSourceStartFrame").
 
     Actions:
+      get_normalize_audio_modes() -> {modes} — documented on Resolve 21.1+.
+      get_output_blanking() -> {blanking} — documented on Resolve 21.1+. Pixel coordinates; empty on a clip inheriting timeline blanking.
       list() -> {timelines}
       get_current() -> {name, id, start_frame, end_frame, start_timecode}
       set_current(index|id|name) -> {success}  — id/name are stable across archives; index is 1-based
@@ -25367,6 +25410,17 @@ def timeline(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str,
     if not tl:
         return _err("No current timeline")
 
+    if action == "get_normalize_audio_modes":
+        missing = _requires_method(tl, "GetNormalizeAudioModes", "21.1")
+        if missing:
+            return missing
+        return {"modes": _ser(tl.GetNormalizeAudioModes())}
+    if action == "get_output_blanking":
+        missing = _requires_method(tl, "GetOutputBlanking", "21.1")
+        if missing:
+            return missing
+        return {"blanking": _ser(tl.GetOutputBlanking())}
+
     if action == "clip_where":
         return _timeline_clip_where(tl, p)
     if action == "get_current":
@@ -26218,6 +26272,10 @@ def timeline_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[
     Identify by track_type, track_index, item_index (item_index is 0-BASED: 0 = first clip; track_index is 1-based).
 
     Actions:
+      get_speed(...) -> {speed} — documented on Resolve 21.1+.
+      get_fades(...) -> {fades} — documented on Resolve 21.1+. Native frame durations.
+      get_output_blanking(...) -> {blanking} — documented on Resolve 21.1+. Pixel coordinates; empty on a clip inheriting timeline blanking.
+      get_use_timeline_for_output_blanking(...) -> {use_timeline} — documented on Resolve 21.1+.
       get_name(track_type?, track_index?, item_index?) -> {name}
       get_property(key?, ...) -> {properties}
       set_property(key, value, ...) -> {success}
@@ -26268,6 +26326,27 @@ def timeline_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[
     if err:
         return err
 
+    if action == "get_speed":
+        missing = _requires_method(item, "GetSpeed", "21.1")
+        if missing:
+            return missing
+        return {"speed": _ser(item.GetSpeed())}
+    if action == "get_fades":
+        missing = _requires_method(item, "GetFades", "21.1")
+        if missing:
+            return missing
+        return {"fades": _ser(item.GetFades())}
+    if action == "get_output_blanking":
+        missing = _requires_method(item, "GetOutputBlanking", "21.1")
+        if missing:
+            return missing
+        return {"blanking": _ser(item.GetOutputBlanking())}
+    if action == "get_use_timeline_for_output_blanking":
+        missing = _requires_method(item, "GetUseTimelineForOutputBlanking", "21.1")
+        if missing:
+            return missing
+        return {"use_timeline": _ser(item.GetUseTimelineForOutputBlanking())}
+
     if action == "get_name":
         return {"name": item.GetName()}
     elif action == "get_property":
@@ -26443,7 +26522,7 @@ def timeline_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[
             return _err(f"Invalid interpolation. Must be one of: {', '.join(valid)}")
         return {"success": bool(item.SetKeyframeInterpolation(p["property"], p["frame"], p["interpolation"]))}
 
-    return _unknown(action, ["get_name","get_property","set_property","get_duration","get_start","get_end","get_source_start_frame","get_source_end_frame","get_source_start_time","get_source_end_time","get_left_offset","get_right_offset","set_clip_enabled","get_clip_enabled","update_sidecar","get_unique_id","get_media_pool_item","get_stereo_convergence","get_stereo_left_window","get_stereo_right_window","get_linked_items","get_track_type_and_index","get_source_audio_mapping","load_burnin_preset","set_name","get_voice_isolation_state","set_voice_isolation_state","get_retime","set_retime","get_transform","set_transform","get_crop","set_crop","get_composite","set_composite","get_audio","set_audio","get_keyframes","add_keyframe","modify_keyframe","delete_keyframe","set_keyframe_interpolation"])
+    return _unknown(action, ["get_speed","get_fades","get_output_blanking","get_use_timeline_for_output_blanking","get_name","get_property","set_property","get_duration","get_start","get_end","get_source_start_frame","get_source_end_frame","get_source_start_time","get_source_end_time","get_left_offset","get_right_offset","set_clip_enabled","get_clip_enabled","update_sidecar","get_unique_id","get_media_pool_item","get_stereo_convergence","get_stereo_left_window","get_stereo_right_window","get_linked_items","get_track_type_and_index","get_source_audio_mapping","load_burnin_preset","set_name","get_voice_isolation_state","set_voice_isolation_state","get_retime","set_retime","get_transform","set_transform","get_crop","set_crop","get_composite","set_composite","get_audio","set_audio","get_keyframes","add_keyframe","modify_keyframe","delete_keyframe","set_keyframe_interpolation"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -32565,9 +32644,9 @@ if __name__ == "__main__":
     start_background_update_check(VERSION, project_dir, logger, env=_setup_update_env())
     _install_threaded_tool_dispatch(mcp)
 
-    # Support --full flag to run the 353-tool granular server instead
+    # Support --full flag to run the 365-tool granular server instead
     if "--full" in sys.argv:
-        logger.info("Starting full 353-tool granular server...")
+        logger.info("Starting full 365-tool granular server...")
         sys.argv = [arg for arg in sys.argv if arg != "--full"]
         from src.granular import mcp as granular_mcp
 

package/src/utils/resolve_versions.py

@@ -225,6 +225,20 @@ _EVIDENCE_GATES: List[Dict[str, Any]] = [
 # disagree, which is what keeps the two from drifting apart again.
 
 CODE_FLOORS: Dict[str, str] = {
+    # Documented in the shipped 21.1 scripting CHANGELOG; read-only contributor
+    # validation on Studio 21.1.0.14. No claim of a live older-build bisect.
+    "Resolve.GetKeyboardPresetList": "21.1",
+    "Resolve.GetCurrentKeyboardPreset": "21.1",
+    "Project.GetProjectSettingsPresetList": "21.1",
+    "Project.GetAudioRenderFormats": "21.1",
+    "Project.GetAudioRenderCodecs": "21.1",
+    "Timeline.GetNormalizeAudioModes": "21.1",
+    "Timeline.GetOutputBlanking": "21.1",
+    "TimelineItem.GetSpeed": "21.1",
+    "TimelineItem.GetFades": "21.1",
+    "TimelineItem.GetOutputBlanking": "21.1",
+    "TimelineItem.GetUseTimelineForOutputBlanking": "21.1",
+
     "MediaPoolItem.LinkProxyMedia": "17.0",
     "MediaPoolItem.LinkFullResolutionMedia": "20.0",
     "MediaPoolItem.MonitorGrowingFile": "20.0",