MCP Tools Reference: saasservicemgmt

Tool: list_releases

Lists Release resources. Required parameter: 'parent' (e.g. projects/my-project/locations/us-central1). Optional parameters: 'page_size', 'page_token', 'filter', 'order_by'.

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

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

Input Schema

The request structure for the ListReleases method.

ListReleasesRequest

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

string

Required. The parent of the release.
pageSize

integer

The maximum number of releases to send per page.
pageToken

string

The page token: If the next_page_token from a previous response is provided, this request will send the subsequent page.
filter

string

Filter the list as specified in https://google.aip.dev/160.
orderBy

string

Order results as specified in https://google.aip.dev/132.

Output Schema

The response structure for the ListReleases method.

ListReleasesResponse

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

object (Release)

The resulting releases.
nextPageToken

string

If present, the next page token can be provided to a subsequent ListReleases call to list the next page. If empty, there are no more pages.
unreachable[]

string

Locations that could not be reached.

Release

JSON representation 
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "applicationTemplateComponent": {
    object (ComponentRef)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Fields
name

string

Identifier. The resource name (full URI of the resource) following the standard naming scheme:

"projects/{project}/locations/{location}/releases/{release}"
unitKind

string

Required. Immutable. Reference to the UnitKind this Release corresponds to (required and immutable once created).
blueprint

object (Blueprint)

Optional. Blueprints are OCI Images that contain all of the artifacts needed to provision a unit.
releaseRequirements

object (ReleaseRequirements)

Optional. Set of requirements to be fulfilled on the Unit when using this Release.
inputVariables[]

object (UnitVariable)

Optional. Output only. List of input variables declared on the blueprint and can be present with their values on the unit spec
outputVariables[]

object (UnitVariable)

Optional. Output only. List of output variables declared on the blueprint and can be present with their values on the unit status
inputVariableDefaults[]

object (UnitVariable)

Optional. Mapping of input variables to default values. Maximum 100
applicationTemplateComponent

object (ComponentRef)

Output only. Reference to component and revision in a composite ApplicationTemplate.
labels

map (key: string, value: string)

Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.

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

map (key: string, value: string)

Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects.

More info: https://kubernetes.io/docs/user-guide/annotations

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

string

Output only. The unique identifier of the resource. UID is unique in the time and space for this resource within the scope of the service. It is typically generated by the server on successful creation of a resource and must not be changed. UID is used to uniquely identify resources with resource name reuses. This should be a UUID4.
etag

string

Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written.
createTime

string (Timestamp format)

Output only. The timestamp when the resource was created.

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. The timestamp when the resource was last updated. Any change to the resource made by users must refresh this value. Changes to a resource made by the service should refresh this value.

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".

Blueprint

JSON representation 
{
  "package": string,
  "engine": string,
  "version": string
}
Fields
package

string

Optional. Immutable. URI to a blueprint used by the Unit (required unless unitKind or release is set).
engine

string

Output only. Type of the engine used to actuate the blueprint. e.g. terraform, helm etc.
version

string

Output only. Version metadata if present on the blueprint.

ReleaseRequirements

JSON representation 
{
  "upgradeableFromReleases": [
    string
  ]
}
Fields
upgradeableFromReleases[]

string

Optional. A list of releases from which a unit can be upgraded to this one (optional). If left empty no constraints will be applied. When provided, unit upgrade requests to this release will check and enforce this constraint.

UnitVariable

JSON representation 
{
  "variable": string,
  "type": enum (Type),
  "value": string
}
Fields
variable

string

Required. Immutable. Name of the variable from actuation configs.
type

enum (Type)

Optional. Immutable. Name of a supported variable type. Supported types are string, int, bool.
value

string

Optional. String encoded value for the variable.

ComponentRef

JSON representation 
{
  "compositeRef": {
    object (CompositeRef)
  },
  "component": string,
  "revision": string
}
Fields
compositeRef

object (CompositeRef)

Reference to the Composite ApplicationTemplate.
component

string

Name of the component in composite.Components
revision

string

Revision of the component. If the component does not have a revision, this field will be explicitly set to the revision of the composite ApplicationTemplate.

CompositeRef

JSON representation 
{
  "applicationTemplate": string,
  "revision": string,
  "syncOperation": string
}
Fields
applicationTemplate

string

Required. Reference to the ApplicationTemplate resource.
revision

string

Revision of the ApplicationTemplate to use. Changes to revision will trigger manual resynchronization. If empty, ApplicationTemplate will be ignored.
syncOperation

string

Output only. Reference to on-going AppTemplate import and replication operation (i.e. the operation_id for the long-running operation). This field is opaque for external usage.

LabelsEntry

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

string
value

string

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.

Tool Annotations

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