feat: Add dataplex-get-data-asset tool

cmd/internal/config_test.go

@@ -1860,6 +1860,10 @@ func TestPrebuiltTools(t *testing.T) {
 					Name:      "discovery",
 					ToolNames: []string{"search_entries", "lookup_entry", "search_aspect_types", "lookup_context", "search_dq_scans"},
 				},
+				"data-products": tools.ToolsetConfig{
+					Name:      "data-products",
+					ToolNames: []string{"search_entries", "lookup_entry", "search_aspect_types", "lookup_context", "list_data_products", "get_data_product", "list_data_assets", "get_data_asset"},
+				},
 				"enrich": tools.ToolsetConfig{
 					Name:      "enrich",
 					ToolNames: []string{"search_entries", "lookup_entry", "lookup_context", "generate_data_insights", "get_data_insights", "generate_data_profile", "get_data_profile", "discover_metadata", "get_discovery_results", "check_data_quality", "get_data_quality_results", "get_operation", "get_run_status"},

cmd/internal/imports.go

@@ -163,12 +163,16 @@ import (
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexdiscovermetadata"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgeneratedatainsights"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgeneratedataprofile"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetdataasset"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetdatainsights"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetdataproduct"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetdataprofile"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetdataqualityresults"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetdiscoveryresults"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetoperation"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexgetrunstatus"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexlistdataassets"
+	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexlistdataproducts"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexlookupcontext"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexlookupentry"
 	_ "github.com/googleapis/mcp-toolbox/internal/tools/dataplex/dataplexsearchaspecttypes"

docs/KNOWLEDGE_CATALOG_README.md

@@ -7,7 +7,8 @@ The Knowledge Catalog (formerly known as Dataplex) Model Context Protocol (MCP)
 An editor configured to use the Knowledge Catalog MCP server can use its AI capabilities to help you:
 
 - **Search Catalog** - Search for entries in Knowledge Catalog
-- **Explore Metadata** - Lookup specific entries and search aspect types
+- **Explore Metadata** - Lookup specific entries, search aspect types, and list/retrieve Data Products and Data Assets
+- **Data Quality** - Search for data quality scans
 
 ## Prerequisites
 
@@ -41,17 +42,26 @@ Once configured, the MCP server will automatically provide Knowledge Catalog cap
 
 *   "Search for entries related to 'sales' in Knowledge Catalog."
 *   "Look up details for the entry 'projects/my-project/locations/us-central1/entryGroups/my-group/entries/my-entry'."
+*   "List all Data Products."
+*   "Get details of the Data Product 'projects/my-project/locations/us-central1/dataProducts/my-product'."
+*   "List Data Assets for the Data Product 'projects/my-project/locations/us-central1/dataProducts/my-product'."
+*   "Get details of the Data Asset 'projects/my-project/locations/us-central1/dataProducts/my-product/dataAssets/my-asset'."
 
 ## Server Capabilities
 
 The Knowledge Catalog MCP server provides the following tools:
 
 | Tool Name             | Description                                                                                                                  |
 |:----------------------|:-----------------------------------------------------------------------------------------------------------------------------|
-| `search_entries`      | Search for entries in Knowledge Catalog.                                                                                      |
+| `search_entries`      | Search for entries in Knowledge Catalog.                                                                                     |
 | `lookup_entry`        | Retrieve specific subset of metadata (for example, schema, usage, business overview, and contacts) of a specific data asset. |
 | `search_aspect_types` | Find aspect types relevant to the query.                                                                                     |
 | `lookup_context`      | Retrieve rich metadata regarding one or more data assets along with their relationships.                                     |
+| `search_dq_scans`     | Search for Data Quality scans.                                                                                               |
+| `list_data_products`  | List Data Products for the current project.                                                                                  |
+| `get_data_product`    | Retrieve a specific Data Product.                                                                                            |
+| `list_data_assets`    | List Data Assets under a Data Product.                                                                                       |
+| `get_data_asset`      | Retrieve specific metadata regarding a Data Asset.                                                                           |
 
 ## Custom MCP Server Configuration
 

docs/en/integrations/knowledge-catalog/prebuilt-configs/knowledge-catalog.md

@@ -20,7 +20,11 @@ aliases:
     *   `lookup_entry`: Retrieves a specific entry from Knowledge Catalog.
     *   `search_aspect_types`: Finds aspect types relevant to the query.
     *   `lookup_context`: Retrieves rich metadata regarding one or more data assets along with their relationships.
-    *   `search_dq_scans`: Search for data quality scans in Dataplex.
+    *   `search_dq_scans`: Searches for data quality scans in Dataplex.
+    *   `list_data_products`: Lists Data Products across all locations.
+    *   `get_data_product`: Retrieves a specific Data Product.
+    *   `list_data_assets`: Lists Data Assets under a Data Product.
+    *   `get_data_asset`: Retrieves specific metadata regarding a Data Asset.
     *   `generate_data_insights`: Creates a new Dataplex Data Documentation scan template and triggers the run.
     *   `get_data_insights`: Retrieves the final generated data insights for a completed scan.
     *   `generate_data_profile`: Creates a new Dataplex Data Profile scan template and triggers the run.
@@ -33,5 +37,6 @@ aliases:
     *   `get_run_status`: Retrieves the execution status of the latest background job run.
 *   **Toolsets:**
     *   `discovery`: Metadata discovery and search toolset (`search_entries`, `lookup_entry`, `search_aspect_types`, `lookup_context`, `search_dq_scans`).
+    *   `data-products`: Data Products and Data Assets curation and management toolset (`search_entries`, `lookup_entry`, `search_aspect_types`, `lookup_context`, `list_data_products`, `get_data_product`, `list_data_assets`, `get_data_asset`).
     *   `enrich`: Metadata enrichment pipeline orchestration and execution toolset (`search_entries`, `lookup_entry`, `lookup_context`, `generate_data_insights`, `get_data_insights`, `generate_data_profile`, `get_data_profile`, `discover_metadata`, `get_discovery_results`, `check_data_quality`, `get_data_quality_results`, `get_operation`, `get_run_status`).
 

docs/en/integrations/knowledge-catalog/source.md

@@ -373,5 +373,34 @@ This abbreviated syntax works for the qualified predicates except for `label` in
 1. Use this tool to retrieve rich metadata regarding one or more data assets along with their relationships.
 2. You must provide the `resources` list with full resource names.
 ### Response
-1. Present the requested metadata and relationship information. 
-```
+1. Present the requested metadata and relationship information.
+
+## Tool: list_data_products
+### Request
+1. Use this tool to retrieve all Data Products globally across all locations.
+2. You can optionally filter by `display_name` (e.g., "`display_name:\"my-product\"`") or other fields using the Dataplex filter syntax.
+### Response
+1. Unless asked for a specific data product, respond with all entries returned.
+
+## Tool: get_data_product
+### Request
+1. Use this tool to retrieve detailed metadata for a specific Data Product.
+2. You must provide `locationId` and `dataProductId`.
+### Response
+1. Present the retrieved metadata for the Data Product, including its display name, description, owner emails, asset count, labels, and access groups.
+
+## Tool: list_data_assets
+### Request
+1. Use this tool to retrieve all Data Assets under a specific Data Product.
+2. You must provide `locationId` and `dataProductId`.
+3. You can optionally filter the listed assets using `filter` or limit the response using `pageSize`.
+### Response
+1. Present the retrieved list of Data Assets, including their names, resources, and labels.
+
+## Tool: get_data_asset
+### Request
+1. Use this tool to retrieve detailed metadata for a specific Data Asset.
+2. You must provide `locationId`, `dataProductId`, and `dataAssetId`.
+### Response
+1. Present the retrieved metadata for the Data Asset, including its name, resource, labels, and access group configurations.
+```

docs/en/integrations/knowledge-catalog/tools/knowledge-catalog-get-data-asset.md

@@ -0,0 +1,69 @@
+---
+title: "dataplex-get-data-asset"
+type: docs
+weight: 1
+description: >
+  A "dataplex-get-data-asset" tool retrieve specific metadata regarding a Data Asset.
+---
+
+## About
+
+A `dataplex-get-data-asset` tool retrieves detailed metadata for a specific Data Asset in Knowledge Catalog (formerly known as Dataplex).
+
+View the [Data Products guide][guide] for more information.
+
+[guide]: https://docs.cloud.google.com/dataplex/docs/data-products-overview
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Requirements
+
+### IAM Permissions
+
+Knowledge Catalog uses [Identity and Access Management (IAM)][iam-overview] to control
+user and group access to Knowledge Catalog resources. Toolbox will use your
+[Application Default Credentials (ADC)][adc] to authorize and authenticate when
+interacting with [Knowledge Catalog][dataplex-docs].
+
+In addition to [setting the ADC for your server][set-adc], you need to ensure
+the IAM identity has been given the correct IAM permissions for the tasks you
+intend to perform. See [Knowledge Catalog IAM permissions][iam-permissions]
+and [Knowledge Catalog IAM roles][iam-roles] for more information on
+applying IAM permissions and roles to an identity.
+
+[iam-overview]: https://cloud.google.com/dataplex/docs/iam-and-access-control
+[adc]: https://cloud.google.com/docs/authentication#adc
+[set-adc]: https://cloud.google.com/docs/authentication/provide-credentials-adc
+[iam-permissions]: https://cloud.google.com/dataplex/docs/iam-permissions
+[iam-roles]: https://cloud.google.com/dataplex/docs/iam-roles
+[dataplex-docs]: https://cloud.google.com/dataplex
+
+## Parameters
+
+The `dataplex-get-data-asset` tool has the following parameters:
+
+| **field**     | **type** | **required** | **description**                                                 |
+| ------------- | -------- | ------------ | --------------------------------------------------------------- |
+| locationId    | string   | true         | The location ID (e.g. `us`, `us-central1`) of the Data Product. |
+| dataProductId | string   | true         | The unique ID of the parent Data Product.                       |
+| dataAssetId   | string   | true         | The unique ID of the Data Asset.                                |
+
+## Example
+
+```yaml
+kind: tool
+name: get_data_asset
+type: dataplex-get-data-asset
+source: my-dataplex-source
+description: Use this tool to retrieve a Data Asset.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+| ----------- | -------- | ------------ | -------------------------------------------------- |
+| type        | string   | true         | Must be "dataplex-get-data-asset".                 |
+| source      | string   | true         | Name of the source the tool should execute on.     |
+| description | string   | true         | Description of the tool that is passed to the LLM. |

docs/en/integrations/knowledge-catalog/tools/knowledge-catalog-get-data-product.md

@@ -0,0 +1,68 @@
+---
+title: "dataplex-get-data-product"
+type: docs
+weight: 1
+description: >
+  A "dataplex-get-data-product" tool allows to retrieve a specific Data Product.
+---
+
+## About
+
+A `dataplex-get-data-product` tool retrieves detailed metadata for a specific Data Product in Knowledge Catalog (formerly known as Dataplex).
+
+View the [Data Products guide][guide] for more information.
+
+[guide]: https://docs.cloud.google.com/dataplex/docs/data-products-overview
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Requirements
+
+### IAM Permissions
+
+Knowledge Catalog uses [Identity and Access Management (IAM)][iam-overview] to control
+user and group access to Knowledge Catalog resources. Toolbox will use your
+[Application Default Credentials (ADC)][adc] to authorize and authenticate when
+interacting with [Knowledge Catalog][dataplex-docs].
+
+In addition to [setting the ADC for your server][set-adc], you need to ensure
+the IAM identity has been given the correct IAM permissions for the tasks you
+intend to perform. See [Knowledge Catalog IAM permissions][iam-permissions]
+and [Knowledge Catalog IAM roles][iam-roles] for more information on
+applying IAM permissions and roles to an identity.
+
+[iam-overview]: https://cloud.google.com/dataplex/docs/iam-and-access-control
+[adc]: https://cloud.google.com/docs/authentication#adc
+[set-adc]: https://cloud.google.com/docs/authentication/provide-credentials-adc
+[iam-permissions]: https://cloud.google.com/dataplex/docs/iam-permissions
+[iam-roles]: https://cloud.google.com/dataplex/docs/iam-roles
+[dataplex-docs]: https://cloud.google.com/dataplex
+
+## Parameters
+
+The `dataplex-get-data-product` tool has the following parameters:
+
+| **field**     | **type** | **required** | **description**                                                 |
+| ------------- | -------- | ------------ | --------------------------------------------------------------- |
+| locationId    | string   | true         | The location ID (e.g. `us`, `us-central1`) of the Data Product. |
+| dataProductId | string   | true         | The unique ID of the Data Product.                              |
+
+## Example
+
+```yaml
+kind: tool
+name: get_data_product
+type: dataplex-get-data-product
+source: my-dataplex-source
+description: Use this tool to retrieve a Data Product.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+| ----------- | -------- | ------------ | -------------------------------------------------- |
+| type        | string   | true         | Must be "dataplex-get-data-product".               |
+| source      | string   | true         | Name of the source the tool should execute on.     |
+| description | string   | true         | Description of the tool that is passed to the LLM. |

docs/en/integrations/knowledge-catalog/tools/knowledge-catalog-list-data-assets.md

@@ -0,0 +1,71 @@
+---
+title: "dataplex-list-data-assets"
+type: docs
+weight: 1
+description: >
+  A "dataplex-list-data-assets" tool allows to list Data Assets under a Data Product.
+---
+
+## About
+
+A `dataplex-list-data-assets` tool retrieves a list of Data Assets associated with a specific Data Product in Knowledge Catalog (formerly known as Dataplex).
+
+View the [Data Products guide][guide] for more information.
+
+[guide]: https://docs.cloud.google.com/dataplex/docs/data-products-overview
+
+## Compatible Sources
+
+{{< compatible-sources >}}
+
+## Requirements
+
+### IAM Permissions
+
+Knowledge Catalog uses [Identity and Access Management (IAM)][iam-overview] to control
+user and group access to Knowledge Catalog resources. Toolbox will use your
+[Application Default Credentials (ADC)][adc] to authorize and authenticate when
+interacting with [Knowledge Catalog][dataplex-docs].
+
+In addition to [setting the ADC for your server][set-adc], you need to ensure
+the IAM identity has been given the correct IAM permissions for the tasks you
+intend to perform. See [Knowledge Catalog IAM permissions][iam-permissions]
+and [Knowledge Catalog IAM roles][iam-roles] for more information on
+applying IAM permissions and roles to an identity.
+
+[iam-overview]: https://cloud.google.com/dataplex/docs/iam-and-access-control
+[adc]: https://cloud.google.com/docs/authentication#adc
+[set-adc]: https://cloud.google.com/docs/authentication/provide-credentials-adc
+[iam-permissions]: https://cloud.google.com/dataplex/docs/iam-permissions
+[iam-roles]: https://cloud.google.com/dataplex/docs/iam-roles
+[dataplex-docs]: https://cloud.google.com/dataplex
+
+## Parameters
+
+The `dataplex-list-data-assets` tool has the following parameters:
+
+| **field**     | **type** | **required** | **description**                                                 |
+| ------------- | -------- | ------------ | --------------------------------------------------------------- |
+| locationId    | string   | true         | The location ID (e.g. `us`, `us-central1`) of the Data Product. |
+| dataProductId | string   | true         | The unique ID of the parent Data Product.                       |
+| filter        | string   | false        | Filter string to list data assets.                              |
+| pageSize      | integer  | false        | Number of returned data assets in the page.                     |
+| orderBy       | string   | false        | Specifies the ordering of results.                              |
+
+## Example
+
+```yaml
+kind: tool
+name: list_data_assets
+type: dataplex-list-data-assets
+source: my-dataplex-source
+description: Use this tool to list Data Assets under a Data Product.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+| ----------- | -------- | ------------ | -------------------------------------------------- |
+| type        | string   | true         | Must be "dataplex-list-data-assets".               |
+| source      | string   | true         | Name of the source the tool should execute on.     |
+| description | string   | true         | Description of the tool that is passed to the LLM. |