feat: add dataplex-get-data-product 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"},
+				},
 				"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

@@ -164,11 +164,13 @@ import (
 	_ "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/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/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
+- **Data Quality** - Search for data quality scans
 
 ## Prerequisites
 
@@ -41,17 +42,22 @@ 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'."
 
 ## 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.                                                                                            |
 
 ## Custom MCP Server Configuration
 

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

@@ -21,6 +21,8 @@ aliases:
     *   `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.
+    *   `list_data_products`: Lists Data Products across all locations.
+    *   `get_data_product`: Retrieves a specific Data Product.
     *   `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 +35,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`).
     *   `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,19 @@ 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.
+```

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-products.md

@@ -0,0 +1,69 @@
+---
+title: "dataplex-list-data-products"
+type: docs
+weight: 1
+description: >
+  A "dataplex-list-data-products" tool allows to list data products.
+---
+
+## About
+
+A `dataplex-list-data-products` tool lists all Data Products in Knowledge Catalog (formerly known as Dataplex) across all locations (globally).
+
+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-products` tool has the following optional parameters:
+
+| **field** | **type** | **required** | **description**                                                                                                                                                                         |
+| --------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| filter    | string   | false        | Filter string to list data products. Use `=` for exact matching and `:` for contains matching. String literals must be enclosed within double quotes. E.g. `display_name:"my-product"`. |
+| pageSize  | integer  | false        | Number of returned data products in the page. Defaults to `10`.                                                                                                                         |
+| orderBy   | string   | false        | Specifies the ordering of results.                                                                                                                                                      |
+
+## Example
+
+```yaml
+kind: tool
+name: list_data_products
+type: dataplex-list-data-products
+source: my-dataplex-source
+description: Use this tool to list Data Products.
+```
+
+## Reference
+
+| **field**   | **type** | **required** | **description**                                    |
+| ----------- | -------- | ------------ | -------------------------------------------------- |
+| type        | string   | true         | Must be "dataplex-list-data-products".             |
+| 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. |

internal/prebuiltconfigs/tools/dataplex.yaml

@@ -48,6 +48,18 @@ source: dataplex-source
 description: Use this tool to search for data quality scans in Dataplex.
 ---
 kind: tool
+name: list_data_products
+type: dataplex-list-data-products
+source: dataplex-source
+description: Lists Data Products across all locations.
+---
+kind: tool
+name: get_data_product
+type: dataplex-get-data-product
+source: dataplex-source
+description: Retrieves specific metadata regarding a Data Product.
+---
+kind: tool
 name: generate_data_insights
 type: dataplex-generate-data-insights
 source: dataplex-source
@@ -232,6 +244,16 @@ tools:
 - search_dq_scans
 ---
 kind: toolset
+name: data-products
+tools:
+- search_entries
+- lookup_entry
+- search_aspect_types
+- lookup_context
+- list_data_products
+- get_data_product
+---
+kind: toolset
 name: enrich
 tools:
 - search_entries