feat(sources/cloud-logging-admin): add source, tools, integration test and docs by pkalsi97 · Pull Request #2137 · googleapis/mcp-toolbox

pkalsi97 · 2025-12-09T15:01:33Z

Description

This PR adds cloud logging admin source, tools, integration test and docs.

Source is implemented in a manner consistent with the BigQuery source. Supports ADC, OAuth and impersonate Service Account.
Total of 3 tools have been implemented

cloud-logging-admin-list-log-names
cloud-logging-admin-list-resource-types
cloud-logging-admin-query-logs

docs added for resource and tools.
Supporting integration test is added with updated ci

Note for reviewers:

Integration test runs on cloud, will require LOGADMIN_PROJECT env variable, the test creates logs in the project using the logging client and then verifies working of the tools using the logadmin client.
Moved cache.go from the BigQuery source to sources/cache.go due to shared utility.

Regarding Tools:

cloud-logging-admin-list-log-names uses client.Logs() instead of client.Entries(), as the latter is resource heavy and the tradeoff was not being able to apply any filters, tool has an optional parameter limit which defaults to 200.
cloud-logging-admin-list-resource-types uses client.ResourceDescriptors(ctx), aim of the tool is to enable the agent become aware of the the resources present and utilise this information in writing filters.
cloud-logging-admin-query-logs tool enables search and read logs from Google Cloud.
Parameters:
filter (optional): A text string to search for specific logs.
newestFirst (optional): A simple true/false switch for ordering.
startTime (optional): The start date and time to search from (e.g., 2025-12-09T00:00:00Z). Defaults to 30 days ago if not set.
endTime (optional): The end date and time to search up to. Defaults to "now".
verbose (optional): If set to true, Shows all available details for each log entry else shows only the main info (timestamp, message, severity).
limit (optional): The maximum number of log entries to return (default is 200).

Looking forward to the feedback here, as verbose is simply implemented to save context tokens, any alternative suggestion here is also welcomed.

Simple tools.yaml

sources:
  my-logging-admin:
    kind: cloud-logging-admin
    project: <Add project>
    useClientOAuth: false

tools:
  list_resource_types:
    kind: cloud-logging-admin-list-resource-types
    source: my-logging-admin
    description: List the types of resource that are indexed by Cloud Logging.
  list_log_names:
    kind: cloud-logging-admin-list-log-names
    source: my-logging-admin
    description: List log names matching a filter criteria.
  query_logs:
    kind: cloud-logging-admin-query-logs
    source: my-logging-admin
    description: query logs

PR Checklist

Make sure you reviewed
CONTRIBUTING.md
Make sure to open an issue as a
bug/issue
before writing your code! That way we can discuss the change, evaluate
designs, and agree on the general idea
Ensure the tests and linter pass
Code coverage does not decrease (if any source code was changed)
Appropriate docs were updated (if necessary)
Make sure to add ! if this involve a breaking change

🛠️ Fixes #1772
@anubhav756 @averikitsch Thanks for the guidance and feedback on the implementation plan.

gemini-code-assist · 2025-12-09T15:02:04Z

Summary of Changes

Hello @pkalsi97, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly expands the toolbox's capabilities by integrating with Google Cloud Logging. It introduces a new "cloud-logging-admin" source, enabling users to connect to Cloud Logging with various authentication methods. Complementing this source are three powerful new tools designed to manage and query log data: listing available log names, identifying resource types, and executing detailed log queries. These additions are supported by new documentation and robust integration tests, ensuring reliability and ease of use for managing Google Cloud logs.

Highlights

Cloud Logging Admin Source: Introduced a new source for Google Cloud Logging, supporting Application Default Credentials (ADC), OAuth, and service account impersonation for flexible authentication.
New Cloud Logging Tools: Added three new tools: "cloud-logging-admin-list-log-names" to list log names, "cloud-logging-admin-list-resource-types" to identify monitored resource types, and "cloud-logging-admin-query-logs" for searching and reading log entries with advanced filtering options.
Shared Cache Utility: The "cache.go" utility was refactored and moved from the BigQuery source to a common "sources" package, promoting code reuse across different sources.
Comprehensive Documentation: New documentation pages were added for the Cloud Logging Admin source and each of its associated tools, including usage examples and reference tables.
Integration Testing: A dedicated integration test suite was implemented for the Cloud Logging Admin features, configured to run in a cloud environment and verify the functionality of the new tools.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

