MCP Tools Reference: cloudproductregistry.googleapis.com

Tool: list_logical_product_variants

Lists LogicalProductVariants matching the given criteria. LogicalProductVariants are specific variants of a LogicalProduct (e.g., Cloud SQL for MySQL is a variant of Cloud SQL Product). This tool should be invoked when you need to search for logical product variants based on specific filters, such as parent logical product.

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

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

Input Schema

Request message for ListLogicalProductVariants.

ListLogicalProductVariantsRequest

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

string

Required. Parent logical product id. Format: logicalProducts/{logical_product}
pageSize

integer

Optional. The maximum number of logical product variants to return. The service may return fewer than this value. If unspecified, at most 100 logical product variants will be returned. The maximum value is 500; values above 500 will be coerced to 500.
pageToken

string

Optional. A page token, received from a previous ListLogicalProductVariants call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to ListLogicalProductVariants must match the call that provided the page token.

Output Schema

Response message for ListLogicalProductVariants.

ListLogicalProductVariantsResponse

JSON representation 
{
  "logicalProductVariants": [
    {
      object (LogicalProductVariant)
    }
  ],
  "nextPageToken": string
}
Fields
logicalProductVariants[]

object (LogicalProductVariant)

Matched LogicalProductVariants
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.

LogicalProductVariant

JSON representation 
{
  "name": string,
  "title": string,
  "lifecycleState": enum (LifecycleState),
  "replaced": boolean,
  "replacement": string
}
Fields
name

string

Identifier. The resource name of the LogicalProductVariant. Format: logicalProducts/{logical_product}/variants/{variant}
title

string

Display name of the LogicalProductVariant.
lifecycleState

enum (LifecycleState)

Output only. Current Lifecycle state of the logical product variant.
replaced

boolean

Output only. Indicates whether the logical product variant has been replaced. If false, the variant is active. If true, the variant has been replaced by another type, and the replacement field contains the resource name of that replacement.
replacement

string

Output only. The resource name of the Logical Entity that the logical product variant is replaced by. This field is only populated when this logical product variant is replaced by some other type. Eg: logicalProducts/{logical_product}, productSuites/{product_suite}, etc.

LifecycleState

Enum representing the lifecycle state of the underlying entity.

Enums
LIFECYCLE_STATE_UNSPECIFIED The default value. This value is used if the lifecycle state is not set.
LIFECYCLE_STATE_PUBLIC_PREVIEW The entity is in Public Preview. It is available to all customers, but may not be feature-complete or have full support guarantees.
LIFECYCLE_STATE_PRIVATE_GA Deprecated: Private General Availability entities are not exposed. The entity is in Private General Availability. It is fully supported and stable, but only available to a select group of customers.
LIFECYCLE_STATE_GA The entity is Generally Available. It is fully supported, stable, and available to all customers.
LIFECYCLE_STATE_DEPRECATED The entity is deprecated. It is no longer recommended for use and may be removed in a future version.

Tool Annotations

Tool annotations are sent to MCP clients to describe the basic risk of a given tool. Most clients treat these hints as untrusted, but they can be used to decide when a confirmation prompt might be sent to a user.

Along with the title string, the following boolean hints are defined as follows:

  • readOnlyHint: If true, the tool doesn't modify its environment. Default: false.
  • destructiveHint: If true, then the tool can perform destructive actions. If false, then the tool can only perform additive actions. Default: true.
  • idempotentHint: If true, then calling the tool repeatedly with the same arguments will have no additional effect on its environment. Default: false.
  • openWorldHint: If true, then the tool can interact with an 'open world' of external entities. If false, then the tool can only interact with internal entities. For example, a web search tool would be open world, while a memory tool would not be open world.

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