Tools on MCP Toolbox for Databases

cloud-storage-list-buckets

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-list-buckets tool returns the Cloud Storage buckets in a project. By default, it uses the project configured on the source. You can pass the optional project parameter to list buckets in a different project that the same credentials can access.

The response is a JSON object with buckets (bucket metadata returned by the Cloud Storage API) and nextPageToken (empty when there are no more pages).

Compatible Sources

This tool can be used with the following database sources:

cloud-storage-create-bucket

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-create-bucket tool creates a new Cloud Storage bucket in the project configured on the Cloud Storage source. Use it when an agent needs to provision a bucket before writing objects or building a data workflow.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to create buckets in the configured project. Bucket names are globally unique and must satisfy Cloud Storage bucket naming rules.

cloud-storage-list-objects

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-list-objects tool returns the objects in a Cloud Storage bucket. It supports the usual GCS listing options:

prefix — filter results to objects whose names begin with the given string.
delimiter — group results by this character (typically /) so subdirectory-like “common prefixes” are returned separately from the leaf objects.
max_results / page_token — paginate through large listings.

The response is a JSON object with objects (the full object metadata as returned by the Cloud Storage API — fields such as Name, Size, ContentType, Updated, StorageClass, MD5, etc.), prefixes (the common prefixes when delimiter is set), and nextPageToken (empty when there are no more pages).

cloud-storage-get-bucket-metadata

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-get-bucket-metadata tool returns metadata for a single Cloud Storage bucket. Use it when the LLM needs fields such as location, storage class, labels, lifecycle configuration, or uniform bucket-level access status.

The response is the bucket metadata structure returned by the Cloud Storage API.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to read metadata for the target bucket.

cloud-storage-get-object-metadata

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-get-object-metadata tool returns metadata for a single Cloud Storage object. Use it when the LLM needs fields such as object name, size, content type, generation, storage class, timestamps, checksums, or custom metadata without reading the object’s content.

The response is the object metadata structure returned by the Cloud Storage API.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Parameters

parameter	type	required	description
bucket	string	true	Name of the Cloud Storage bucket containing the object.
object	string	true	Full object name (path) within the bucket, e.g. `path/to/file.txt`.

Example

kind: tool
name: get_object_metadata
type: cloud-storage-get-object-metadata
source: my-gcs-source
description: Use this tool to inspect metadata for a Cloud Storage object.

Output Format

The tool returns object metadata from the Cloud Storage API, including fields such as Name, Bucket, Size, ContentType, Updated, StorageClass, MD5, CRC32C, and user-defined metadata when present.

cloud-storage-get-bucket-iam-policy

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-get-bucket-iam-policy tool returns the IAM policy bindings for a Cloud Storage bucket. Use it to inspect which principals have roles on a bucket without modifying access.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to read the IAM policy for the target bucket.

Parameters

parameter	type	required	description
bucket	string	true	Name of the Cloud Storage bucket whose IAM policy should be returned.

Example

kind: tool
name: get_bucket_iam_policy
type: cloud-storage-get-bucket-iam-policy
source: my-gcs-source
description: Use this tool to inspect IAM bindings for a Cloud Storage bucket.

Output Format

The tool returns a JSON object with:

cloud-storage-read-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-read-object tool fetches the bytes of a single Cloud Storage object and returns them as plain UTF-8 text.

Only text objects are supported today: if the object bytes (or the requested range) are not valid UTF-8 the tool returns an agent-fixable error. This is because the MCP tool-result channel currently only carries text; binary payloads will be supported once MCP can carry embedded resources.

Reads are capped at 8 MiB per call to protect the server’s memory and keep LLM contexts manageable; objects or ranges larger than that are rejected with an agent-fixable error. Use the optional range parameter to read a slice of a larger object.

cloud-storage-delete-bucket

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-delete-bucket tool deletes an empty Cloud Storage bucket. It does not delete objects first; if the bucket is not empty, Cloud Storage rejects the operation.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to delete the target bucket. The bucket must be empty before the tool is invoked.

Parameters

parameter	type	required	description
bucket	string	true	Name of the empty Cloud Storage bucket to delete.

Example

kind: tool
name: delete_bucket
type: cloud-storage-delete-bucket
source: my-gcs-source
description: Use this tool to delete empty Cloud Storage buckets.

Output Format

The tool returns a JSON object with:

cloud-storage-download-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-download-object tool streams a Cloud Storage object to a local file on the Toolbox server. Unlike cloud-storage-read-object, it does not return the object bytes to the LLM and does not require UTF-8 text content, so it can be used for binary objects or large files.

The destination path is interpreted on the server where Toolbox is running. Relative paths and paths containing .. are rejected.

Compatible Sources

This tool can be used with the following database sources:

cloud-storage-upload-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-upload-object tool streams a local file from the Toolbox server filesystem into a Cloud Storage object. The source path is interpreted on the server where Toolbox is running. Relative paths and paths containing .. are rejected.

When content_type is empty, Toolbox infers a MIME type from the source file extension. If inference fails, Cloud Storage detects the content type from the uploaded bytes.

Compatible Sources

This tool can be used with the following database sources:

cloud-storage-write-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-write-object tool writes text content from the tool request directly into a Cloud Storage object. It is useful for creating or replacing small text objects without first writing a local file on the Toolbox server.

When content_type is empty, Cloud Storage detects the content type from the written bytes.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to create or update the target object.

cloud-storage-copy-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-copy-object tool copies an object from one Cloud Storage location to another. The source and destination bucket parameters are separate, so the destination can be in the same bucket or a different bucket.

Existing destination objects are replaced.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to read the source object and create or update the destination object.

cloud-storage-move-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-move-object tool atomically moves or renames an object within the same Cloud Storage bucket by using Cloud Storage’s native move API.

This tool does not perform cross-bucket moves. For a cross-bucket move, call cloud-storage-copy-object first, verify the destination, and then call cloud-storage-delete-object on the source.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must have storage.objects.move and storage.objects.create permissions in the bucket. If the destination object already exists, storage.objects.delete is also required.

cloud-storage-delete-object

Mon, 01 Jan 0001 00:00:00 +0000

About

A cloud-storage-delete-object tool deletes a single object from a Cloud Storage bucket.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to delete the target object.

Parameters

parameter	type	required	description
bucket	string	true	Name of the Cloud Storage bucket containing the object to delete.
object	string	true	Full object name (path) within the bucket, e.g. `path/to/file.txt`.

Example

kind: tool
name: delete_object
type: cloud-storage-delete-object
source: my-gcs-source
description: Use this tool to delete Cloud Storage objects.

Output Format

The tool returns a JSON object with: