MCP Tools Reference: cloudbilling.googleapis.com

Tool: list_skus

Lists all publicly listed SKUs.

The following code sample shows how to use curl to call the list_skus MCP tool.

Curl Request 
curl --location 'https://cloudbilling.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_skus",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

Request message for ListSkus.

ListSkusRequest

JSON representation 
{
  "pageSize": integer,
  "pageToken": string,
  "filter": string
}
Fields
pageSize

integer

Maximum number of SKUs to return. Results may return fewer than this value. Default value is 50 and maximum value is 5000.
pageToken

string

Page token received from a previous ListSkus call to retrieve the next page of results. If this field is empty, the first page is returned.
filter

string

Options for how to filter the SKUs. Currently, only filter on service is supported. Only !=, = operators are supported. Examples: service = "services/DA34-426B-A397"

Output Schema

Response message for ListSkus.

ListSkusResponse

JSON representation 
{
  "skus": [
    {
      object (Sku)
    }
  ],
  "nextPageToken": string
}
Fields
skus[]

object (Sku)

The returned publicly listed SKUs.
nextPageToken

string

Token that can be sent as page_token in the subsequent request to retrieve the next page. If this field is empty, there are no subsequent pages.

Sku

JSON representation 
{
  "name": string,
  "skuId": string,
  "displayName": string,
  "service": string,
  "productTaxonomy": {
    object (ProductTaxonomy)
  },
  "geoTaxonomy": {
    object (GeoTaxonomy)
  }
}
Fields
name

string

Resource name for the SKU. Example: "skus/AA95-CD31-42FE".
skuId

string

Unique identifier for the SKU. Example: "AA95-CD31-42FE".
displayName

string

Description of the SKU. Example: "A2 Instance Core running in Hong Kong".
service

string

Service that the SKU belongs to.
productTaxonomy

object (ProductTaxonomy)

List of product categories that apply to the SKU.
geoTaxonomy

object (GeoTaxonomy)

Geographic metadata that applies to the SKU.

ProductTaxonomy

JSON representation 
{
  "taxonomyCategories": [
    {
      object (TaxonomyCategory)
    }
  ]
}
Fields
taxonomyCategories[]

object (TaxonomyCategory)

All product categories that the SKU belong to.

TaxonomyCategory

JSON representation 
{
  "category": string
}
Fields
category

string

Name of the product category.

GeoTaxonomy

JSON representation 
{
  "type": enum (Type),

  // Union field metadata can be only one of the following:
  "globalMetadata": {
    object (Global)
  },
  "regionalMetadata": {
    object (Regional)
  },
  "multiRegionalMetadata": {
    object (MultiRegional)
  }
  // End of list of possible types for union field metadata.
}
Fields
type

enum (Type)

Type of geographic taxonomy associated with the SKU.

Union field metadata.

metadata can be only one of the following:
globalMetadata

object (Global)

Global geographic metadata with no regions.
regionalMetadata

object (Regional)

Regional geographic metadata with 1 region.
multiRegionalMetadata

object (MultiRegional)

Multi-regional geographic metadata with 2 or more regions.

Regional

JSON representation 
{
  "region": {
    object (Region)
  }
}
Fields
region

object (Region)

Google Cloud region associated with the regional geographic taxonomy.

Region

JSON representation 
{
  "region": string
}
Fields
region

string

Description of a Google Cloud region. Example: "us-west2".

MultiRegional

JSON representation 
{
  "regions": [
    {
      object (Region)
    }
  ]
}
Fields
regions[]

object (Region)

Google Cloud regions associated with the multi-regional geographic taxonomy.

Type

Different types of geographic taxonomy.

Enums
TYPE_UNSPECIFIED Default value. Unspecified type.
TYPE_GLOBAL Global geographic taxonomy with no regions.
TYPE_REGIONAL Regional geographic taxonomy with 1 region.
TYPE_MULTI_REGIONAL Multi-regional geographic taxonomy with 2 or more regions.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