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.
Browse and search
These four tools are supported in both authentication modes. Indexed search requiresmedia-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.
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 akey, 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.