davinci-resolve-mcp 2.28.1 → 2.29.0

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 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.29.0
+
+Adds the **DaVinci Resolve 21.0** scripting-API additions. Every new method is
+runtime-detected (`_requires_method`/capability flags), so the tools stay inert
+on older Resolve builds and activate automatically on Resolve 21+.
+
+**New AI analysis actions** on the `folder` and `media_pool_item` compound tools
+(and mirrored as granular `--full` tools):
+
+- `perform_audio_classification` / `clear_audio_classification` — classify clip
+  audio into categories and subcategories.
+- `analyze_for_intellisearch(identify_faces?, is_better_mode?)` — IntelliSearch
+  analysis with optional face identification. Requires the *AI IntelliSearch* Extra.
+- `analyze_for_slate(marker_color?)` — slate/clapboard detection that drops a
+  marker of the chosen color (validated against the 16 Resolve marker colors).
+  Requires the *AI Slate ID* Extra.
+- `remove_motion_blur(deblur_option?)` — renders motion-deblurred copies. This
+  **creates new media files** (source media is never modified) and is therefore
+  **confirm-token gated**: the first call returns a preview + token, the second
+  call (with the token) runs.
+
+**Speaker-detection transcription.** `transcribe_audio` now accepts an optional
+`use_speaker_detection` boolean (Resolve 21+); omit it to use the project's
+Speech Recognition setting.
+
+**Speech generation.** `project_settings(action="generate_speech", ...)` wraps
+`Project.GenerateSpeech` (AI text-to-speech). It creates a new audio item and
+optionally places it on the timeline, so it is also confirm-token gated.
+Requires the *AI Speech Generator* Extra. Granular `--full` tool: `generate_speech`.
+
+**Session control.** `resolve_control(action="disable_background_tasks_for_current_session")`
+wraps `Resolve.DisableBackgroundTasksForCurrentResolveSession()` to quiet
+background work during heavy scripted runs.
+
+**Capability surface.** The `media_analysis` transcription-capability report and
+the control panel's boot payload (`resolve.ai_features`) now list which 21.0 AI
+methods are available and which Extras each gated method needs.
+
+Notes: these are Resolve-local GPU/AI operations and do not consume the
+Claude-side analysis token budget, so they are not metered by the analysis-caps
+layer; the derivative-creating ones are protected by the confirm-token gate
+instead. The granular `--full` server grew from 329 to 341 tools.
+
 ## What's New in v2.28.1
 
 Bug-fix release.

package/README.md

@@ -1,9 +1,9 @@
 # DaVinci Resolve MCP Server
 
-[![Version](https://img.shields.io/badge/version-2.28.1-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.29.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-32%20(329%20full)-blue.svg)](#server-modes)
+[![Tools](https://img.shields.io/badge/MCP%20Tools-32%20(341%20full)-blue.svg)](#server-modes)
 [![Tested](https://img.shields.io/badge/Live%20Tested-98.5%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/)
@@ -50,7 +50,7 @@ The command starts a localhost server and opens the control panel in your browse
 | Mode | Entry point | Tools | Best for |
 |------|-------------|-------|----------|
 | Compound | `src/server.py` | 32 | 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` | 329 | Power users who want one MCP tool per Resolve API method. |
+| Full / granular | `src/server.py --full` or `src/resolve_mcp_server.py` | 341 | 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.
 
@@ -99,7 +99,7 @@ The default server is a local stdio process launched by your MCP client; it does
 
 | Metric | Value |
 |--------|-------|
-| MCP Tools | **32** compound / **329** granular |
+| MCP Tools | **32** compound / **341** granular |
 | Kernel Actions | **136** guarded workflow actions across 9 compound tools |
 | API Methods Covered | **336/336** (100%) |
 | Methods Live Tested | **331/336** (98.5%) |
@@ -136,7 +136,7 @@ Extension authoring references live in [docs/authoring](docs/authoring/). Resolv
 - Python 3.10+ (3.10-3.12 is the lowest-risk range). Python 3.13/3.14 also work on recent Resolve builds (verified on Studio 20.3.2); older builds may fail to connect on 3.13+, in which case use 3.10-3.12.
 - Resolve external scripting set to **Local**.
 
-Resolve 19.1.3 remains the compatibility baseline. Resolve 20.x scripting calls are additive, version-guarded, and live-tested on 20.3.2. Resolve 21 beta APIs are intentionally deferred until stable.
+Resolve 19.1.3 remains the compatibility baseline. Resolve 20.x scripting calls are additive, version-guarded, and live-tested on 20.3.2. Resolve 21.0 scripting additions (audio classification, speaker-detection transcription, IntelliSearch, slate analysis, motion-deblur, speech generation, session background-task control) are exposed behind runtime capability detection, so they stay inert on older builds and activate automatically on Resolve 21+.
 
 ## Development
 

package/docs/SKILL.md

@@ -101,7 +101,7 @@ before mutating Resolve state.
 | Mode | Entry point | Tool count | Use when |
 |---|---|---|---|
 | Compound (default) | `src/server.py` | 32 tools | Most workflows — keeps context lean |
-| Granular (full) | `src/server.py --full` | 329 tools | Power users needing one tool per API method |
+| Granular (full) | `src/server.py --full` | 341 tools | Power users needing one tool per API method |
 
 This skill document covers the **compound server** (the default). Each compound
 tool accepts an `action` string and an optional `params` object.
@@ -442,7 +442,10 @@ Note: `folder path` arguments use slash notation like `"Master/SubFolder"`.
 **`folder`** — Operations on a specific Media Pool folder.
 
 Key actions: `get_clips(path?)`, `get_subfolders(path?)`, `export(path?, export_path)`,
-`transcribe_audio(path?)`, `clear_transcription(path?)`
+`transcribe_audio(path?, use_speaker_detection?)`, `clear_transcription(path?)`,
+`perform_audio_classification(path?)`, `analyze_for_intellisearch(path?, identify_faces?, is_better_mode?)`,
+`analyze_for_slate(path?, marker_color?)`, `remove_motion_blur(path?, deblur_option?)` (Resolve 21+;
+the last three need AI Extras, and `remove_motion_blur` is confirm-token gated)
 
 **`media_pool_item`** — Read/write clip metadata and properties. All actions
 require a `clip_id` (the UUID returned by `GetUniqueId()`).
@@ -452,7 +455,10 @@ Key actions: `get_name`, `get_metadata(key?)`, `set_metadata(key, value)`,
 `set_clip_color(color)`, `link_proxy(proxy_path)`, `replace_clip(path)`,
 `set_name(name)`, `link_full_resolution_media(path)`,
 `replace_clip_preserve_sub_clip(path)`, `monitor_growing_file`,
-`transcribe_audio`, `get_audio_mapping`, `get_mark_in_out`, `set_mark_in_out`
+`transcribe_audio(use_speaker_detection?)`, `perform_audio_classification`,
+`analyze_for_intellisearch(identify_faces?, is_better_mode?)`, `analyze_for_slate(marker_color?)`,
+`remove_motion_blur(deblur_option?)` (Resolve 21+; AI Extras / confirm-token gated as noted above),
+`get_audio_mapping`, `get_mark_in_out`, `set_mark_in_out`
 
 **`media_pool_item_markers`** — Markers and flags on clips in the Media Pool.
 All actions require a `clip_id`.

package/docs/contributing.md

@@ -64,7 +64,7 @@ davinci-resolve-mcp/
 ├── install.py                    # Universal installer (macOS/Windows/Linux)
 ├── src/
 │   ├── server.py                # Compound MCP server — 32 tools (default)
-│   ├── resolve_mcp_server.py    # Thin full-server entrypoint — 329 tools
+│   ├── resolve_mcp_server.py    # Thin full-server entrypoint — 341 tools
 │   ├── granular/                # Modular full-server implementation
 │   └── utils/                   # Platform detection, Resolve connection helpers
 ├── tests/                       # 5-phase live API test suite + Resolve 20 delta (331/331 pass)

package/docs/install.md

@@ -87,7 +87,7 @@ The MCP server comes in two modes:
 | Mode | File | Tools | Best For |
 |------|------|-------|----------|
 | **Compound** (default) | `src/server.py` | 32 | Most users — fast, clean, low context usage |
-| **Full** | `src/resolve_mcp_server.py` | 329 | Power users who want one tool per API method |
+| **Full** | `src/resolve_mcp_server.py` | 341 | Power users who want one tool per API method |
 
 The compound server's `timeline_item` tool includes dedicated actions for common workflows:
 
@@ -102,7 +102,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 329-tool server
+python src/server.py --full    # Launch full 341-tool server
 # Or point your MCP config directly at src/resolve_mcp_server.py
 ```
 

package/docs/reference/api-coverage.md

@@ -6,7 +6,7 @@ Complete Resolve scripting API coverage, live-test status, and method-by-method
 
 | Metric | Value |
 |--------|-------|
-| MCP Tools | **33** compound (default) / **329** granular |
+| MCP Tools | **33** compound (default) / **341** granular |
 | Kernel Actions | **136** guarded MCP workflow actions across 9 compound tools |
 | API Methods Covered | **336/336** (100%) |
 | Methods Live Tested | **331/336** (98.5%) |
@@ -17,7 +17,7 @@ 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 **33 tools** that group related operations by action parameter, keeping LLM context windows lean. The full granular server provides **329 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 DaVinci Resolve Scripting API is covered. The default compound server exposes **33 tools** that group related operations by action parameter, keeping LLM context windows lean. The full granular server provides **341 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).
 
 The 33rd compound tool is `timeline_versioning` (C6) — an MCP-level workflow
 tool, not a wrapper around a Resolve API method. It surfaces the

package/docs/reference/resolve_scripting_api.txt

@@ -1,4 +1,4 @@
-Last Updated: 7 Oct 2025
+Last Updated: 5 May 2026
 -------------------------
 In this package, you will find a brief introduction to the Scripting API for DaVinci Resolve Studio. Apart from this README.txt file, this package contains folders containing the basic import
 modules for scripting access (DaVinciResolve.py) and some representative examples.
@@ -105,6 +105,7 @@ Resolve
   GetKeyframeMode()                               --> keyframeMode       # Returns the currently set keyframe mode (int). Refer to section 'Keyframe Mode information' below for details.
   SetKeyframeMode(keyframeMode)                   --> Bool               # Returns True when 'keyframeMode'(enum) is successfully set. Refer to section 'Keyframe Mode information' below for details.
   GetFairlightPresets()                           --> [presetNames...].  # Returns a list of Fairlight presets by name
+  DisableBackgroundTasksForCurrentResolveSession()--> None               # Disables all background tasks for current Resolve session.
 
 ProjectManager
   ArchiveProject(projectName,
@@ -199,6 +200,7 @@ Project
   AddColorGroup(groupName)                        --> ColorGroup         # Creates a new ColorGroup. groupName must be a unique string.
   DeleteColorGroup(colorGroup)                    --> Bool               # Deletes the given color group and sets clips to ungrouped.
   ApplyFairlightPresetToCurrentTimeline(name)     --> Bool               # Apply Fairlight Preset of given name to the current timeline, returns True if successful, False otherwise.
+  GenerateSpeech({speechGenerationSettings}, timecode) --> MediaPoolItem # Generates an audio MediaPoolItem based on the given speechGenerationSettings and adds it to the timeline at the stated timecode if "AddToTimeline" is True. Returns the newly generated MediaPoolItem.
 
 MediaStorage
   GetMountedVolumeList()                          --> [paths...]         # Returns list of folder paths corresponding to mounted volumes displayed in Resolve’s Media Storage.
@@ -263,8 +265,13 @@ Folder
   GetIsFolderStale()                              --> bool               # Returns true if folder is stale in collaboration mode, false otherwise
   GetUniqueId()                                   --> string             # Returns a unique ID for the media pool folder
   Export(filePath)                                --> bool               # Returns true if export of DRB folder to filePath is successful, false otherwise
-  TranscribeAudio()                               --> Bool               # Transcribes audio of the MediaPoolItems within the folder and nested folders. Returns True if successful; False otherwise
+  TranscribeAudio(useSpeakerDetection=None)       --> Bool               # Transcribes audio of the MediaPoolItems within the folder and nested folders. Returns True if successful; False otherwise
   ClearTranscription()                            --> Bool               # Clears audio transcription of the MediaPoolItems within the folder and nested folders. Returns True if successful; False otherwise.
+  PerformAudioClassification()                    --> Bool               # Analyzes and classifies the audio of the MediaPoolItems within the folder and nested folders into categories and subcategories.
+  ClearAudioClassification()                      --> Bool               # Clears audio classification of the MediaPoolItems within the folder and nested folders.
+  RemoveMotionBlur({deblurOption})                --> [[MediaPoolItem, MediaPoolItem]...]   # Applies motion deblur on MediaPoolItems in the folder. Returns a list of pairs mapping original to newly created MediaPoolItems.
+  AnalyzeForIntellisearch(identifyFaces, isBetterMode) --> Bool          # Performs Intellisearch analysis on all MediaPoolItems in the folder. identifyFaces specifies whether to identify faces; isBetterMode specifies whether to use Better mode. Returns True if required packages are installed and analysis is successful.
+  AnalyzeForSlate(markerColor)                    --> Bool               # Performs Slate analysis on all MediaPoolItems in the folder using the current settings and specified markerColor. Returns True if required packages are installed and analysis is successful.
 
 MediaPoolItem
   GetName()                                       --> string             # Returns the clip name.
@@ -304,8 +311,13 @@ MediaPoolItem
   ReplaceClip(filePath)                           --> Bool               # Replaces the underlying asset and metadata of MediaPoolItem with the specified absolute clip path.
   ReplaceClipPreserveSubClip(filePath)            --> Bool               # Replaces the underlying asset and metadata of a video or audio clip with the specified absolute clip path, preserving original sub clip extents.
   GetUniqueId()                                   --> string             # Returns a unique ID for the media pool item
-  TranscribeAudio()                               --> Bool               # Transcribes audio of the MediaPoolItem. Returns True if successful; False otherwise
+  TranscribeAudio(useSpeakerDetection=None)       --> Bool               # Transcribes audio of the MediaPoolItem. Returns True if successful; False otherwise
   ClearTranscription()                            --> Bool               # Clears audio transcription of the MediaPoolItem. Returns True if successful; False otherwise.
+  PerformAudioClassification()                    --> Bool               # Analyzes and classifies the audio of a MediaPoolItem into categories and subcategories.
+  ClearAudioClassification()                      --> Bool               # Clears audio classification of the MediaPoolItem.
+  RemoveMotionBlur({deblurOption})                --> MediaPoolItem      # Applies motion deblur on the MediaPoolItem. Returns the newly created MediaPoolItem.
+  AnalyzeForIntellisearch(identifyFaces, isBetterMode) --> Bool          # Performs Intellisearch analysis on the MediaPoolItem. identifyFaces specifies whether to identify faces; isBetterMode specifies whether to use Better mode. Returns True if required packages are installed and analysis is successful.
+  AnalyzeForSlate(markerColor)                    --> Bool               # Performs Slate analysis on the MediaPoolItem using the current settings and specified markerColor. Returns True if required packages are installed and analysis is successful.
   GetAudioMapping()                               --> json formatted string # Returns a string with MediaPoolItem's audio mapping information. Check 'Audio Mapping' section below for more information.
   GetMarkInOut()                                  --> {mark}             # Returns dict of in/out marks set (keys omitted if not set), example:
                                                                          # {'video': {'in': 0, 'out': 134}, 'audio': {'in': 0, 'out': 134}}

package/install.py

@@ -35,7 +35,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.28.1"
+VERSION = "2.29.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

package/package.json

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

package/src/analysis_dashboard.py

@@ -10654,6 +10654,45 @@ def _current_resolve_project_id() -> Tuple[Optional[str], Optional[str]]:
 
 
 @_serialize_resolve
+def _resolve_ai_features(resolve: Any) -> Dict[str, Any]:
+    """Report which Resolve 21.0 AI scripting methods are available on the
+    connected build, plus the Extra each AI-gated method requires. Presence is
+    detected via getattr (no Resolve round-trips beyond fetching the handles),
+    so this stays cheap enough for the boot handshake.
+    """
+    def has(obj: Any, name: str) -> bool:
+        return bool(obj) and callable(getattr(obj, name, None))
+
+    project = folder = None
+    try:
+        pm = resolve.GetProjectManager()
+        project = pm.GetCurrentProject() if pm else None
+        mp = project.GetMediaPool() if project else None
+        folder = mp.GetRootFolder() if mp else None
+    except Exception:
+        pass
+
+    features = {
+        "disable_background_tasks": has(resolve, "DisableBackgroundTasksForCurrentResolveSession"),
+        "generate_speech": has(project, "GenerateSpeech"),
+        "perform_audio_classification": has(folder, "PerformAudioClassification"),
+        "clear_audio_classification": has(folder, "ClearAudioClassification"),
+        "analyze_for_intellisearch": has(folder, "AnalyzeForIntellisearch"),
+        "analyze_for_slate": has(folder, "AnalyzeForSlate"),
+        "remove_motion_blur": has(folder, "RemoveMotionBlur"),
+    }
+    return {
+        "features": features,
+        "available_count": sum(1 for v in features.values() if v),
+        # Methods that additionally need an Extras download to actually run.
+        "requires_extra": {
+            "analyze_for_intellisearch": "AI IntelliSearch",
+            "analyze_for_slate": "AI Slate ID",
+            "generate_speech": "AI Speech Generator",
+        },
+    }
+
+
 def _resolve_identity() -> Dict[str, Any]:
     resolve, error = _connect_resolve_read_only()
     if not resolve:
@@ -10668,6 +10707,7 @@ def _resolve_identity() -> Dict[str, Any]:
         "version_string": str(version_string) if version_string else None,
         "version": list(version_tuple) if isinstance(version_tuple, (list, tuple)) else None,
         "page": str(page) if page else None,
+        "ai_features": _resolve_ai_features(resolve),
     }
 
 

package/src/granular/common.py

@@ -80,7 +80,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.28.1"
+VERSION = "2.29.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/folder.py

@@ -294,3 +294,127 @@ def folder_clear_transcription(folder_path: str = "") -> Dict[str, Any]:
         folder = mp.GetCurrentFolder()
     result = folder.ClearTranscription()
     return {"success": bool(result)}
+
+
+def _resolve_folder(mp, folder_path):
+    """Return (folder, error). Empty path -> current folder."""
+    if folder_path:
+        folder = _navigate_to_folder(mp, folder_path)
+        if not folder:
+            return None, {"error": f"Folder '{folder_path}' not found"}
+        return folder, None
+    return mp.GetCurrentFolder(), None
+
+
+_MARKER_COLORS = [
+    "Blue", "Cyan", "Green", "Yellow", "Red", "Pink", "Purple", "Fuchsia",
+    "Rose", "Lavender", "Sky", "Mint", "Lemon", "Sand", "Cocoa", "Cream",
+]
+
+
+@mcp.tool()
+def folder_perform_audio_classification(folder_path: str = "") -> Dict[str, Any]:
+    """Classify audio of all clips in a Media Pool folder into categories (Resolve 21+).
+
+    Args:
+        folder_path: Path from root. Empty for current folder.
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    folder, err = _resolve_folder(mp, folder_path)
+    if err:
+        return err
+    if not hasattr(folder, "PerformAudioClassification"):
+        return {"error": "PerformAudioClassification requires DaVinci Resolve 21+"}
+    return {"success": bool(folder.PerformAudioClassification())}
+
+
+@mcp.tool()
+def folder_clear_audio_classification(folder_path: str = "") -> Dict[str, Any]:
+    """Clear audio classification for all clips in a Media Pool folder (Resolve 21+).
+
+    Args:
+        folder_path: Path from root. Empty for current folder.
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    folder, err = _resolve_folder(mp, folder_path)
+    if err:
+        return err
+    if not hasattr(folder, "ClearAudioClassification"):
+        return {"error": "ClearAudioClassification requires DaVinci Resolve 21+"}
+    return {"success": bool(folder.ClearAudioClassification())}
+
+
+@mcp.tool()
+def folder_analyze_for_intellisearch(folder_path: str = "", identify_faces: bool = False, is_better_mode: bool = False) -> Dict[str, Any]:
+    """Run IntelliSearch analysis on all clips in a folder (Resolve 21+, requires AI IntelliSearch Extra).
+
+    Args:
+        folder_path: Path from root. Empty for current folder.
+        identify_faces: Whether to identify faces.
+        is_better_mode: Use Better mode (vs Faster).
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    folder, err = _resolve_folder(mp, folder_path)
+    if err:
+        return err
+    if not hasattr(folder, "AnalyzeForIntellisearch"):
+        return {"error": "AnalyzeForIntellisearch requires DaVinci Resolve 21+"}
+    return {"success": bool(folder.AnalyzeForIntellisearch(bool(identify_faces), bool(is_better_mode)))}
+
+
+@mcp.tool()
+def folder_analyze_for_slate(folder_path: str = "", marker_color: str = "Blue") -> Dict[str, Any]:
+    """Run Slate analysis on all clips in a folder (Resolve 21+, requires AI Slate ID Extra).
+
+    Args:
+        folder_path: Path from root. Empty for current folder.
+        marker_color: Marker color for detected slates (Blue, Cyan, Green, Yellow, Red, Pink,
+            Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream).
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    folder, err = _resolve_folder(mp, folder_path)
+    if err:
+        return err
+    if not hasattr(folder, "AnalyzeForSlate"):
+        return {"error": "AnalyzeForSlate requires DaVinci Resolve 21+"}
+    if marker_color not in _MARKER_COLORS:
+        return {"error": f"Invalid marker_color '{marker_color}'. Valid: {', '.join(_MARKER_COLORS)}"}
+    return {"success": bool(folder.AnalyzeForSlate(marker_color))}
+
+
+@mcp.tool()
+def folder_remove_motion_blur(folder_path: str = "", deblur_option: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Render motion-deblurred copies of all clips in a folder (Resolve 21+).
+
+    Creates NEW media files; source media is not modified.
+
+    Args:
+        folder_path: Path from root. Empty for current folder.
+        deblur_option: Settings dict (FileName, Format, Codec, EncodingProfile,
+            UseExtremeMode, UseMarkInMarkOut, RenderAtSourceRes, UseMoreGpuMemory).
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    folder, err = _resolve_folder(mp, folder_path)
+    if err:
+        return err
+    if not hasattr(folder, "RemoveMotionBlur"):
+        return {"error": "RemoveMotionBlur requires DaVinci Resolve 21+"}
+    result = folder.RemoveMotionBlur(deblur_option or {})
+    created = []
+    for pair in (result or []):
+        try:
+            orig, new = pair
+            created.append({"original": orig.GetName(), "new": new.GetName(), "new_id": new.GetUniqueId()})
+        except Exception:
+            continue
+    return {"success": bool(result), "created": created}

package/src/granular/media_pool_item.py

@@ -909,3 +909,112 @@ def clear_clip_mark_in_out(clip_id: str) -> Dict[str, Any]:
         return {"error": f"Clip {clip_id} not found"}
     result = clip.ClearMarkInOut()
     return {"success": bool(result)}
+
+
+_MARKER_COLORS = [
+    "Blue", "Cyan", "Green", "Yellow", "Red", "Pink", "Purple", "Fuchsia",
+    "Rose", "Lavender", "Sky", "Mint", "Lemon", "Sand", "Cocoa", "Cream",
+]
+
+
+@mcp.tool()
+def perform_clip_audio_classification(clip_id: str) -> Dict[str, Any]:
+    """Classify a clip's audio into categories and subcategories (Resolve 21+).
+
+    Args:
+        clip_id: Unique ID of the clip.
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
+    if not clip:
+        return {"error": f"Clip {clip_id} not found"}
+    if not hasattr(clip, "PerformAudioClassification"):
+        return {"error": "PerformAudioClassification requires DaVinci Resolve 21+"}
+    return {"success": bool(clip.PerformAudioClassification())}
+
+
+@mcp.tool()
+def clear_clip_audio_classification(clip_id: str) -> Dict[str, Any]:
+    """Clear a clip's audio classification (Resolve 21+).
+
+    Args:
+        clip_id: Unique ID of the clip.
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
+    if not clip:
+        return {"error": f"Clip {clip_id} not found"}
+    if not hasattr(clip, "ClearAudioClassification"):
+        return {"error": "ClearAudioClassification requires DaVinci Resolve 21+"}
+    return {"success": bool(clip.ClearAudioClassification())}
+
+
+@mcp.tool()
+def analyze_clip_for_intellisearch(clip_id: str, identify_faces: bool = False, is_better_mode: bool = False) -> Dict[str, Any]:
+    """Run IntelliSearch analysis on a clip (Resolve 21+, requires AI IntelliSearch Extra).
+
+    Args:
+        clip_id: Unique ID of the clip.
+        identify_faces: Whether to identify faces.
+        is_better_mode: Use Better mode (vs Faster).
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
+    if not clip:
+        return {"error": f"Clip {clip_id} not found"}
+    if not hasattr(clip, "AnalyzeForIntellisearch"):
+        return {"error": "AnalyzeForIntellisearch requires DaVinci Resolve 21+"}
+    return {"success": bool(clip.AnalyzeForIntellisearch(bool(identify_faces), bool(is_better_mode)))}
+
+
+@mcp.tool()
+def analyze_clip_for_slate(clip_id: str, marker_color: str = "Blue") -> Dict[str, Any]:
+    """Run Slate analysis on a clip (Resolve 21+, requires AI Slate ID Extra).
+
+    Args:
+        clip_id: Unique ID of the clip.
+        marker_color: Marker color for detected slates (Blue, Cyan, Green, Yellow, Red, Pink,
+            Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream).
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
+    if not clip:
+        return {"error": f"Clip {clip_id} not found"}
+    if not hasattr(clip, "AnalyzeForSlate"):
+        return {"error": "AnalyzeForSlate requires DaVinci Resolve 21+"}
+    if marker_color not in _MARKER_COLORS:
+        return {"error": f"Invalid marker_color '{marker_color}'. Valid: {', '.join(_MARKER_COLORS)}"}
+    return {"success": bool(clip.AnalyzeForSlate(marker_color))}
+
+
+@mcp.tool()
+def remove_clip_motion_blur(clip_id: str, deblur_option: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Render a motion-deblurred copy of a clip (Resolve 21+).
+
+    Creates a NEW media file; the source clip is not modified.
+
+    Args:
+        clip_id: Unique ID of the clip.
+        deblur_option: Settings dict (FileName, Format, Codec, EncodingProfile,
+            UseExtremeMode, UseMarkInMarkOut, RenderAtSourceRes, UseMoreGpuMemory).
+    """
+    _, mp, err = _get_mp()
+    if err:
+        return err
+    clip = _find_clip_by_id(mp.GetRootFolder(), clip_id)
+    if not clip:
+        return {"error": f"Clip {clip_id} not found"}
+    if not hasattr(clip, "RemoveMotionBlur"):
+        return {"error": "RemoveMotionBlur requires DaVinci Resolve 21+"}
+    new_clip = clip.RemoveMotionBlur(deblur_option or {})
+    if not new_clip:
+        return {"success": False}
+    return {"success": True, "new": new_clip.GetName(), "new_id": new_clip.GetUniqueId()}

package/src/granular/project.py

@@ -1592,3 +1592,59 @@ def load_cloud_project(project_name: str, project_media_path: str, sync_mode: st
     if project:
         return {"success": True, "project_name": project.GetName()}
     return {"success": False, "error": "Failed to load cloud project. Check cloud settings and connectivity."}
+
+
+@mcp.tool()
+def generate_speech(text_input: str, voice_model: str = "", timecode: str = "",
+                    add_to_timeline: bool = False, audio_track: Optional[int] = None,
+                    custom_voice_file: str = "", speed: Optional[int] = None,
+                    variation: Optional[int] = None, pitch: Optional[int] = None,
+                    generation_id: Optional[int] = None, filename: str = "") -> Dict[str, Any]:
+    """Generate AI text-to-speech audio and add it to the media pool (Resolve 21+).
+
+    Requires the AI Speech Generator Extra. Creates a NEW audio MediaPoolItem; if
+    add_to_timeline is True it is placed on the timeline at the given timecode.
+
+    Args:
+        text_input: Text to synthesize (required).
+        voice_model: Voice model name (e.g. "Female 1", "Male 1", "Custom Voice").
+        timecode: Timeline timecode to place the clip at when add_to_timeline is True.
+        add_to_timeline: Whether to add the generated clip to the timeline.
+        audio_track: Audio track index for timeline placement.
+        custom_voice_file: Full path to a custom voice file (for "Custom Voice").
+        speed: Speech speed.
+        variation: Voice variation.
+        pitch: Voice pitch.
+        generation_id: Generation ID.
+        filename: Output filename.
+    """
+    pm, current_project = get_current_project()
+    if not current_project:
+        return {"error": "No project currently open"}
+    if not hasattr(current_project, "GenerateSpeech"):
+        return {"error": "GenerateSpeech requires DaVinci Resolve 21+ and the AI Speech Generator Extra"}
+    if not text_input:
+        return {"error": "text_input is required"}
+    settings: Dict[str, Any] = {"TextInput": text_input}
+    if voice_model:
+        settings["VoiceModel"] = voice_model
+    if custom_voice_file:
+        settings["CustomVoiceFile"] = custom_voice_file
+    if speed is not None:
+        settings["Speed"] = speed
+    if variation is not None:
+        settings["Variation"] = variation
+    if pitch is not None:
+        settings["Pitch"] = pitch
+    if generation_id is not None:
+        settings["GenerationID"] = generation_id
+    if filename:
+        settings["Filename"] = filename
+    if add_to_timeline:
+        settings["AddToTimeline"] = True
+        if audio_track is not None:
+            settings["AudioTrack"] = audio_track
+    new_item = current_project.GenerateSpeech(settings, timecode or "")
+    if not new_item:
+        return {"success": False, "error": "GenerateSpeech returned no media item"}
+    return {"success": True, "new": new_item.GetName(), "new_id": new_item.GetUniqueId()}

package/src/granular/resolve_control.py

@@ -293,6 +293,23 @@ def delete_layout_preset_tool(preset_name: str) -> Dict[str, Any]:
     return {"success": bool(result), "preset_name": preset_name}
 
 
+@mcp.tool()
+def disable_background_tasks_for_current_session() -> Dict[str, Any]:
+    """Disable all background tasks for the current Resolve session (Resolve 21+).
+
+    Useful before heavy scripted operations so Resolve does not run background
+    work that competes for resources. Resets when Resolve restarts.
+    """
+    resolve = get_resolve()
+    if resolve is None:
+        return {"error": "Not connected to DaVinci Resolve"}
+    missing = _requires_method(resolve, "DisableBackgroundTasksForCurrentResolveSession", "21.0")
+    if missing:
+        return missing
+    resolve.DisableBackgroundTasksForCurrentResolveSession()
+    return {"success": True}
+
+
 @mcp.resource("resolve://app/state")
 def get_app_state_endpoint() -> Dict[str, Any]:
     """Get DaVinci Resolve application state information."""

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} (329 granular tools)")
+        logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION} (341 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 329-tool granular server instead
+    python src/server.py --full       # Start the 341-tool granular server instead
 """
 
-VERSION = "2.28.1"
+VERSION = "2.29.0"
 
 import base64
 import os
@@ -658,6 +658,12 @@ _TOKEN_GATED_DESTRUCTIVE_ACTIONS = frozenset({
     ("timeline", "delete_track"),
     ("graph", "apply_grade_from_drx"),
     ("graph", "reset_all_grades"),
+    # 21.0 AI ops that render/generate NEW media files (additive, but expensive
+    # and irreversible without manual cleanup) — gated so they never run by
+    # surprise. They never modify source media.
+    ("folder", "remove_motion_blur"),
+    ("media_pool_item", "remove_motion_blur"),
+    ("project_settings", "generate_speech"),
 })
 
 
@@ -5404,6 +5410,11 @@ def _transcription_capabilities(mp, p: Dict[str, Any]):
                 "summary": _media_pool_item_summary(clip),
                 "transcribe_audio": _has_method(clip, "TranscribeAudio"),
                 "clear_transcription": _has_method(clip, "ClearTranscription"),
+                "perform_audio_classification": _has_method(clip, "PerformAudioClassification"),
+                "clear_audio_classification": _has_method(clip, "ClearAudioClassification"),
+                "analyze_for_intellisearch": _has_method(clip, "AnalyzeForIntellisearch"),
+                "analyze_for_slate": _has_method(clip, "AnalyzeForSlate"),
+                "remove_motion_blur": _has_method(clip, "RemoveMotionBlur"),
             }
             for clip in clips
         ],
@@ -5411,10 +5422,16 @@ def _transcription_capabilities(mp, p: Dict[str, Any]):
             "name": current_folder.GetName() if current_folder else None,
             "transcribe_audio": _has_method(current_folder, "TranscribeAudio") if current_folder else False,
             "clear_transcription": _has_method(current_folder, "ClearTranscription") if current_folder else False,
+            "perform_audio_classification": _has_method(current_folder, "PerformAudioClassification") if current_folder else False,
+            "clear_audio_classification": _has_method(current_folder, "ClearAudioClassification") if current_folder else False,
+            "analyze_for_intellisearch": _has_method(current_folder, "AnalyzeForIntellisearch") if current_folder else False,
+            "analyze_for_slate": _has_method(current_folder, "AnalyzeForSlate") if current_folder else False,
+            "remove_motion_blur": _has_method(current_folder, "RemoveMotionBlur") if current_folder else False,
         },
         "notes": [
-            "This action reports capability only; use media_pool_item/folder transcription actions to mutate disposable or approved clips.",
-            "Transcription may require Resolve Studio AI components and can run asynchronously.",
+            "This action reports capability only; use media_pool_item/folder actions to mutate disposable or approved clips.",
+            "Transcription/audio-classification may require Resolve Studio AI components and can run asynchronously.",
+            "analyze_for_intellisearch requires the 'AI IntelliSearch' Extra; analyze_for_slate requires 'AI Slate ID'; remove_motion_blur creates new media and is confirm-gated (Resolve 21+).",
         ],
     }
 
@@ -10336,6 +10353,7 @@ def resolve_control(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
       quit() -> {success}
       get_fairlight_presets() -> {presets}
       set_high_priority() -> {success}
+      disable_background_tasks_for_current_session() -> {success}  — Resolve 21+
       open_control_panel(port?, host?, open_browser?) -> {success, url, pid, port, status}
         — Launches the analysis control panel (src/analysis_dashboard.py) as a background process.
           Idempotent: returns the existing URL if already running.
@@ -10429,7 +10447,13 @@ def resolve_control(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
         return {"presets": _ser(r.GetFairlightPresets())}
     elif action == "set_high_priority":
         return {"success": bool(r.SetHighPriority())}
-    return _unknown(action, ["launch","get_version","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","open_control_panel","control_panel_status","close_control_panel","save_state","restore_state"])
+    elif action == "disable_background_tasks_for_current_session":
+        missing = _requires_method(r, "DisableBackgroundTasksForCurrentResolveSession", "21.0")
+        if missing:
+            return missing
+        r.DisableBackgroundTasksForCurrentResolveSession()
+        return _ok()
+    return _unknown(action, ["launch","get_version","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","open_control_panel","control_panel_status","close_control_panel","save_state","restore_state"])
 
 
 # ─── V2 C4: Per-field corrections with provenance + changelog ────────────────
@@ -12327,6 +12351,7 @@ def project_settings(action: str, params: Optional[Dict[str, Any]] = None) -> Di
       add_color_group(name) -> {success, name}
       delete_color_group(name) -> {success}
       apply_fairlight_preset(preset_name) -> {success}
+      generate_speech(speech_generation_settings, timecode?) -> {success, new, new_id}  — Resolve 21+, AI Speech Generator; creates new audio media (confirm-gated)
     """
     p = params or {}
     _, proj, err = _check()
@@ -12376,7 +12401,37 @@ def project_settings(action: str, params: Optional[Dict[str, Any]] = None) -> Di
         if missing:
             return missing
         return {"success": bool(proj.ApplyFairlightPresetToCurrentTimeline(p["preset_name"]))}
-    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","load_burnin_preset","insert_audio","get_color_groups","add_color_group","delete_color_group","apply_fairlight_preset"])
+    elif action == "generate_speech":
+        missing = _requires_method(proj, "GenerateSpeech", "21.0")
+        if missing:
+            return missing
+        settings = _first_param(p, "speech_generation_settings", "speechGenerationSettings", "settings", default=None) or {}
+        if not isinstance(settings, dict) or not settings.get("TextInput"):
+            return _err("generate_speech requires speech_generation_settings with a 'TextInput' string. "
+                        "Optional keys: VoiceModel, CustomVoiceFile, Speed, Variation, Pitch, GenerationID, Filename, AddToTimeline, AudioTrack.")
+        timecode = _first_param(p, "timecode", default="") or ""
+        if "confirm_token" not in p and "confirmToken" not in p and _confirm_token_required():
+            return _issue_confirm_token(
+                action="project_settings.generate_speech",
+                params=p,
+                preview={
+                    "operation": "project_settings.generate_speech",
+                    "warning": "Generates a NEW AI text-to-speech audio item"
+                               + (" and adds it to the timeline." if settings.get("AddToTimeline") else "."),
+                    "text_input": settings.get("TextInput"),
+                    "voice_model": settings.get("VoiceModel"),
+                    "add_to_timeline": bool(settings.get("AddToTimeline")),
+                    "timecode": timecode,
+                },
+            )
+        blocked = _consume_confirm_token(action="project_settings.generate_speech", params=p)
+        if blocked:
+            return blocked
+        new_item = proj.GenerateSpeech(settings, timecode)
+        if not new_item:
+            return {"success": False}
+        return {"success": True, "new": new_item.GetName(), "new_id": new_item.GetUniqueId()}
+    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","load_burnin_preset","insert_audio","get_color_groups","add_color_group","delete_color_group","apply_fairlight_preset","generate_speech"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -13316,8 +13371,13 @@ def folder(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, An
       is_stale(path?) -> {stale}
       get_unique_id(path?) -> {id}
       export(path?, export_path) -> {success}
-      transcribe_audio(path?) -> {success}
+      transcribe_audio(path?, use_speaker_detection?) -> {success}  — use_speaker_detection is Resolve 21+
       clear_transcription(path?) -> {success}
+      perform_audio_classification(path?) -> {success}  — Resolve 21+
+      clear_audio_classification(path?) -> {success}  — Resolve 21+
+      analyze_for_intellisearch(path?, identify_faces?, is_better_mode?) -> {success}  — Resolve 21+, AI IntelliSearch Extra
+      analyze_for_slate(path?, marker_color?) -> {success}  — Resolve 21+, AI Slate ID Extra
+      remove_motion_blur(path?, deblur_option?) -> {success, created}  — Resolve 21+; renders NEW media (confirm-gated)
     """
     p = params or {}
     _, _, mp, err = _get_mp()
@@ -13344,10 +13404,66 @@ def folder(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, An
     elif action == "export":
         return {"success": bool(f.Export(p["export_path"]))}
     elif action == "transcribe_audio":
-        return {"success": bool(f.TranscribeAudio())}
+        usd = _first_param(p, "use_speaker_detection", "useSpeakerDetection")
+        if usd is None:
+            return {"success": bool(f.TranscribeAudio())}
+        return {"success": bool(f.TranscribeAudio(bool(usd)))}
     elif action == "clear_transcription":
         return {"success": bool(f.ClearTranscription())}
-    return _unknown(action, ["get_clips","get_name","get_subfolders","is_stale","get_unique_id","export","transcribe_audio","clear_transcription"])
+    elif action == "perform_audio_classification":
+        missing = _requires_method(f, "PerformAudioClassification", "21.0")
+        if missing:
+            return missing
+        return {"success": bool(f.PerformAudioClassification())}
+    elif action == "clear_audio_classification":
+        missing = _requires_method(f, "ClearAudioClassification", "21.0")
+        if missing:
+            return missing
+        return {"success": bool(f.ClearAudioClassification())}
+    elif action == "analyze_for_intellisearch":
+        missing = _requires_method(f, "AnalyzeForIntellisearch", "21.0")
+        if missing:
+            return missing
+        identify_faces = bool(_first_param(p, "identify_faces", "identifyFaces", default=False))
+        is_better_mode = bool(_first_param(p, "is_better_mode", "isBetterMode", default=False))
+        return {"success": bool(f.AnalyzeForIntellisearch(identify_faces, is_better_mode))}
+    elif action == "analyze_for_slate":
+        missing = _requires_method(f, "AnalyzeForSlate", "21.0")
+        if missing:
+            return missing
+        marker_color = _first_param(p, "marker_color", "markerColor", default="Blue")
+        if marker_color not in _MARKER_COLORS:
+            return _err(f"Invalid marker_color {marker_color!r}. Valid colors: {', '.join(_MARKER_COLORS)}")
+        return {"success": bool(f.AnalyzeForSlate(marker_color))}
+    elif action == "remove_motion_blur":
+        missing = _requires_method(f, "RemoveMotionBlur", "21.0")
+        if missing:
+            return missing
+        deblur = _first_param(p, "deblur_option", "deblurOption", default=None) or {}
+        if "confirm_token" not in p and "confirmToken" not in p and _confirm_token_required():
+            return _issue_confirm_token(
+                action="folder.remove_motion_blur",
+                params=p,
+                preview={
+                    "operation": "folder.remove_motion_blur",
+                    "warning": "Renders NEW deblurred media files for clips in the folder; source media is not modified.",
+                    "folder": f.GetName(),
+                    "deblur_option": deblur,
+                },
+            )
+        blocked = _consume_confirm_token(action="folder.remove_motion_blur", params=p)
+        if blocked:
+            return blocked
+        result = f.RemoveMotionBlur(deblur)
+        created = []
+        for pair in (result or []):
+            try:
+                orig, new = pair
+                created.append({"original": orig.GetName(), "new": new.GetName(), "new_id": new.GetUniqueId()})
+            except Exception:
+                continue
+        return {"success": bool(result), "created": created}
+    return _unknown(action, ["get_clips","get_name","get_subfolders","is_stale","get_unique_id","export","transcribe_audio","clear_transcription","perform_audio_classification","clear_audio_classification","analyze_for_intellisearch","analyze_for_slate","remove_motion_blur"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -13378,8 +13494,13 @@ def media_pool_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
       monitor_growing_file(clip_id) -> {success}
       replace_clip_preserve_sub_clip(clip_id, path) -> {success}
       get_unique_id(clip_id) -> {id}
-      transcribe_audio(clip_id) -> {success}
+      transcribe_audio(clip_id, use_speaker_detection?) -> {success}  — use_speaker_detection is Resolve 21+
       clear_transcription(clip_id) -> {success}
+      perform_audio_classification(clip_id) -> {success}  — Resolve 21+
+      clear_audio_classification(clip_id) -> {success}  — Resolve 21+
+      analyze_for_intellisearch(clip_id, identify_faces?, is_better_mode?) -> {success}  — Resolve 21+, AI IntelliSearch Extra
+      analyze_for_slate(clip_id, marker_color?) -> {success}  — Resolve 21+, AI Slate ID Extra
+      remove_motion_blur(clip_id, deblur_option?) -> {success, new, new_id}  — Resolve 21+; renders NEW media (confirm-gated)
       get_audio_mapping(clip_id) -> {mapping}
       get_mark_in_out(clip_id) -> {mark}
       set_mark_in_out(clip_id, mark_in, mark_out, type?) -> {success}
@@ -13570,9 +13691,60 @@ def media_pool_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
     elif action == "get_unique_id":
         return {"id": clip.GetUniqueId()}
     elif action == "transcribe_audio":
-        return {"success": bool(clip.TranscribeAudio())}
+        usd = _first_param(p, "use_speaker_detection", "useSpeakerDetection")
+        if usd is None:
+            return {"success": bool(clip.TranscribeAudio())}
+        return {"success": bool(clip.TranscribeAudio(bool(usd)))}
     elif action == "clear_transcription":
         return {"success": bool(clip.ClearTranscription())}
+    elif action == "perform_audio_classification":
+        missing = _requires_method(clip, "PerformAudioClassification", "21.0")
+        if missing:
+            return missing
+        return {"success": bool(clip.PerformAudioClassification())}
+    elif action == "clear_audio_classification":
+        missing = _requires_method(clip, "ClearAudioClassification", "21.0")
+        if missing:
+            return missing
+        return {"success": bool(clip.ClearAudioClassification())}
+    elif action == "analyze_for_intellisearch":
+        missing = _requires_method(clip, "AnalyzeForIntellisearch", "21.0")
+        if missing:
+            return missing
+        identify_faces = bool(_first_param(p, "identify_faces", "identifyFaces", default=False))
+        is_better_mode = bool(_first_param(p, "is_better_mode", "isBetterMode", default=False))
+        return {"success": bool(clip.AnalyzeForIntellisearch(identify_faces, is_better_mode))}
+    elif action == "analyze_for_slate":
+        missing = _requires_method(clip, "AnalyzeForSlate", "21.0")
+        if missing:
+            return missing
+        marker_color = _first_param(p, "marker_color", "markerColor", default="Blue")
+        if marker_color not in _MARKER_COLORS:
+            return _err(f"Invalid marker_color {marker_color!r}. Valid colors: {', '.join(_MARKER_COLORS)}")
+        return {"success": bool(clip.AnalyzeForSlate(marker_color))}
+    elif action == "remove_motion_blur":
+        missing = _requires_method(clip, "RemoveMotionBlur", "21.0")
+        if missing:
+            return missing
+        deblur = _first_param(p, "deblur_option", "deblurOption", default=None) or {}
+        if "confirm_token" not in p and "confirmToken" not in p and _confirm_token_required():
+            return _issue_confirm_token(
+                action="media_pool_item.remove_motion_blur",
+                params=p,
+                preview={
+                    "operation": "media_pool_item.remove_motion_blur",
+                    "warning": "Renders a NEW deblurred media file; the source clip is not modified.",
+                    "clip": clip.GetName(),
+                    "deblur_option": deblur,
+                },
+            )
+        blocked = _consume_confirm_token(action="media_pool_item.remove_motion_blur", params=p)
+        if blocked:
+            return blocked
+        new_clip = clip.RemoveMotionBlur(deblur)
+        if not new_clip:
+            return {"success": False}
+        return {"success": True, "new": new_clip.GetName(), "new_id": new_clip.GetUniqueId()}
     elif action == "get_audio_mapping":
         return {"mapping": clip.GetAudioMapping()}
     elif action == "get_mark_in_out":
@@ -13581,7 +13753,7 @@ def media_pool_item(action: str, params: Optional[Dict[str, Any]] = None) -> Dic
         return {"success": bool(clip.SetMarkInOut(p["mark_in"], p["mark_out"], p.get("type", "all")))}
     elif action == "clear_mark_in_out":
         return {"success": bool(clip.ClearMarkInOut(p.get("type", "all")))}
-    return _unknown(action, ["get_name","get_metadata","set_metadata","get_third_party_metadata","set_third_party_metadata","get_media_id","get_clip_property","set_clip_property","get_clip_color","set_clip_color","clear_clip_color","link_proxy","unlink_proxy","replace_clip","set_name","link_full_resolution_media","monitor_growing_file","replace_clip_preserve_sub_clip","get_unique_id","transcribe_audio","clear_transcription","get_audio_mapping","get_mark_in_out","set_mark_in_out","clear_mark_in_out","open_in_viewer"])
+    return _unknown(action, ["get_name","get_metadata","set_metadata","get_third_party_metadata","set_third_party_metadata","get_media_id","get_clip_property","set_clip_property","get_clip_color","set_clip_color","clear_clip_color","link_proxy","unlink_proxy","replace_clip","set_name","link_full_resolution_media","monitor_growing_file","replace_clip_preserve_sub_clip","get_unique_id","transcribe_audio","clear_transcription","perform_audio_classification","clear_audio_classification","analyze_for_intellisearch","analyze_for_slate","remove_motion_blur","get_audio_mapping","get_mark_in_out","set_mark_in_out","clear_mark_in_out","open_in_viewer"])
 
 
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -20106,9 +20278,9 @@ def _resource_install_guidance() -> Dict[str, Any]:
 if __name__ == "__main__":
     start_background_update_check(VERSION, project_dir, logger, env=_setup_update_env())
 
-    # Support --full flag to run the 329-tool granular server instead
+    # Support --full flag to run the 341-tool granular server instead
     if "--full" in sys.argv:
-        logger.info("Starting full 329-tool granular server...")
+        logger.info("Starting full 341-tool granular server...")
         sys.argv = [arg for arg in sys.argv if arg != "--full"]
         from src.granular import mcp as granular_mcp