MCP Tools Reference: cloudquotas.googleapis.com

Tool: list_quota_preferences

Lists QuotaPreferences of all quotas for a given project, folder, or organization. Expected request structure: 'parent' (string, format: projects/{project}/locations/global, folders/{folder}/locations/global, or organizations/{organization}/locations/global) and 'filter' (string, optional, e.g. 'service="compute.googleapis.com" AND quotaId="CPUS-per-project-region"'). Pagination is automatically fixed to 100 items per page.

The following sample demonstrate how to use curl to invoke the list_quota_preferences MCP tool.

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

Input Schema

Virtual request message for ListQuotaPreferences via MCP facade.

ListQuotaPreferencesRequest

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

string

Required. Identifier. Parent value of QuotaPreference resources.
filter

string

Optional. Filter result QuotaPreferences by their state, type, or time range.
pageSize

integer

Optional. Requested page size. Server may return fewer items than requested.
pageToken

string

Optional. A token identifying a page of results the server should return.

Output Schema

Message for response to listing QuotaPreferences

ListQuotaPreferencesResponse

JSON representation 
{
  "quotaPreferences": [
    {
      object (QuotaPreference)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Fields
quotaPreferences[]

object (QuotaPreference)

The list of QuotaPreference
nextPageToken

string

A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages.
unreachable[]

string

Locations that could not be reached.

QuotaPreference

JSON representation 
{
  "name": string,
  "dimensions": {
    string: string,
    ...
  },
  "quotaConfig": {
    object (QuotaConfig)
  },
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "service": string,
  "quotaId": string,
  "reconciling": boolean,
  "justification": string,
  "contactEmail": string
}
Fields
name

string

Required except in the CREATE requests. The resource name of the quota preference. The path that follows /locations must be /global. For example: projects/123/locations/global/quotaPreferences/my-config-for-us-east1
dimensions

map (key: string, value: string)

Immutable. The dimensions that this quota preference applies to. The key of the map entry is the name of a dimension, such as region, zone, network_id, and the value of the map entry is the dimension value.

If a dimension is missing from the map of dimensions, the quota preference applies to all the dimension values except for those that have other quota preferences configured for the specific value.

Note: QuotaPreferences can only be applied across all values of user and resource dimension. Do not set values for user or resource in the dimension map.

For example: {"provider" : "Example Organization"} where provider is a service-specific quota dimension and Example Organization is the provider name.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
quotaConfig

object (QuotaConfig)

Required. Preferred quota configuration.
etag

string

Optional. The current etag of the quota preference. If an etag is provided on update and does not match the current server's etag of the quota preference, the request will be blocked and an ABORTED error will be returned. See https://google.aip.dev/134#etags for more details on etags.
createTime

string (Timestamp format)

Output only. Create time stamp

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. Update time stamp

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
service

string

Required. The name of the service to which the quota preference is applied.
quotaId

string

Required. The id of the quota to which the quota preference is applied. A quota name is unique in the service. For example, CpusPerProjectPerRegion
reconciling

boolean

Output only. Is the quota preference pending Google Cloud approval and fulfillment.
justification

string

The reason / justification for this quota preference.
contactEmail

string

Input only. An email address that can be used to contact the user, in case Google Cloud needs more information to make a decision before additional quota can be granted.

When requesting a quota increase, the email address is required. When requesting a quota decrease, the email address is optional. For example, the email address is optional when the QuotaConfig.preferred_value is smaller than the QuotaDetails.reset_value.

DimensionsEntry

JSON representation 
{
  "key": string,
  "value": string
}
Fields
key

string
value

string

QuotaConfig

JSON representation 
{
  "preferredValue": string,
  "stateDetail": string,
  "grantedValue": string,
  "traceId": string,
  "annotations": {
    string: string,
    ...
  },
  "requestOrigin": enum (Origin)
}
Fields
preferredValue

string (int64 format)

Required. The preferred value. Must be greater than or equal to -1. If set to -1, it means the value is "unlimited".
stateDetail

string

Output only. Optional details about the state of this quota preference.
grantedValue

string (Int64Value format)

Output only. Granted quota value.
traceId

string

Output only. The trace id that the Google Cloud uses to provision the requested quota. This trace id may be used by the client to contact Cloud support to track the state of a quota preference request. The trace id is only produced for increase requests and is unique for each request. The quota decrease requests do not have a trace id.
annotations

map (key: string, value: string)

Optional. The annotations map for clients to store small amounts of arbitrary data. Do not put PII or other sensitive information here. See https://google.aip.dev/128#annotations

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
requestOrigin

enum (Origin)

Output only. The origin of the quota preference request.

Int64Value

JSON representation 
{
  "value": string
}
Fields
value

string (int64 format)

The int64 value.

AnnotationsEntry

JSON representation 
{
  "key": string,
  "value": string
}
Fields
key

string
value

string

Timestamp

JSON representation 
{
  "seconds": string,
  "nanos": integer
}
Fields
seconds

string (int64 format)

Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
nanos

integer

Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

Origin

The enumeration of the origins of quota preference requests.

Enums
ORIGIN_UNSPECIFIED The unspecified value.
CLOUD_CONSOLE Created through Cloud Console.
AUTO_ADJUSTER Generated by automatic quota adjustment.

Tool Annotations

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