This pull request introduces a new cloud-logging-admin source and three associated tools, complete with documentation and integration tests. The implementation is well-structured and consistent with the existing codebase. I've identified a critical issue that could lead to a panic, a few broken links in the documentation, and an area where error handling could be improved for a better user experience. Overall, this is a solid contribution.

averikitsch · 2025-12-18T21:09:05Z

Thank you for the PR. We will review soon.

Yuan325

Hi, please see the following updates from #2204 . Please parse the same updates to 2 other tools as well.

Let me know if there's any questions :) Thank you!

pkalsi97 · 2025-12-20T06:02:21Z

Hey @Yuan325 thanks for the review. I'll get it done shortly.

Yuan325

Hi @pkalsi97 Thank you for the contribution! I've left some feedbacks (nothing too major), please let me know if you require more clarification!

Yuan325 · 2026-01-14T22:14:03Z

/gcbrun

Yuan325 · 2026-01-14T22:27:16Z

I tried to run the integration tests and ran into some errors:
failure for TestLogAdminToolEndpoints/list-log-names:

cloud_logging_admin_integration_test.go:221: expected status 200, got 400

Also, seems like the cleanup was not working as expected:

failed to delete test log toolbox-integration-test-13988aeac015439ea22fe5494a21a77a: rpc error: code = PermissionDenied desc = Permission 'logging.logs.delete' denied on resource (or it may not exist).
--
  | error details: name = ErrorInfo reason = IAM_PERMISSION_DENIED domain = iam.googleapis.com metadata = map[permission:logging.logs.delete]

Let me know if there's anything I should set up in our test GCP project for this to work. Thank you!

pkalsi97 · 2026-01-15T08:13:32Z

@Yuan325 Thanks for review! I have made the changes as requested.

I think both of the failures in the integration test are happening because the service account might not have roles/logging.admin permission. Can you double check this once and let me know ?

Yuan325 · 2026-01-28T20:58:43Z

/gcbrun

…t, docs

…pointer dereference

Yuan325 · 2026-01-28T21:59:57Z

/gcbrun

Yuan325

Thank you for your contribution! :)

@anubhav756

