Buckets

Back to the MCP tool reference.

list_buckets

List bucket metadata under a strict result bound.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "title": "list_bucketsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "list_bucketsDictOutput",
  "type": "object"
}

get_bucket

Get safe metadata for one exact bucket ID or name.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "bucket_id_or_name": {
      "title": "Bucket Id Or Name",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "bucket_id_or_name"
  ],
  "title": "get_bucketArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "get_bucketDictOutput",
  "type": "object"
}

create_bucket

Create and journal a bucket when server policy permits writes.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "title": "create_bucketArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "create_bucketDictOutput",
  "type": "object"
}

import_external_bucket

Import using bounded JSON credentials from a protected internal source.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "credential_source_name": {
      "title": "Credential Source Name",
      "type": "string"
    },
    "credential_source_type": {
      "enum": [
        "env",
        "file",
        "secret"
      ],
      "title": "Credential Source Type",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "provider": {
      "enum": [
        "aws",
        "minio",
        "azure",
        "gcp",
        "open_stack"
      ],
      "title": "Provider",
      "type": "string"
    },
    "provider_bucket_name": {
      "title": "Provider Bucket Name",
      "type": "string"
    }
  },
  "required": [
    "provider",
    "provider_bucket_name",
    "credential_source_type",
    "credential_source_name"
  ],
  "title": "import_external_bucketArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "import_external_bucketDictOutput",
  "type": "object"
}

get_bucket_disk_usage

Scan bounded usage; complete=false means the object cap was reached.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "bucket_id_or_name": {
      "title": "Bucket Id Or Name",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "max_objects": {
      "default": 10000,
      "title": "Max Objects",
      "type": "integer"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "timeout_seconds": {
      "default": 60.0,
      "title": "Timeout Seconds",
      "type": "number"
    }
  },
  "required": [
    "bucket_id_or_name"
  ],
  "title": "get_bucket_disk_usageArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "get_bucket_disk_usageDictOutput",
  "type": "object"
}

stat_bucket_blob

Return metadata only for one exact blob key.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "bucket_id_or_name": {
      "title": "Bucket Id Or Name",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "key": {
      "title": "Key",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "bucket_id_or_name",
    "key"
  ],
  "title": "stat_bucket_blobArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "stat_bucket_blobDictOutput",
  "type": "object"
}

list_bucket_blobs

List blob metadata under an SDK-enforced and result-enforced bound.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "bucket_id_or_name": {
      "title": "Bucket Id Or Name",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "prefix": {
      "default": "",
      "title": "Prefix",
      "type": "string"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "recursive": {
      "default": false,
      "title": "Recursive",
      "type": "boolean"
    }
  },
  "required": [
    "bucket_id_or_name"
  ],
  "title": "list_bucket_blobsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "list_bucket_blobsDictOutput",
  "type": "object"
}

set_bucket_public_access

Set public state for one exact immutable bucket ID.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "bucket_id": {
      "title": "Bucket Id",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "public": {
      "title": "Public",
      "type": "boolean"
    }
  },
  "required": [
    "bucket_id",
    "public"
  ],
  "title": "set_bucket_public_accessArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "set_bucket_public_accessDictOutput",
  "type": "object"
}

list_bucket_credentials

List safe persistent credential metadata for exact-context buckets. Provider credential values returned internally by the SDK are discarded and never serialized through MCP.

Operation type: Read-only

Annotations: read-only true, destructive false, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "title": "list_bucket_credentialsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "list_bucket_credentialsDictOutput",
  "type": "object"
}

create_bucket_credentials

Create persistent credentials and atomically sink them to a 0600 file. Provider credential values are never returned through MCP.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "bucket_ids": {
      "items": {
        "type": "string"
      },
      "title": "Bucket Ids",
      "type": "array"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "destination_file": {
      "title": "Destination File",
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "read_only": {
      "default": false,
      "title": "Read Only",
      "type": "boolean"
    }
  },
  "required": [
    "bucket_ids",
    "destination_file"
  ],
  "title": "create_bucket_credentialsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "create_bucket_credentialsDictOutput",
  "type": "object"
}

