Skip to main content
Glama

Share

share
Read-only

Fastio shares (read): list and details, public details, members, available shares, name availability, password auth for a protected share. Writes are on share_manage. action='describe' gives the full action/param reference.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNocheck-name: the custom share URL name to check.
typeNoFilter by share type.
limitNoBackend page size (list/members); display_limit sets how many rows are returned.
actionYesOperation. Use 'describe' for full action reference.
detailNoterse|standard|full. Defaults: terse for list/available/members, standard for public-details, full for details.
offsetNoNumber of items to skip (default 0)
org_idNoFilter shares to this org.
passwordNopassword-auth: the share password.
share_idNoShare profile ID or custom name.
display_limitNolist: rows to return (default 10, max 500), trimmed after fetch.
describe_actionNoWith action='describe': return one action's params and notes instead of the action index.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed38 schema fields changed
    • removedInput schema / properties / accent_color
      Removed value: -{
      -  "description": "Accent color as JSON string.",
      -  "type": "string"
      -}
    • removedInput schema / properties / access_options
      Removed value: -{
      -  "description": "Access level. 'Anyone with the link' not allowed for receive/exchange.",
      -  "enum": [
      -    "Only members of the Share or Workspace",
      -    "Members of the Share, Workspace or Org",
      -    "Anyone with a registered account",
      -    "Anyone with the link"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "autotitle"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "public-details",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name"
      +]
    • removedInput schema / properties / anonymous_uploads_enabled
      Removed value: -{
      -  "description": "Allow guests to upload anonymously on public Receive/Exchange shares.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / background_color1
      Removed value: -{
      -  "description": "Primary background color as JSON string.",
      -  "type": "string"
      -}
    • removedInput schema / properties / background_color2
      Removed value: -{
      -  "description": "Secondary background color as JSON string.",
      -  "type": "string"
      -}
    • removedInput schema / properties / background_image
      Removed value: -{
      -  "description": "Background image index (0-128, default 0).",
      -  "maximum": 128,
      -  "minimum": 0,
      -  "type": "integer"
      -}
    • removedInput schema / properties / comments_enabled
      Removed value: -{
      -  "description": "Enable comments (default: true).",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / confirm
      Removed value: -{
      -  "description": "delete: must match the share's custom_name or id (validated client-side before the call).",
      -  "type": "string"
      -}
    • removedInput schema / properties / create_folder
      Removed value: -{
      -  "description": "Create a new workspace folder (workspace_folder mode).",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / custom_name
      Removed value: -{
      -  "description": "Custom share URL name (4-80 chars; Unicode letters, digits, hyphens, underscores). Omit to have one auto-generated.",
      -  "maxLength": 80,
      -  "minLength": 4,
      -  "type": "string"
      -}
    • changedInput schema / properties / describe_action / description
      Previous value: -"When action='describe', narrow the output to ONE action's full params/notes (e.g. 'create'). Omit to get the compact action index."New value: +"With action='describe': return one action's params and notes instead of the action index."
    • removedInput schema / properties / description
      Removed value: -{
      -  "description": "Share description (10-500 chars).",
      -  "maxLength": 500,
      -  "minLength": 10,
      -  "type": "string"
      -}
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists."New value: +"terse|standard|full. Defaults: terse for list/available/members, standard for public-details, full for details."
    • changedInput schema / properties / display_limit / description
      Previous value: -"How many items to return. Default 10, max 500. The MCP trims post-fetch; backend page_size stays MCP-internal so the platform cache stays warm. Applies to list."New value: +"list: rows to return (default 10, max 500), trimmed after fetch."
    • removedInput schema / properties / display_type
      Removed value: -{
      -  "description": "Display mode (default: grid).",
      -  "enum": [
      -    "list",
      -    "grid"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / download_security
      Removed value: -{
      -  "description": "Download security: off (default), medium (no guest download), high (block all guest downloads).",
      -  "enum": [
      -    "off",
      -    "medium",
      -    "high"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / expand
      Removed value: -{
      -  "description": "quickshare-create only. Set to 'node' to include the full backend payload as a nested `node` field. Default response is slim: `{id, web_url, expires_at}`.",
      -  "enum": [
      -    "node"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / expires
      Removed value: -{
      -  "description": "Expiration: 'YYYY-MM-DD HH:MM:SS' for create/update; seconds (default 10800, max 604800) for quickshare-create.",
      -  "type": "string"
      -}
    • removedInput schema / properties / expires_at
      Removed value: -{
      -  "description": "ISO 8601 datetime for quickshare expiration.",
      -  "type": "string"
      -}
    • removedInput schema / properties / folder_name
      Removed value: -{
      -  "description": "Name for new folder (default: 'Shared Folder').",
      -  "type": "string"
      -}
    • removedInput schema / properties / folder_node_id
      Removed value: -{
      -  "description": "Workspace folder node ID (workspace_folder mode).",
      -  "type": "string"
      -}
    • removedInput schema / properties / guest_chat_enabled
      Removed value: -{
      -  "description": "Enable guest chat (default: false).",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / intelligence
      Removed value: -{
      -  "description": "Enable RAG indexing. ⚠️ COSTS CREDITS (10/page) — default false unless user requests it. Forced false on workspace_folder shares.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / invite
      Removed value: -{
      -  "description": "Who can invite others (default: owners).",
      -  "enum": [
      -    "owners",
      -    "guests"
      -  ],
      -  "type": "string"
      -}
    • changedInput schema / properties / limit / description
      Previous value: -"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded by list/members."New value: +"Backend page size (list/members); display_limit sets how many rows are returned."
    • changedInput schema / properties / name / description
      Previous value: -"Share title (2-80 chars; maps to API 'title')."New value: +"check-name: the custom share URL name to check."
    • removedInput schema / properties / node_id
      Removed value: -{
      -  "description": "Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days.",
      -  "type": "string"
      -}
    • removedInput schema / properties / notify
      Removed value: -{
      -  "description": "Notification setting (default: never).",
      -  "enum": [
      -    "never",
      -    "notify_on_file_received",
      -    "notify_on_file_sent_or_received"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / owner_defined
      Removed value: -{
      -  "description": "Custom metadata as JSON string.",
      -  "type": "string"
      -}
    • changedInput schema / properties / password / description
      Previous value: -"Password (only with 'Anyone with the link')."New value: +"password-auth: the share password."
    • removedInput schema / properties / room_goal
      Removed value: -{
      -  "description": "REMOVED — Coordination Rooms were deleted from the platform on 2026-08-25 and this parameter no longer does anything. Supplying it is REFUSED rather than ignored, so a stale tool list cannot silently drop your value. Do not use it.",
      -  "maxLength": 1000,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / share_type
      Removed value: -{
      -  "description": "New share type.",
      -  "enum": [
      -    "send",
      -    "receive",
      -    "exchange"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / storage_mode
      Removed value: -{
      -  "description": "Storage mode (default: independent).",
      -  "enum": [
      -    "independent",
      -    "workspace_folder"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / title
      Removed value: -{
      -  "description": "Share title (2-80 chars). Alias of name.",
      -  "maxLength": 80,
      -  "minLength": 2,
      -  "type": "string"
      -}
    • removedInput schema / properties / user_context
      Removed value: -{
      -  "description": "autotitle only: optional user-provided context to guide the AI-generated title/description.",
      -  "type": "string"
      -}
    • removedInput schema / properties / workspace_id
      Removed value: -{
      -  "description": "Workspace opaque ID. Use this when only workspaces are valid (not shares or other contexts). For polymorphic contexts use profile_id. Parent workspace ID.",
      -  "type": "string"
      -}
    • removedInput schema / properties / workspace_style
      Removed value: -{
      -  "description": "Use workspace styling (default: true).",
      -  "type": "boolean"
      -}
  2. Changed1 schema field changed
    • changedInput schema / properties / room_goal / description
      Previous value: -"update only, Coordination Rooms only. Correct a room's purpose; share_id IS the room_id. 1-500 chars, no control chars; blank NOT accepted. ANY member of the parent workspace may do this — a room grants share-level Admin to workspace members. The only mutable manifest key; topic_slug is immutable. Non-room share: REFUSED 406. Most OTHER update params are refused on a room — see the action note."New value: +"REMOVED — Coordination Rooms were deleted from the platform on 2026-08-25 and this parameter no longer does anything. Supplying it is REFUSED rather than ignored, so a stale tool list cannot silently drop your value. Do not use it."
  3. Changed1 schema field changed
    • addedInput schema / properties / room_goal
      Added value: +{
      +  "description": "update only, Coordination Rooms only. Correct a room's purpose; share_id IS the room_id. 1-500 chars, no control chars; blank NOT accepted. ANY member of the parent workspace may do this — a room grants share-level Admin to workspace members. The only mutable manifest key; topic_slug is immutable. Non-room share: REFUSED 406. Most OTHER update params are refused on a room — see the action note.",
      +  "maxLength": 1000,
      +  "minLength": 1,
      +  "type": "string"
      +}
  4. Changed1 schema field changed
    • changedInput schema / properties / custom_name / description
      Previous value: -"Custom share URL name (4-80 chars, alphanumeric)."New value: +"Custom share URL name (4-80 chars; Unicode letters, digits, hyphens, underscores). Omit to have one auto-generated."
  5. Changed3 schema fields changed
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for…"New value: +"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists."
    • changedInput schema / properties / limit / description
      Previous value: -"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded…"New value: +"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded by list/members."
    • changedInput schema / properties / node_id / description
      Previous value: -"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB,…"New value: +"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days."
  6. Changed21 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "autotitle",
      -  "review-surface-create",
      -  "review-surface-get",
      -  "review-list-active",
      -  "review-cancel",
      -  "review-admin-resolve",
      -  "review-reviewer-add-member",
      -  "review-reviewer-add-external",
      -  "review-reviewer-remove",
      -  "review-decision"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "autotitle"
      +]
    • removedInput schema / properties / asset_id
      Removed value: -{
      -  "description": "Share-review asset id (one reviewed file). review-decision.",
      -  "type": "string"
      -}
    • removedInput schema / properties / comment_text
      Removed value: -{
      -  "description": "review-decision: the reason. REQUIRED (non-blank) for decision='reject'/'request_changes'; optional for 'approve'. A blank reason on reject/request_changes is…",
      -  "maxLength": 65535,
      -  "type": "string"
      -}
    • changedInput schema / properties / confirm / description
      Previous value: -"delete: must match the share's custom_name or id (validated client-side before the call). review-admin-resolve: must be 'true' (the force-resolve confirmation…"New value: +"delete: must match the share's custom_name or id (validated client-side before the call)."
    • removedInput schema / properties / deadline_at
      Removed value: -{
      -  "description": "review-surface-create: optional review deadline ('YYYY-MM-DD HH:MM:SS' UTC).",
      -  "type": "string"
      -}
    • removedInput schema / properties / decision
      Removed value: -{
      -  "description": "review-decision: approve | reject | request_changes (sent to the platform as `action`).",
      -  "enum": [
      -    "approve",
      -    "reject",
      -    "request_changes"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / email
      Removed value: -{
      -  "description": "review-reviewer-add-external: external reviewer email.",
      -  "minLength": 3,
      -  "type": "string"
      -}
    • removedInput schema / properties / idempotency_key
      Removed value: -{
      -  "description": "review-surface-create: replay-safe key (1-128). REQUIRED; same key returns the existing surface.",
      -  "maxLength": 128,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / invite_notes
      Removed value: -{
      -  "description": "review-reviewer-add-external: optional note included in the magic-link invite email.",
      -  "maxLength": 4000,
      -  "type": "string"
      -}
    • removedInput schema / properties / member_user_id
      Removed value: -{
      -  "description": "Share member's User ID to add as a reviewer. review-reviewer-add-member (must be a share member).",
      -  "type": "string"
      -}
    • removedInput schema / properties / message
      Removed value: -{
      -  "description": "review-surface-create: optional message to reviewers (max 4000).",
      -  "maxLength": 4000,
      -  "type": "string"
      -}
    • removedInput schema / properties / node_ids
      Removed value: -{
      -  "description": "review-surface-create (target_mode=fileset): JSON array of node ids to review. Native or string.",
      -  "type": "string"
      -}
    • removedInput schema / properties / outcome
      Removed value: -{
      -  "description": "review-admin-resolve: force-resolve outcome approved|rejected.",
      -  "enum": [
      -    "approved",
      -    "rejected"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / policy_mode
      Removed value: -{
      -  "description": "review-surface-create: approval policy. quorum needs policy_quorum_n.",
      -  "enum": [
      -    "single",
      -    "unanimous",
      -    "quorum",
      -    "all_assets_all_approved",
      -    "overall_signoff"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / policy_quorum_n
      Removed value: -{
      -  "description": "review-surface-create: required approvals when policy_mode='quorum'.",
      -  "maximum": 9007199254740991,
      -  "minimum": 1,
      -  "type": "integer"
      -}
    • removedInput schema / properties / reviewer_id
      Removed value: -{
      -  "description": "Share-review reviewer roster id. review-reviewer-remove.",
      -  "type": "string"
      -}
    • removedInput schema / properties / reviewer_name
      Removed value: -{
      -  "description": "review-reviewer-add-external: external reviewer's display name (1-255 chars; sent to the platform body field `name`). REQUIRED for review-reviewer-add-external.",
      -  "maxLength": 255,
      -  "minLength": 1,
      -  "type": "string"
      -}
    • removedInput schema / properties / reviewers
      Removed value: -{
      -  "description": "review-surface-create: REQUIRED non-empty JSON array of reviewer entries. Each entry is {\"kind\":\"member\",\"user_id\":\"<member user id>\"} OR…",
      -  "type": "string"
      -}
    • removedInput schema / properties / surface_id
      Removed value: -{
      -  "description": "Share-review surface OpaqueId. review-surface-get/-cancel/-admin-resolve/-reviewer-*/-decision.",
      -  "type": "string"
      -}
    • removedInput schema / properties / target_mode
      Removed value: -{
      -  "description": "review-surface-create: fileset (specific node_ids) or whole_share.",
      -  "enum": [
      -    "fileset",
      -    "whole_share"
      -  ],
      -  "type": "string"
      -}
    • removedInput schema / properties / version_id_pinned
      Removed value: -{
      -  "description": "review-decision: pinned asset version (CAS).",
      -  "type": "string"
      -}
  7. Changed3 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "autotitle",
      -  "instructions-get",
      -  "instructions-set",
      -  "instructions-clear",
      -  "review-surface-create",
      -  "review-surface-get",
      -  "review-list-active",
      -  "review-cancel",
      -  "review-admin-resolve",
      -  "review-reviewer-add-member",
      -  "review-reviewer-add-external",
      -  "review-reviewer-remove",
      -  "review-decision"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "autotitle",
      +  "review-surface-create",
      +  "review-surface-get",
      +  "review-list-active",
      +  "review-cancel",
      +  "review-admin-resolve",
      +  "review-reviewer-add-member",
      +  "review-reviewer-add-external",
      +  "review-reviewer-remove",
      +  "review-decision"
      +]
    • removedInput schema / properties / content
      Removed value: -{
      -  "description": "Markdown body for AI instructions slot (max 65536 bytes UTF-8). Full replace.",
      -  "type": "string"
      -}
    • removedInput schema / properties / scope
      Removed value: -{
      -  "description": "AI instructions scope: 'profile' (share-wide; owner/admin) or 'me' (per-user; registered members only). Independent slots, do NOT merge.",
      -  "enum": [
      -    "profile",
      -    "me"
      -  ],
      -  "type": "string"
      -}
  8. Changed26 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "describe",
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "instructions-get",
      -  "instructions-set",
      -  "instructions-clear"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "autotitle",
      +  "instructions-get",
      +  "instructions-set",
      +  "instructions-clear",
      +  "review-surface-create",
      +  "review-surface-get",
      +  "review-list-active",
      +  "review-cancel",
      +  "review-admin-resolve",
      +  "review-reviewer-add-member",
      +  "review-reviewer-add-external",
      +  "review-reviewer-remove",
      +  "review-decision"
      +]
    • addedInput schema / properties / asset_id
      Added value: +{
      +  "description": "Share-review asset id (one reviewed file). review-decision.",
      +  "type": "string"
      +}
    • addedInput schema / properties / comment_text
      Added value: +{
      +  "description": "review-decision: the reason. REQUIRED (non-blank) for decision='reject'/'request_changes'; optional for 'approve'. A blank reason on reject/request_changes is…",
      +  "maxLength": 65535,
      +  "type": "string"
      +}
    • changedInput schema / properties / confirm / description
      Previous value: -"Must match share ID or custom_name."New value: +"delete: must match the share's custom_name or id (validated client-side before the call). review-admin-resolve: must be 'true' (the force-resolve confirmation…"
    • addedInput schema / properties / deadline_at
      Added value: +{
      +  "description": "review-surface-create: optional review deadline ('YYYY-MM-DD HH:MM:SS' UTC).",
      +  "type": "string"
      +}
    • addedInput schema / properties / decision
      Added value: +{
      +  "description": "review-decision: approve | reject | request_changes (sent to the platform as `action`).",
      +  "enum": [
      +    "approve",
      +    "reject",
      +    "request_changes"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / describe_action
      Added value: +{
      +  "description": "When action='describe', narrow the output to ONE action's full params/notes (e.g. 'create'). Omit to get the compact action index.",
      +  "type": "string"
      +}
    • changedInput schema / properties / detail / description
      Previous value: -"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists."New value: +"Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for…"
    • addedInput schema / properties / email
      Added value: +{
      +  "description": "review-reviewer-add-external: external reviewer email.",
      +  "minLength": 3,
      +  "type": "string"
      +}
    • addedInput schema / properties / idempotency_key
      Added value: +{
      +  "description": "review-surface-create: replay-safe key (1-128). REQUIRED; same key returns the existing surface.",
      +  "maxLength": 128,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / invite_notes
      Added value: +{
      +  "description": "review-reviewer-add-external: optional note included in the magic-link invite email.",
      +  "maxLength": 4000,
      +  "type": "string"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of items to return (1-500, default 100)"New value: +"Internal backend page_size — stays MCP-internal so the platform cache stays warm. Use display_limit to control how many rows are actually returned. Forwarded…"
    • addedInput schema / properties / member_user_id
      Added value: +{
      +  "description": "Share member's User ID to add as a reviewer. review-reviewer-add-member (must be a share member).",
      +  "type": "string"
      +}
    • addedInput schema / properties / message
      Added value: +{
      +  "description": "review-surface-create: optional message to reviewers (max 4000).",
      +  "maxLength": 4000,
      +  "type": "string"
      +}
    • changedInput schema / properties / node_id / description
      Previous value: -"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days."New value: +"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB,…"
    • addedInput schema / properties / node_ids
      Added value: +{
      +  "description": "review-surface-create (target_mode=fileset): JSON array of node ids to review. Native or string.",
      +  "type": "string"
      +}
    • addedInput schema / properties / outcome
      Added value: +{
      +  "description": "review-admin-resolve: force-resolve outcome approved|rejected.",
      +  "enum": [
      +    "approved",
      +    "rejected"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / policy_mode
      Added value: +{
      +  "description": "review-surface-create: approval policy. quorum needs policy_quorum_n.",
      +  "enum": [
      +    "single",
      +    "unanimous",
      +    "quorum",
      +    "all_assets_all_approved",
      +    "overall_signoff"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / policy_quorum_n
      Added value: +{
      +  "description": "review-surface-create: required approvals when policy_mode='quorum'.",
      +  "maximum": 9007199254740991,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / reviewer_id
      Added value: +{
      +  "description": "Share-review reviewer roster id. review-reviewer-remove.",
      +  "type": "string"
      +}
    • addedInput schema / properties / reviewer_name
      Added value: +{
      +  "description": "review-reviewer-add-external: external reviewer's display name (1-255 chars; sent to the platform body field `name`). REQUIRED for review-reviewer-add-external.",
      +  "maxLength": 255,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / reviewers
      Added value: +{
      +  "description": "review-surface-create: REQUIRED non-empty JSON array of reviewer entries. Each entry is {\"kind\":\"member\",\"user_id\":\"<member user id>\"} OR…",
      +  "type": "string"
      +}
    • addedInput schema / properties / surface_id
      Added value: +{
      +  "description": "Share-review surface OpaqueId. review-surface-get/-cancel/-admin-resolve/-reviewer-*/-decision.",
      +  "type": "string"
      +}
    • addedInput schema / properties / target_mode
      Added value: +{
      +  "description": "review-surface-create: fileset (specific node_ids) or whole_share.",
      +  "enum": [
      +    "fileset",
      +    "whole_share"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / user_context
      Added value: +{
      +  "description": "autotitle only: optional user-provided context to guide the AI-generated title/description.",
      +  "type": "string"
      +}
    • addedInput schema / properties / version_id_pinned
      Added value: +{
      +  "description": "review-decision: pinned asset version (CAS).",
      +  "type": "string"
      +}
  9. Changed16 schema fields changed
    • removedInput schema / properties / background_image / anyOf
      Removed value: -[
      -  {
      -    "maximum": 128,
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / background_image / maximum
      Added value: +128
    • addedInput schema / properties / background_image / minimum
      Added value: +0
    • addedInput schema / properties / background_image / type
      Added value: +"integer"
    • removedInput schema / properties / display_limit / anyOf
      Removed value: -[
      -  {
      -    "maximum": 500,
      -    "minimum": 1,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / display_limit / maximum
      Added value: +500
    • addedInput schema / properties / display_limit / minimum
      Added value: +1
    • addedInput schema / properties / display_limit / type
      Added value: +"integer"
    • removedInput schema / properties / limit / anyOf
      Removed value: -[
      -  {
      -    "maximum": 500,
      -    "minimum": 1,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / limit / maximum
      Added value: +500
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • addedInput schema / properties / limit / type
      Added value: +"integer"
    • removedInput schema / properties / offset / anyOf
      Removed value: -[
      -  {
      -    "maximum": 9007199254740991,
      -    "minimum": 0,
      -    "type": "integer"
      -  },
      -  {
      -    "pattern": "^-?\\d+$",
      -    "type": "string"
      -  }
      -]
    • addedInput schema / properties / offset / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / offset / minimum
      Added value: +0
    • addedInput schema / properties / offset / type
      Added value: +"integer"
  10. Changed4 schema fields changed
    • removedInput schema / properties / custom_name / pattern
      Removed value: -"^[\\p{L}\\p{N}]+$"
    • removedInput schema / properties / description / pattern
      Removed value: -"^[^\\p{C}]*$"
    • removedInput schema / properties / name / pattern
      Removed value: -"^[^\\p{C}]*$"
    • removedInput schema / properties / title / pattern
      Removed value: -"^[^\\p{C}]*$"
  11. Changed50 schema fields changed
    • changedInput schema / properties / accent_color / description
      Previous value: -"Accent color as JSON string (used by: create)"New value: +"Accent color as JSON string."
    • changedInput schema / properties / access_options / description
      Previous value: -"Access level. 'Anyone with the link' not allowed for receive/exchange shares. (used by: create, update)"New value: +"Access level. 'Anyone with the link' not allowed for receive/exchange."
    • changedInput schema / properties / action / description
      Previous value: -"Operation to perform"New value: +"Operation. Use 'describe' for full action reference."
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow",
      -  "instructions-get",
      -  "instructions-set",
      -  "instructions-clear"
      -]New value: +[
      +  "describe",
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "instructions-get",
      +  "instructions-set",
      +  "instructions-clear"
      +]
    • changedInput schema / properties / anonymous_uploads_enabled / description
      Previous value: -"Enable anonymous file uploads on public Receive/Exchange shares. When true with 'Anyone' access, guests can upload without registration. Not applicable to Send shares or Portals (Send-only shares with independent storage). (used by: create, update)"New value: +"Allow guests to upload anonymously on public Receive/Exchange shares."
    • changedInput schema / properties / background_color1 / description
      Previous value: -"Primary background color as JSON string (used by: create)"New value: +"Primary background color as JSON string."
    • changedInput schema / properties / background_color2 / description
      Previous value: -"Secondary background color as JSON string (used by: create)"New value: +"Secondary background color as JSON string."
    • addedInput schema / properties / background_image / anyOf
      Added value: +[
      +  {
      +    "maximum": 128,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • changedInput schema / properties / background_image / description
      Previous value: -"Background image index (0-128, default: 0) (used by: create)"New value: +"Background image index (0-128, default 0)."
    • removedInput schema / properties / background_image / type
      Removed value: -"number"
    • changedInput schema / properties / comments_enabled / description
      Previous value: -"Enable comments (default: true) (used by: create, update)"New value: +"Enable comments (default: true)."
    • changedInput schema / properties / confirm / description
      Previous value: -"Confirmation value: must match share ID or custom_name (required for: delete)"New value: +"Must match share ID or custom_name."
    • changedInput schema / properties / content / description
      Previous value: -"Full markdown body that replaces the AI instructions slot (max 65536 bytes UTF-8). instructions-set is full replace — to append, GET → concat client-side → set. (used by: instructions-set)"New value: +"Markdown body for AI instructions slot (max 65536 bytes UTF-8). Full replace."
    • changedInput schema / properties / create_folder / description
      Previous value: -"Create a new workspace folder (workspace_folder mode) (used by: create)"New value: +"Create a new workspace folder (workspace_folder mode)."
    • changedInput schema / properties / custom_name / description
      Previous value: -"Custom share URL name (4-80 chars, alphanumeric + unicode letters) (used by: create)"New value: +"Custom share URL name (4-80 chars, alphanumeric)."
    • changedInput schema / properties / description / description
      Previous value: -"Share description (10-500 chars) (used by: create, update)"New value: +"Share description (10-500 chars)."
    • addedInput schema / properties / detail
      Added value: +{
      +  "description": "Per-entity verbosity for list/available/members/public-details/details. Defaults: terse for list/available/members, standard for public-details, full for details. See action='describe' for per-level field lists.",
      +  "enum": [
      +    "terse",
      +    "standard",
      +    "full"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / display_limit
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 500,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "pattern": "^-?\\d+$",
      +      "type": "string"
      +    }
      +  ],
      +  "description": "How many items to return. Default 10, max 500. The MCP trims post-fetch; backend page_size stays MCP-internal so the platform cache stays warm. Applies to list."
      +}
    • changedInput schema / properties / display_type / description
      Previous value: -"Display mode (default: 'grid') (used by: create)"New value: +"Display mode (default: grid)."
    • changedInput schema / properties / download_security / description
      Previous value: -"Download security level: 'off' (no restrictions, default), 'medium' (guests can preview but not download), 'high' (all guest downloads blocked). (used by: create, update)"New value: +"Download security: off (default), medium (no guest download), high (block all guest downloads)."
    • addedInput schema / properties / expand
      Added value: +{
      +  "description": "quickshare-create only. Set to 'node' to include the full backend payload as a nested `node` field. Default response is slim: `{id, web_url, expires_at}`.",
      +  "enum": [
      +    "node"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / expires / description
      Previous value: -"Expiration: datetime string YYYY-MM-DD HH:MM:SS for create/update, or seconds from creation for quickshare-create (default 10800, max 604800 = 7 days). Alternatively use expires_at with ISO 8601 datetime for quickshare-create. Not allowed on workspace_folder shares. (used by: create, update, quickshare-create)"New value: +"Expiration: 'YYYY-MM-DD HH:MM:SS' for create/update; seconds (default 10800, max 604800) for quickshare-create."
    • changedInput schema / properties / expires_at / description
      Previous value: -"ISO 8601 datetime for quickshare expiration as alternative to expires in seconds. Example: 2026-03-12T15:00:00Z. (used by: quickshare-create)"New value: +"ISO 8601 datetime for quickshare expiration."
    • changedInput schema / properties / folder_name / description
      Previous value: -"Name for new folder (default: 'Shared Folder') (used by: create)"New value: +"Name for new folder (default: 'Shared Folder')."
    • changedInput schema / properties / folder_node_id / description
      Previous value: -"Workspace folder node ID (workspace_folder mode) (used by: create)"New value: +"Workspace folder node ID (workspace_folder mode)."
    • changedInput schema / properties / guest_chat_enabled / description
      Previous value: -"Enable guest chat (default: false) (used by: create)"New value: +"Enable guest chat (default: false)."
    • changedInput schema / properties / intelligence / description
      Previous value: -"Enable AI-powered RAG indexing and semantic search on the share. ⚠️ COSTS CREDITS: 10 credits per page for every uploaded document — can consume the entire free plan budget quickly. MUST default to false unless the user explicitly requests RAG or AI search. NOT SUPPORTED on workspace_folder shares — always forced to false; use the parent workspace's AI endpoints instead. (default: false) (used by: create)"New value: +"Enable RAG indexing. ⚠️ COSTS CREDITS (10/page) — default false unless user requests it. Forced false on workspace_folder shares."
    • changedInput schema / properties / invite / description
      Previous value: -"Who can invite others (default: 'owners') (used by: create)"New value: +"Who can invite others (default: owners)."
    • addedInput schema / properties / limit / anyOf
      Added value: +[
      +  {
      +    "maximum": 500,
      +    "minimum": 1,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / limit / maximum
      Removed value: -500
    • removedInput schema / properties / limit / minimum
      Removed value: -1
    • removedInput schema / properties / limit / type
      Removed value: -"integer"
    • changedInput schema / properties / name / description
      Previous value: -"Share title (2-80 chars; maps to API 'title') (used by: create, update, check-name)"New value: +"Share title (2-80 chars; maps to API 'title')."
    • changedInput schema / properties / node_id / description
      Previous value: -"File node opaque ID (required for: quickshare-create). Quick shares: single file only, max 1 GB, default expiration 3 hours, max 7 days (1 week), auto-deleted on expiration."New value: +"Storage tree node opaque ID. Both files and folders are nodes — use this name regardless of which. File node opaque ID. Quickshares: single file, max 1 GB, default 3h, max 7 days."
    • changedInput schema / properties / notify / description
      Previous value: -"Notification setting (default: 'never') (used by: create)"New value: +"Notification setting (default: never)."
    • addedInput schema / properties / offset / anyOf
      Added value: +[
      +  {
      +    "maximum": 9007199254740991,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  {
      +    "pattern": "^-?\\d+$",
      +    "type": "string"
      +  }
      +]
    • removedInput schema / properties / offset / maximum
      Removed value: -9007199254740991
    • removedInput schema / properties / offset / minimum
      Removed value: -0
    • removedInput schema / properties / offset / type
      Removed value: -"integer"
    • changedInput schema / properties / org_id / description
      Previous value: -"Filter to shares in this org (list action)"New value: +"Filter shares to this org."
    • changedInput schema / properties / owner_defined / description
      Previous value: -"Custom metadata as JSON string (used by: create)"New value: +"Custom metadata as JSON string."
    • changedInput schema / properties / password / description
      Previous value: -"Password for share access (only with 'Anyone with the link') (used by: create, password-auth)"New value: +"Password (only with 'Anyone with the link')."
    • changedInput schema / properties / scope / description
      Previous value: -"AI instructions scope. \"profile\" (default) targets the share-wide slot at /share/{share_id}/instructions/ — owner/admin only (403 code 166463 for non-admins). \"me\" targets the per-user slot at /share/{share_id}/instructions/me/ — registered members only (403 code 185733 for anonymous/link guests). The two scopes are independent slots and do NOT merge server-side; concat client-side if you want a combined view. (used by: instructions-get, instructions-set, instructions-clear)"New value: +"AI instructions scope: 'profile' (share-wide; owner/admin) or 'me' (per-user; registered members only). Independent slots, do NOT merge."
    • changedInput schema / properties / share_id / description
      Previous value: -"Share profile ID or custom name"New value: +"Share profile ID or custom name."
    • changedInput schema / properties / share_type / description
      Previous value: -"New share type (used by: create, update)"New value: +"New share type."
    • changedInput schema / properties / storage_mode / description
      Previous value: -"Storage mode (default: 'independent') (used by: create)"New value: +"Storage mode (default: independent)."
    • changedInput schema / properties / title / description
      Previous value: -"Share title (2-80 chars). 'name' param also sets title; use either one. (used by: create)"New value: +"Share title (2-80 chars). Alias of name."
    • changedInput schema / properties / type / description
      Previous value: -"Filter by share type (list action)"New value: +"Filter by share type."
    • changedInput schema / properties / workspace_id / description
      Previous value: -"Parent workspace ID (required for: create, quickshare-create)"New value: +"Workspace opaque ID. Use this when only workspaces are valid (not shares or other contexts). For polymorphic contexts use profile_id. Parent workspace ID."
    • changedInput schema / properties / workspace_style / description
      Previous value: -"Use workspace styling (default: true) (used by: create)"New value: +"Use workspace styling (default: true)."
  12. Changed3 schema fields changed
    • changedInput schema / properties / action / enum
      Previous value: -[
      -  "list",
      -  "details",
      -  "create",
      -  "update",
      -  "delete",
      -  "public-details",
      -  "archive",
      -  "unarchive",
      -  "password-auth",
      -  "members",
      -  "available",
      -  "check-name",
      -  "quickshare-create",
      -  "enable-workflow",
      -  "disable-workflow"
      -]New value: +[
      +  "list",
      +  "details",
      +  "create",
      +  "update",
      +  "delete",
      +  "public-details",
      +  "archive",
      +  "unarchive",
      +  "password-auth",
      +  "members",
      +  "available",
      +  "check-name",
      +  "quickshare-create",
      +  "enable-workflow",
      +  "disable-workflow",
      +  "instructions-get",
      +  "instructions-set",
      +  "instructions-clear"
      +]
    • addedInput schema / properties / content
      Added value: +{
      +  "description": "Full markdown body that replaces the AI instructions slot (max 65536 bytes UTF-8). instructions-set is full replace — to append, GET → concat client-side → set. (used by: instructions-set)",
      +  "type": "string"
      +}
    • addedInput schema / properties / scope
      Added value: +{
      +  "description": "AI instructions scope. \"profile\" (default) targets the share-wide slot at /share/{share_id}/instructions/ — owner/admin only (403 code 166463 for non-admins). \"me\" targets the per-user slot at /share/{share_id}/instructions/me/ — registered members only (403 code 185733 for anonymous/link guests). The two scopes are independent slots and do NOT merge server-side; concat client-side if you want a combined view. (used by: instructions-get, instructions-set, instructions-clear)",
      +  "enum": [
      +    "profile",
      +    "me"
      +  ],
      +  "type": "string"
      +}
  13. First observed

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so the safety profile is covered. The description reinforces the read scope and mentions password-auth for protected shares, but adds nothing about pagination, response shape, or auth prerequisites beyond what the schema already encodes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences with the read scope front-loaded, followed by the routing pointer and the describe hint. No filler; each clause carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 11 parameters and three enum fields but no output schema, the description supplies the essential orientation: read-only scope, the write alternative, and the action='describe' escape hatch for full parameter detail. Only minor gaps remain around return-shape expectations, which annotations and the describe action largely absorb.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 11 parameters are already documented in the schema (including action, name, password, display_limit, limit). The description only gestures at 'password auth' and 'name availability' and adds no format or syntax detail beyond the schema, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Fastio shares (read)') and enumerates the concrete capabilities: list and details, public details, members, available shares, name availability, password auth. It also names share_manage as the write counterpart, so an agent can distinguish it from the sibling without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes writes to `share_manage` and points to action='describe' for the full action/param reference, which is a clear usage signal. It stops short of explaining which read action (details vs public-details vs members) to pick when, so it is clear context without full exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources