Skip to main content
Call tools/list on the configured server for the schemas available to the current credential. The permission names below use Studio’s default studio. prefix. Every tool also requires studio.mcp.use. Workspace access, source policy and tool allowlists still apply on each call. These four tools are supported in both authentication modes. Indexed search requires media-studio.search.enabled. File cards include the entry ID, name, kind and revision. They may include media type, MIME, byte size, dimensions and update timestamp. Use file transfer tools to obtain file bytes. Pass nextCursor back as cursor with the same tool, workspace, parent, query and filters. Use hasMore to determine whether to continue. A page may contain fewer visible items than its limit after policy filtering. Treat cursors as opaque and restart from the first page after changing filters. Search uses the configured lexical index. Reading never starts OCR, image analysis or semantic indexing. This request lists the first page of root entries whose names start with chair.
Keep workspace and search unchanged when using the returned cursor. Indexed search returns at most 60 candidates per page, omits stale and inaccessible matches, and expires search cursors after 15 minutes.

Workspaces, folders and file changes

The remaining tools require a managed connection. In the tables below, arguments marked optional may be omitted. An entry result contains id, name, kind, revision, trashedAt and versionId. A bulk items argument is a list of 1–100 unique {"id":"<entry ULID>","revision":1} objects. Studio validates and applies the explicitly selected batch atomically. Use current revisions and review the affected entries before trashing a batch. Paths use forward slashes and are limited to 4096 characters. Workspace names allow up to 160 characters. Entry names allow up to 191 characters. Tags accept up to 32 names, each up to 120 characters. A move to the root requires an explicit destination and the current revision.

Comments

These tools require the comments feature. Comment text is plain text and may contain up to 5000 characters. mentions accepts up to 10 distinct membership ID strings from the mention lookup. Edit and delete require author or moderation rights in addition to the listed permission. Comment results expose the comment ID and revision, body, timestamps, resolution and deletion flags, with authorName when available.

File transfer tools

Download requires studio.files.download. Other transfer tools require studio.uploads.create. Starting a resumable upload requires media-studio.upload.sessions.enabled and workspace support. See file transfer workflows for the binary requests and upload card shape.

Revisions, retries and responses

IDs are ULIDs unless a field explicitly uses a membership ID or cursor. Revisions are positive integers. When an operation takes a key, supply 16–100 characters from letters, numbers, underscore and hyphen. Reuse the key with the same credential and arguments after an uncertain response. For revision conflicts, reload the entry or comment before retrying. Managed operations return their payload in result.structuredContent. The four read tools expose JSON in result.content[].text. Treat result.isError and top-level JSON-RPC error as failures. An HTTP 200 alone does not indicate that the operation succeeded. See troubleshooting for error handling.