export_bucket_credentials

Write one exact persistent credential to a new protected local file. Provider credential values are never returned through MCP.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "credential_id": {
      "title": "Credential Id",
      "type": "string"
    },
    "destination_file": {
      "title": "Destination File",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "credential_id",
    "destination_file"
  ],
  "title": "export_bucket_credentialsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "export_bucket_credentialsDictOutput",
  "type": "object"
}

delete_bucket_credentials

Delete one exact persistent bucket credential under lifecycle policy.

Operation type: Destructive write

Annotations: read-only false, destructive true, idempotent true, open-world true

Input schema:

{
  "properties": {
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "credential_id": {
      "title": "Credential Id",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "credential_id"
  ],
  "title": "delete_bucket_credentialsArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "delete_bucket_credentialsDictOutput",
  "type": "object"
}

create_bucket_signed_url

Create a short-lived blob URL and write it to a protected local file. The URL is never returned through MCP.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "bucket_id": {
      "title": "Bucket Id",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "destination_file": {
      "title": "Destination File",
      "type": "string"
    },
    "expires_in_seconds": {
      "default": 900,
      "title": "Expires In Seconds",
      "type": "integer"
    },
    "key": {
      "title": "Key",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "bucket_id",
    "key",
    "destination_file"
  ],
  "title": "create_bucket_signed_urlArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "create_bucket_signed_urlDictOutput",
  "type": "object"
}

upload_bucket_file

Upload one local file. Object bytes are never serialized through MCP. An optional positive timeout can bound the transfer when requested by the caller.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "bucket_id": {
      "title": "Bucket Id",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "key": {
      "title": "Key",
      "type": "string"
    },
    "local_path": {
      "title": "Local Path",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "timeout_seconds": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Timeout Seconds"
    }
  },
  "required": [
    "local_path",
    "bucket_id",
    "key"
  ],
  "title": "upload_bucket_fileArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "upload_bucket_fileDictOutput",
  "type": "object"
}

download_bucket_file

Download one blob to a new local file. Existing files are never overwritten. Blob bytes are never serialized through MCP. An optional positive timeout can bound the transfer when requested by the caller.

Operation type: Write

Annotations: read-only false, destructive false, idempotent false, open-world true

Input schema:

{
  "properties": {
    "bucket_id": {
      "title": "Bucket Id",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "key": {
      "title": "Key",
      "type": "string"
    },
    "local_path": {
      "title": "Local Path",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    },
    "timeout_seconds": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Timeout Seconds"
    }
  },
  "required": [
    "bucket_id",
    "key",
    "local_path"
  ],
  "title": "download_bucket_fileArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "download_bucket_fileDictOutput",
  "type": "object"
}

delete_bucket_blob

Delete one exact blob key; recursive/prefix deletion is not exposed.

Operation type: Destructive write

Annotations: read-only false, destructive true, idempotent true, open-world true

Input schema:

{
  "properties": {
    "bucket_id": {
      "title": "Bucket Id",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "key": {
      "title": "Key",
      "type": "string"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "bucket_id",
    "key"
  ],
  "title": "delete_bucket_blobArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "delete_bucket_blobDictOutput",
  "type": "object"
}

delete_bucket

Recursively delete one exact bucket under full or owned managed policy.

Operation type: Destructive write

Annotations: read-only false, destructive true, idempotent true, open-world true

Input schema:

{
  "properties": {
    "bucket_id": {
      "title": "Bucket Id",
      "type": "string"
    },
    "cluster": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cluster"
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Org"
    },
    "project": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Project"
    }
  },
  "required": [
    "bucket_id"
  ],
  "title": "delete_bucketArguments",
  "type": "object"
}

Output schema:

{
  "additionalProperties": true,
  "title": "delete_bucketDictOutput",
  "type": "object"
}