MCP tools reference: storage.googleapis.com

Tool: `list_objects`

Lists the objects in a bucket.

The following example shows how to use curl to invoke the list_objects tool:

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/call", "params": { "name": "list_objects", "arguments": { // provide these details according to the tool' s MCP specification } } , "jsonrpc" : "2.0" , "id" : 1 } '

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/call", 
 "params": { 
 "name": "list_objects", 
 "arguments": { 
 // provide these details according to the tool' 
s  
MCP  
specification  
 } 
  
 } 
,  
 "jsonrpc" 
:  
 "2.0" 
,  
 "id" 
:  
 1 
 } 
 '

Input schema

ListObjectsRequest

JSON representation
{ "bucketName" : string , "prefix" : string , "recursive" : boolean }

Fields

Fields
`bucketName`	`string` Required. The name of the bucket to list objects in. Format: {bucket_id}
`prefix`	`string` Optional. The prefix used to filter objects. If you don't specify a prefix, the operation matches all objects. If `recursive` is `false` , the operation matches only objects at the same level as the prefix. For example, `"documents"` matches `"documents.txt"` but not `"documents/my-file.txt"` .
`recursive`	`boolean` Optional. Specifies whether the list operation is recursive, which includes objects in subdirectories. If `recursive` is set to `false` (default), the operation lists only objects directly within the specified prefix.

bucketName

string

Required. The name of the bucket to list objects in. Format: {bucket_id}

prefix

string

Optional. The prefix used to filter objects. If you don't specify a prefix, the operation matches all objects. If recursive is false , the operation matches only objects at the same level as the prefix. For example, "documents" matches "documents.txt" but not "documents/my-file.txt" .

recursive

boolean

Optional. Specifies whether the list operation is recursive, which includes objects in subdirectories. If recursive is set to false (default), the operation lists only objects directly within the specified prefix.

Output schema

ListObjectsResponse

JSON representation
{ "objectNames" : [ string ] , "prefixes" : [ string ] }

Fields

Fields
`objectNames[]`	`string` The list of objects, ordered lexicographically by name. At most 1,000 objects are returned.
`prefixes[]`	`string` Object name prefixes for objects that matched the listing request but were excluded from `objectNames` because the `recursive` parameter is `false` . Values in this list are object names up to and including the delimiter `/` . The duplicate entries are omitted from this list. The prefixes are ordered lexicographically. At most 1,000 prefixes are returned.

objectNames[]

string

The list of objects, ordered lexicographically by name. At most 1,000 objects are returned.

prefixes[]

string

Object name prefixes for objects that matched the listing request but were excluded from objectNames because the recursive parameter is false . Values in this list are object names up to and including the delimiter / . The duplicate entries are omitted from this list. The prefixes are ordered lexicographically. At most 1,000 prefixes are returned.

Tool Annotations

Destructive hint: ❌ | Idempotent hint: ✅ | Read-only hint: ✅ | Open-world hint: ❌

MCP tools reference: storage.googleapis.com Stay organized with collections Save and categorize content based on your preferences.

Tool: list_objects

Input schema

ListObjectsRequest

Output schema

ListObjectsResponse

Tool Annotations

MCP tools reference: storage.googleapis.com

Tool: `list_objects`