…tion test and docs (#2137) ## Description This PR adds cloud logging admin source, tools, integration test and docs. 1. Source is implemented in a manner consistent with the BigQuery source. Supports ADC, OAuth and impersonate Service Account. 2. Total of 3 tools have been implemented - `cloud-logging-admin-list-log-names` - `cloud-logging-admin-list-resource-types` - `cloud-logging-admin-query-logs` 3. docs added for resource and tools. 4. Supporting integration test is added with updated ci Note for reviewers: 1. Integration test runs on cloud, will require `LOGADMIN_PROJECT` env variable, the test creates logs in the project using the `logging` client and then verifies working of the tools using the `logadmin` client. 2. Moved `cache.go` from the BigQuery source to `sources/cache.go` due to shared utility. Regarding Tools: 1. `cloud-logging-admin-list-log-names` uses `client.Logs()` instead of `client.Entries()`, as the latter is resource heavy and the tradeoff was not being able to apply any filters, tool has an optional parameter `limit` which defaults to 200. 2. `cloud-logging-admin-list-resource-types` uses `client.ResourceDescriptors(ctx)`, aim of the tool is to enable the agent become aware of the the resources present and utilise this information in writing filters. 3. `cloud-logging-admin-query-logs` tool enables search and read logs from Google Cloud. Parameters: `filter` (optional): A text string to search for specific logs. `newestFirst` (optional): A simple true/false switch for ordering. `startTime ` (optional): The start date and time to search from (e.g., 2025-12-09T00:00:00Z). Defaults to 30 days ago if not set. `endTime` (optional): The end date and time to search up to. Defaults to "now". `verbose` (optional): If set to true, Shows all available details for each log entry else shows only the main info (timestamp, message, severity). `limit` (optional): The maximum number of log entries to return (default is 200). Looking forward to the feedback here, as `verbose` is simply implemented to save context tokens, any alternative suggestion here is also welcomed. Simple tools.yaml ``` sources: my-logging-admin: kind: cloud-logging-admin project: <Add project> useClientOAuth: false tools: list_resource_types: kind: cloud-logging-admin-list-resource-types source: my-logging-admin description: List the types of resource that are indexed by Cloud Logging. list_log_names: kind: cloud-logging-admin-list-log-names source: my-logging-admin description: List log names matching a filter criteria. query_logs: kind: cloud-logging-admin-query-logs source: my-logging-admin description: query logs ``` ## PR Checklist - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #1772 @anubhav756 @averikitsch Thanks for the guidance and feedback on the implementation plan. --------- Co-authored-by: Yuan Teoh <yuanteoh@google.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> 252fc30

@anubhav756

…tion test and docs (googleapis#2137) ## Description This PR adds cloud logging admin source, tools, integration test and docs. 1. Source is implemented in a manner consistent with the BigQuery source. Supports ADC, OAuth and impersonate Service Account. 2. Total of 3 tools have been implemented - `cloud-logging-admin-list-log-names` - `cloud-logging-admin-list-resource-types` - `cloud-logging-admin-query-logs` 3. docs added for resource and tools. 4. Supporting integration test is added with updated ci Note for reviewers: 1. Integration test runs on cloud, will require `LOGADMIN_PROJECT` env variable, the test creates logs in the project using the `logging` client and then verifies working of the tools using the `logadmin` client. 2. Moved `cache.go` from the BigQuery source to `sources/cache.go` due to shared utility. Regarding Tools: 1. `cloud-logging-admin-list-log-names` uses `client.Logs()` instead of `client.Entries()`, as the latter is resource heavy and the tradeoff was not being able to apply any filters, tool has an optional parameter `limit` which defaults to 200. 2. `cloud-logging-admin-list-resource-types` uses `client.ResourceDescriptors(ctx)`, aim of the tool is to enable the agent become aware of the the resources present and utilise this information in writing filters. 3. `cloud-logging-admin-query-logs` tool enables search and read logs from Google Cloud. Parameters: `filter` (optional): A text string to search for specific logs. `newestFirst` (optional): A simple true/false switch for ordering. `startTime ` (optional): The start date and time to search from (e.g., 2025-12-09T00:00:00Z). Defaults to 30 days ago if not set. `endTime` (optional): The end date and time to search up to. Defaults to "now". `verbose` (optional): If set to true, Shows all available details for each log entry else shows only the main info (timestamp, message, severity). `limit` (optional): The maximum number of log entries to return (default is 200). Looking forward to the feedback here, as `verbose` is simply implemented to save context tokens, any alternative suggestion here is also welcomed. Simple tools.yaml ``` sources: my-logging-admin: kind: cloud-logging-admin project: <Add project> useClientOAuth: false tools: list_resource_types: kind: cloud-logging-admin-list-resource-types source: my-logging-admin description: List the types of resource that are indexed by Cloud Logging. list_log_names: kind: cloud-logging-admin-list-log-names source: my-logging-admin description: List log names matching a filter criteria. query_logs: kind: cloud-logging-admin-query-logs source: my-logging-admin description: query logs ``` ## PR Checklist - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes googleapis#1772 @anubhav756 @averikitsch Thanks for the guidance and feedback on the implementation plan. --------- Co-authored-by: Yuan Teoh <yuanteoh@google.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> 252fc30

@anubhav756

…t and docs (googleapis#2137) ## Description This PR adds cloud logging admin source, tools, integration test and docs. 1. Source is implemented in a manner consistent with the BigQuery source. Supports ADC, OAuth and impersonate Service Account. 2. Total of 3 tools have been implemented - `cloud-logging-admin-list-log-names` - `cloud-logging-admin-list-resource-types` - `cloud-logging-admin-query-logs` 3. docs added for resource and tools. 4. Supporting integration test is added with updated ci Note for reviewers: 1. Integration test runs on cloud, will require `LOGADMIN_PROJECT` env variable, the test creates logs in the project using the `logging` client and then verifies working of the tools using the `logadmin` client. 2. Moved `cache.go` from the BigQuery source to `sources/cache.go` due to shared utility. Regarding Tools: 1. `cloud-logging-admin-list-log-names` uses `client.Logs()` instead of `client.Entries()`, as the latter is resource heavy and the tradeoff was not being able to apply any filters, tool has an optional parameter `limit` which defaults to 200. 2. `cloud-logging-admin-list-resource-types` uses `client.ResourceDescriptors(ctx)`, aim of the tool is to enable the agent become aware of the the resources present and utilise this information in writing filters. 3. `cloud-logging-admin-query-logs` tool enables search and read logs from Google Cloud. Parameters: `filter` (optional): A text string to search for specific logs. `newestFirst` (optional): A simple true/false switch for ordering. `startTime ` (optional): The start date and time to search from (e.g., 2025-12-09T00:00:00Z). Defaults to 30 days ago if not set. `endTime` (optional): The end date and time to search up to. Defaults to "now". `verbose` (optional): If set to true, Shows all available details for each log entry else shows only the main info (timestamp, message, severity). `limit` (optional): The maximum number of log entries to return (default is 200). Looking forward to the feedback here, as `verbose` is simply implemented to save context tokens, any alternative suggestion here is also welcomed. Simple tools.yaml ``` sources: my-logging-admin: kind: cloud-logging-admin project: <Add project> useClientOAuth: false tools: list_resource_types: kind: cloud-logging-admin-list-resource-types source: my-logging-admin description: List the types of resource that are indexed by Cloud Logging. list_log_names: kind: cloud-logging-admin-list-log-names source: my-logging-admin description: List log names matching a filter criteria. query_logs: kind: cloud-logging-admin-query-logs source: my-logging-admin description: query logs ``` ## PR Checklist - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes googleapis#1772 @anubhav756 @averikitsch Thanks for the guidance and feedback on the implementation plan. --------- Co-authored-by: Yuan Teoh <yuanteoh@google.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.27.0](v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([#1987](#1987)) ([478a0bd](478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([#2353](#2353)) ([6e49ba4](6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([#2392](#2392)) ([80ef346](80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([#2137](#2137)) ([252fc30](252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([#2006](#2006)) ([1fdd99a](1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([#2340](#2340)) ([e995349](e995349)) * **server:** Add Tool call error categories ([#2387](#2387)) ([32cb4db](32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([#2430](#2430)) ([a15a128](a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([#2347](#2347)) ([1d7c498](1d7c498)) * **sources/cockroachdb:** Update kind to type ([#2465](#2465)) ([2d341ac](2d341ac)) * Surface Dataplex API errors in MCP results ([#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.27.0](v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([#1987](#1987)) ([478a0bd](478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([#2353](#2353)) ([6e49ba4](6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([#2392](#2392)) ([80ef346](80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([#2137](#2137)) ([252fc30](252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([#2006](#2006)) ([1fdd99a](1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([#2340](#2340)) ([e995349](e995349)) * **server:** Add Tool call error categories ([#2387](#2387)) ([32cb4db](32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([#2430](#2430)) ([a15a128](a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([#2347](#2347)) ([1d7c498](1d7c498)) * **sources/cockroachdb:** Update kind to type ([#2465](#2465)) ([2d341ac](2d341ac)) * Surface Dataplex API errors in MCP results ([#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> c5524d3

🤖 I have created a release *beep* *boop* --- ## [0.27.0](googleapis/mcp-toolbox@v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([googleapis#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([googleapis#1987](googleapis#1987)) ([478a0bd](googleapis@478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([googleapis#2353](googleapis#2353)) ([6e49ba4](googleapis@6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([googleapis#2392](googleapis#2392)) ([80ef346](googleapis@80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([googleapis#2137](googleapis#2137)) ([252fc30](googleapis@252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([googleapis#2006](googleapis#2006)) ([1fdd99a](googleapis@1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([googleapis#2340](googleapis#2340)) ([e995349](googleapis@e995349)) * **server:** Add Tool call error categories ([googleapis#2387](googleapis#2387)) ([32cb4db](googleapis@32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([googleapis#2430](googleapis#2430)) ([a15a128](googleapis@a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([googleapis#2347](googleapis#2347)) ([1d7c498](googleapis@1d7c498)) * **sources/cockroachdb:** Update kind to type ([googleapis#2465](googleapis#2465)) ([2d341ac](googleapis@2d341ac)) * Surface Dataplex API errors in MCP results ([googleapis#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com> c5524d3

🤖 I have created a release *beep* *boop* --- ## [0.27.0](v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([#1987](#1987)) ([478a0bd](478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([#2353](#2353)) ([6e49ba4](6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([#2392](#2392)) ([80ef346](80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([#2137](#2137)) ([252fc30](252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([#2006](#2006)) ([1fdd99a](1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([#2340](#2340)) ([e995349](e995349)) * **server:** Add Tool call error categories ([#2387](#2387)) ([32cb4db](32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([#2430](#2430)) ([a15a128](a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([#2347](#2347)) ([1d7c498](1d7c498)) * **sources/cockroachdb:** Update kind to type ([#2465](#2465)) ([2d341ac](2d341ac)) * Surface Dataplex API errors in MCP results ([#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.27.0](googleapis/mcp-toolbox@v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([googleapis#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([googleapis#1987](googleapis#1987)) ([478a0bd](googleapis@478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([googleapis#2353](googleapis#2353)) ([6e49ba4](googleapis@6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([googleapis#2392](googleapis#2392)) ([80ef346](googleapis@80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([googleapis#2137](googleapis#2137)) ([252fc30](googleapis@252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([googleapis#2006](googleapis#2006)) ([1fdd99a](googleapis@1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([googleapis#2340](googleapis#2340)) ([e995349](googleapis@e995349)) * **server:** Add Tool call error categories ([googleapis#2387](googleapis#2387)) ([32cb4db](googleapis@32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([googleapis#2430](googleapis#2430)) ([a15a128](googleapis@a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([googleapis#2347](googleapis#2347)) ([1d7c498](googleapis@1d7c498)) * **sources/cockroachdb:** Update kind to type ([googleapis#2465](googleapis#2465)) ([2d341ac](googleapis@2d341ac)) * Surface Dataplex API errors in MCP results ([googleapis#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

@anubhav756

…t and docs (googleapis#2137) ## Description This PR adds cloud logging admin source, tools, integration test and docs. 1. Source is implemented in a manner consistent with the BigQuery source. Supports ADC, OAuth and impersonate Service Account. 2. Total of 3 tools have been implemented - `cloud-logging-admin-list-log-names` - `cloud-logging-admin-list-resource-types` - `cloud-logging-admin-query-logs` 3. docs added for resource and tools. 4. Supporting integration test is added with updated ci Note for reviewers: 1. Integration test runs on cloud, will require `LOGADMIN_PROJECT` env variable, the test creates logs in the project using the `logging` client and then verifies working of the tools using the `logadmin` client. 2. Moved `cache.go` from the BigQuery source to `sources/cache.go` due to shared utility. Regarding Tools: 1. `cloud-logging-admin-list-log-names` uses `client.Logs()` instead of `client.Entries()`, as the latter is resource heavy and the tradeoff was not being able to apply any filters, tool has an optional parameter `limit` which defaults to 200. 2. `cloud-logging-admin-list-resource-types` uses `client.ResourceDescriptors(ctx)`, aim of the tool is to enable the agent become aware of the the resources present and utilise this information in writing filters. 3. `cloud-logging-admin-query-logs` tool enables search and read logs from Google Cloud. Parameters: `filter` (optional): A text string to search for specific logs. `newestFirst` (optional): A simple true/false switch for ordering. `startTime ` (optional): The start date and time to search from (e.g., 2025-12-09T00:00:00Z). Defaults to 30 days ago if not set. `endTime` (optional): The end date and time to search up to. Defaults to "now". `verbose` (optional): If set to true, Shows all available details for each log entry else shows only the main info (timestamp, message, severity). `limit` (optional): The maximum number of log entries to return (default is 200). Looking forward to the feedback here, as `verbose` is simply implemented to save context tokens, any alternative suggestion here is also welcomed. Simple tools.yaml ``` sources: my-logging-admin: kind: cloud-logging-admin project: <Add project> useClientOAuth: false tools: list_resource_types: kind: cloud-logging-admin-list-resource-types source: my-logging-admin description: List the types of resource that are indexed by Cloud Logging. list_log_names: kind: cloud-logging-admin-list-log-names source: my-logging-admin description: List log names matching a filter criteria. query_logs: kind: cloud-logging-admin-query-logs source: my-logging-admin description: query logs ``` ## PR Checklist - [x] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [x] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [x] Ensure the tests and linter pass - [x] Code coverage does not decrease (if any source code was changed) - [x] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes googleapis#1772 @anubhav756 @averikitsch Thanks for the guidance and feedback on the implementation plan. --------- Co-authored-by: Yuan Teoh <yuanteoh@google.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.27.0](googleapis/mcp-toolbox@v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([googleapis#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([googleapis#1987](googleapis#1987)) ([478a0bd](googleapis@478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([googleapis#2353](googleapis#2353)) ([6e49ba4](googleapis@6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([googleapis#2392](googleapis#2392)) ([80ef346](googleapis@80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([googleapis#2137](googleapis#2137)) ([252fc30](googleapis@252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([googleapis#2006](googleapis#2006)) ([1fdd99a](googleapis@1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([googleapis#2340](googleapis#2340)) ([e995349](googleapis@e995349)) * **server:** Add Tool call error categories ([googleapis#2387](googleapis#2387)) ([32cb4db](googleapis@32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([googleapis#2430](googleapis#2430)) ([a15a128](googleapis@a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([googleapis#2347](googleapis#2347)) ([1d7c498](googleapis@1d7c498)) * **sources/cockroachdb:** Update kind to type ([googleapis#2465](googleapis#2465)) ([2d341ac](googleapis@2d341ac)) * Surface Dataplex API errors in MCP results ([googleapis#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.27.0](googleapis/mcp-toolbox@v0.26.0...v0.27.0) (2026-02-12) ### ⚠ BREAKING CHANGES * Update configuration file v2 ([#2369](https://github.com/googleapis/genai-toolbox/issues/2369))([293c1d6](https://github.com/googleapis/genai-toolbox/commit/293c1d6889c39807855ba5e01d4c13ba2a4c50ce)) * Update/add detailed telemetry for mcp endpoint compliant with OTEL semantic convention ([#1987](googleapis/mcp-toolbox#1987)) ([478a0bd](googleapis/mcp-toolbox@478a0bd)) ### Features * **cli/invoke:** Add support for direct tool invocation from CLI ([#2353](googleapis/mcp-toolbox#2353)) ([6e49ba4](googleapis/mcp-toolbox@6e49ba4)) * **cli/skills:** Add support for generating agent skills from toolset ([#2392](googleapis/mcp-toolbox#2392)) ([80ef346](googleapis/mcp-toolbox@80ef346)) * **cloud-logging-admin:** Add source, tools, integration test and docs ([#2137](googleapis/mcp-toolbox#2137)) ([252fc30](googleapis/mcp-toolbox@252fc30)) * **cockroachdb:** Add CockroachDB integration with cockroach-go ([#2006](googleapis/mcp-toolbox#2006)) ([1fdd99a](googleapis/mcp-toolbox@1fdd99a)) * **prebuiltconfigs/alloydb-omni:** Implement Alloydb omni dataplane tools ([#2340](googleapis/mcp-toolbox#2340)) ([e995349](googleapis/mcp-toolbox@e995349)) * **server:** Add Tool call error categories ([#2387](googleapis/mcp-toolbox#2387)) ([32cb4db](googleapis/mcp-toolbox@32cb4db)) * **tools/looker:** support `looker-validate-project` tool ([#2430](googleapis/mcp-toolbox#2430)) ([a15a128](googleapis/mcp-toolbox@a15a128)) ### Bug Fixes * **dataplex:** Capture GCP HTTP errors in MCP Toolbox ([#2347](googleapis/mcp-toolbox#2347)) ([1d7c498](googleapis/mcp-toolbox@1d7c498)) * **sources/cockroachdb:** Update kind to type ([#2465](googleapis/mcp-toolbox#2465)) ([2d341ac](googleapis/mcp-toolbox@2d341ac)) * Surface Dataplex API errors in MCP results ([#2347](https://github.com/googleapis/genai-toolbox/pull/2347))([1d7c498](https://github.com/googleapis/genai-toolbox/commit/1d7c4981164c34b4d7bc8edecfd449f57ad11e15)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --------- Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com> Co-authored-by: Yuan Teoh <45984206+Yuan325@users.noreply.github.com>

pkalsi97 requested review from a team December 9, 2025 15:01

blunderbuss-gcf Bot assigned Yuan325 Dec 9, 2025

gemini-code-assist Bot reviewed Dec 9, 2025

View reviewed changes

Yuan325 assigned duwenxin99 and unassigned Yuan325 Dec 17, 2025

Yuan325 added the priority: p2 Moderately-important priority. Fix may not be included in next release. label Dec 17, 2025

Yuan325 reviewed Dec 20, 2025

View reviewed changes

pkalsi97 requested a review from Yuan325 December 20, 2025 07:33

duwenxin99 assigned Yuan325 and unassigned duwenxin99 Jan 8, 2026

Yuan325 requested changes Jan 14, 2026

View reviewed changes

pkalsi97 requested a review from Yuan325 January 15, 2026 08:18

pkalsi97 added 5 commits January 28, 2026 13:47

feat(sources/cloud-logging-admin): add source, tools, integration tes…

a0ea7b5

…t, docs

fix: updated tools doc link, removed lognames error and resolved nil …

a8a9f24

…pointer dereference

refactor(cloud-logging-admin): decouple source from tools

c0ecfa2

test(cloud-logging-admin): remove redundant initialize tests

cb9d1c8

Refactor Cloud Logging Admin tools and integration test

6b4236b

Yuan325 force-pushed the feat/cloud-logging-admin branch from 365fd71 to f7d87d6 Compare January 28, 2026 21:49

config updates

cf685f2

Yuan325 force-pushed the feat/cloud-logging-admin branch from f7d87d6 to cf685f2 Compare January 28, 2026 21:59

Merge branch 'main' into feat/cloud-logging-admin

eb4841a

Yuan325 added the tests: run Label to trigger Github Action tests. label Jan 28, 2026

github-actions Bot removed the tests: run Label to trigger Github Action tests. label Jan 28, 2026

Yuan325 approved these changes Jan 28, 2026

View reviewed changes

Yuan325 merged commit 252fc30 into googleapis:main Jan 28, 2026
16 checks passed

release-please Bot mentioned this pull request Jan 28, 2026

chore(main): release 0.27.0 #2363

Merged

pkalsi97 deleted the feat/cloud-logging-admin branch January 29, 2026 03:21

BrewTestBot mentioned this pull request Feb 13, 2026

mcp-toolbox 0.27.0 Homebrew/homebrew-core#267330

Merged

github-actions Bot mentioned this pull request Feb 20, 2026

feat(tools/looker): Enable Get All Lookml Tests tool for Looker Anthrino/genai-toolbox#3

Open

6 tasks

Conversation

pkalsi97 commented Dec 9, 2025

Description

PR Checklist

Uh oh!

gemini-code-assist Bot commented Dec 9, 2025

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

averikitsch commented Dec 18, 2025

Uh oh!

Yuan325 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pkalsi97 commented Dec 20, 2025

Uh oh!

Yuan325 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Yuan325 commented Jan 14, 2026

Uh oh!

Yuan325 commented Jan 14, 2026

Uh oh!

pkalsi97 commented Jan 15, 2026

Uh oh!

Yuan325 commented Jan 28, 2026

Uh oh!

Yuan325 commented Jan 28, 2026

Uh oh!

Yuan325 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants