MCP Reference: storage.googleapis.com

Storage MCP Service provides tools to interact with Cloud Storage.

A Model Context Protocol (MCP) server acts as a proxy between an external service that provides context, data, or capabilities to an Large Language Model (LLM) or AI application. MCP servers connect AI applications to external systems such as databases and web services, translating their responses into a format that the AI application can understand.

Server Setup

You must enable MCP servers and set up authentication before use. For more information about using Google and Google Cloud remote MCP servers, see Google Cloud MCP servers overview.

Server Endpoints

An MCP service endpoint is the network address and communication interface (usually a URL) of the MCP server that an AI application (the Host for the MCP client) uses to establish a secure, standardized connection. It is the point of contact for the LLM to request context, call a tool, or access a resource. Google MCP endpoints can be global or regional.

The Cloud Storage API MCP server has the following global MCP endpoint:

  • https://storage.googleapis.com/storage/mcp

MCP Tools

An MCP tool is a function or executable capability that an MCP server exposes to an LLM or AI application to perform an action in the real world.

Tools

The storage.googleapis.com MCP server has the following tools:

MCP Tools
list_buckets Lists the buckets of a project.
list_objects Lists the objects in a bucket.
create_bucket Creates a bucket in a project.
delete_bucket Deletes a bucket from a project.
read_text DEPRECATED: Use read_object instead. Reads non-binary text content from an object.
read_object

Reads an object from Cloud Storage. Supports both text and binary content (it will output text for text content and binary for binary content).

Constraints & Behavior:

  • Size Limit: The maximum supported file size is 8MiB. Requests for larger objects will fail with an OutOfRange error.
write_text Writes text content to an object, overwriting any existing content.
delete_object Deletes an object from Cloud Storage.
get_object_metadata Gets the metadata of an object.

Get MCP tool specifications

To get the MCP tool specifications for all tools in an MCP server, use the tools/list method. The following example demonstrates how to use curl to list all tools and their specifications currently available within the MCP server.

Curl Request 
curl --location 'https://storage.googleapis.com/storage/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'