Descript

Cancel a queued or running job.

cancel_job

Open a panel that helps the user import media into a Descript project. The user chooses video or audio files from their device or from files shared in the chat; the first upload creates a new project through import_media, and later uploads go into that same project. The panel reports upload progress, the project link, and any clips made in the project as model context. Use it when the user wants to add, upload, or import media into Descript, or asks to open Descript. Returns the drive id and name and a link to the Descript web app. This tool itself does not create, upload, edit, or publish anything. Requires an MCP Apps-capable host; elsewhere, use get_drive_info.

open_descript

Agent Underlord, Descript's built-in AI editor, queries, creates, and edits Descript projects using natural language. Refer to it as Agent Underlord when telling the user what is doing the editing, since that is the name they see in the Descript app. Use project_id for existing projects, project_name to create new ones. Returns immediately with a job_id, project_id, and project_url. Always display the project_url to the user so they can open the project in Descript. Please use the wait_for_job tool with the returned job_id to wait for the job to complete. The response includes a conversation_id — pass it back on subsequent calls to the same project to continue the conversation with full context.

prompt_project_agent

Export a project composition as a timeline file for import into another DAW/NLE (Premiere, DaVinci Resolve, Final Cut Pro, Pro Tools, Logic, Audition, Reaper). Media files are never bundled — only the timeline/XML/EDL file itself. Returns immediately with a job_id. Use the wait_for_job tool with the returned job_id to wait for completion; when the job finishes, its result carries a time-limited download_url (valid until download_url_expires_at). Always display the download_url to the user so they can download the file directly. Large exports can take several minutes, so polling avoids connection timeouts. Formats: edl (Samplitude/Reaper), sesx (Adobe Audition), fcp (Final Cut Pro X .fcpxml), premiere (Premiere Pro XML), davinci_resolve (DaVinci Resolve XML), aaf (Pro Tools/Logic, binary).

export_timeline

Export a project composition as a transcript document. Formats: txt, markdown, html, rtf, srt. Returns the exported content directly in the response.

export_transcript

Returns the drive (workspace) connected to the current session, including its ID and name. Use this to confirm which drive your requests will operate on.

get_drive_info

Get a detailed project summary including all media files, compositions, and existing publishes. Returns the project's id, name, drive_id, created_at, updated_at, folder_path (if in a folder), a map of media files (keyed by display path) with type and duration, a list of compositions with id, name, duration, and media type, and a list of existing publishes with share_url, access_level, media_type, and publish time. Use this to inspect a project's contents before editing or importing media, or to retrieve existing share URLs without triggering a republish.

get_project

Import media files into the drive media library (not into a project). Use this when the user wants to add files to their media library without creating or editing a project. Supports URL imports and direct file uploads. DIRECT FILE UPLOAD: Only for local clients that can reach Google Cloud Storage. Hosted model runtimes cannot PUT to upload_urls; pass a url instead. For local clients: provide content_type (MIME type) and file_size (bytes). The response includes upload_urls — a map of media key → { upload_url, asset_id, artifact_id }. PUT each file to its upload_url with header Content-Type: application/octet-stream. Returns immediately with a job_id and drive_id. Please use the wait_for_job tool with the returned job_id to wait for the job to complete.

import_drive_media

Import media into a Descript project via URLs (direct links, Google Drive, Dropbox) or direct file upload. Pass URLs as-is. Pass empty add_media ({}) with project_name to create an empty project. ADDING TO COMPOSITION: When creating a new project, include add_compositions so imported media appears on the timeline — this is the expected default. Only omit add_compositions for new projects when the user explicitly asks to import without adding to the composition. When importing into an existing project, omit add_compositions unless the user requests it, to avoid disrupting existing edits. To append media to an EXISTING composition, use update_compositions (composition_id + append_clips) instead of add_compositions. DIRECT FILE UPLOAD (preferred): Provide content_type (MIME type) and file_size (bytes) instead of a url. The response includes upload_urls — a map of media key → { upload_url, asset_id, artifact_id }. PUT each file to its upload_url with header Content-Type: application/octet-stream. The uploaded file size must match the file_size declared in the request. Prefer this path: these upload URLs stay valid for hours. Some runtimes have no network access and cannot reach Descript storage, so the PUT fails. While this job is still running the file can go in through the failure report: call report_upload_status (status "failed") with the same attachment in that call's "files" parameter, and Descript fetches the file itself, so this job continues with it in the project it already created. A failure reported without the attachment is final for that file; adding it then needs a new import with the project_id from this response, once this job has stopped. A further import for the same project is rejected until this job stops. Returns immediately with a job_id, project_id, and project_url. Always display the project_url to the user so they can open the project in Descript. Please use the wait_for_job tool with the returned job_id to wait for the job to complete.

import_media

Called by the Descript home panel, not by the model. Same as import_media for a direct file upload: provide content_type and file_size per add_media entry, then PUT each file to its upload_url from the response.

import_media_from_app