feat!: removing deprecations and update tools-file flag by Yuan325 · Pull Request #2806 · googleapis/mcp-toolbox

Yuan325 · 2026-03-20T22:53:10Z

This PR includes the following:

BREAKING CHANGE: Removing cloudsqlmssql support for ipAddress
BREAKING CHANGE: Removing support for authSources
BREAKING CHANGE: Updating flat format config's kind value from plural to singular
Deprecating the tools-file, tools-files, and tools-folder flag and adding new config, configs, and config-folder flag.

This is the main PR merging into main that includes previously approved PRs.

gemini-code-assist · 2026-03-20T22:58:36Z

Summary of Changes

Hello, 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 introduces significant refactoring to enhance the clarity and consistency of configuration management. The primary focus is on standardizing YAML kind values to singular forms and updating command-line flags for configuration files. These changes aim to streamline the user experience and improve the maintainability of the codebase by aligning naming conventions and removing deprecated features.

Highlights

Breaking Change: Removed Cloud SQL MSSQL IP Address Support: The cloudsqlmssql source no longer supports the ipAddress field, simplifying its configuration.
Breaking Change: Removed Auth Sources Support: The authSources configuration has been removed, standardizing authentication service definitions under authServices.
Breaking Change: Standardized YAML kind Values: Configuration kind values in YAML files have been updated from plural (e.g., sources, tools) to singular (e.g., source, tool) for improved consistency.
Deprecated Configuration Flags: The command-line flags --tools-file, --tools-files, and --tools-folder have been deprecated and replaced with --config, --configs, and --config-folder respectively, with backward compatibility warnings.

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.

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 several breaking changes aimed at cleaning up deprecations and standardizing configuration. The changes include renaming configuration flags from tools-file to config and its variants, updating the YAML configuration kind from plural to singular, and removing support for the deprecated authSources. The refactoring is extensive, touching code, tests, and a large number of documentation files to ensure consistency. The implementation appears thorough and correct across the entire codebase.

github-actions · 2026-03-20T23:16:39Z

Link Resolution Note

Local links and directory changes work differently on GitHub than on the docsite. You must ensure fixes pass the GitHub check and also work with hugo server.
See Link Checking and Fixing with Lychee for more details.

Summary

Status	Count
🔍 Total	1038
✅ Successful	834
⏳ Timeouts	0
👻 Excluded	36
❓ Unknown	0
🚫 Errors	46
⛔ Unsupported	0

Errors per input

Errors in DEVELOPER.md

[ERROR] https://play.dgraph.io/ | Network error: Connection failed. Check network connectivity and firewall settings (error sending request for url (https://play.dgraph.io/)): Connection failed. Check network connectivity and firewall settings

Errors in docs/en/concepts/telemetry/index.md

Errors in docs/en/resources/sources/alloydb-admin.md

Errors in docs/en/resources/sources/bigtable.md

Errors in docs/en/resources/sources/cloud-healthcare.md

Errors in docs/en/resources/sources/cloud-logging-admin.md

Errors in docs/en/resources/sources/cloud-sql-mssql.md

Errors in docs/en/resources/sources/cloud-sql-pg.md

Errors in docs/en/resources/sources/dataproc.md

Errors in docs/en/resources/sources/redis.md

Errors in docs/en/resources/sources/serverless-spark.md

Errors in docs/en/resources/sources/valkey.md

Errors in docs/en/resources/tools/_index.md

[ERROR] file:///home/runner/work/genai-toolbox/genai-toolbox/docs/en/sdks/python-sdk/core#option-a-binding-parameters-to-a-loaded-tool | Cannot find file: File not found. Check if file exists and path is correct

Errors in docs/en/resources/tools/alloydb/alloydb-create-cluster.md

[ERROR] https://console.cloud.google.com/apis/library/alloydb.googleapis.com | Network error: HTTP/2 protocol error. Server may not support HTTP/2 properly (error sending request for url (https://console.cloud.google.com/apis/library/alloydb.googleapis.com)): HTTP/2 protocol error. Server may not support HTTP/2 properly

Errors in docs/en/resources/tools/alloydb/alloydb-create-instance.md

[ERROR] https://console.cloud.google.com/apis/library/alloydb.googleapis.com | Error (cached)

Errors in docs/en/resources/tools/alloydb/alloydb-create-user.md

[ERROR] https://console.cloud.google.com/apis/library/alloydb.googleapis.com | Error (cached)

Errors in docs/en/resources/tools/bigquery/bigquery-analyze-contribution.md

Errors in docs/en/resources/tools/bigtable/bigtable-sql.md

Errors in docs/en/resources/tools/cloudsql/cloudsqlcloneinstance.md

Errors in docs/en/resources/tools/cloudsql/cloudsqlrestorebackup.md

Errors in docs/en/resources/tools/firestore/firestore-add-documents.md

Errors in docs/en/resources/tools/firestore/firestore-update-document.md

Errors in docs/TOOLBOX_README.md

Errors in README.md

[404] https://googleapis.github.io/genai-toolbox/about/versioning/ | Rejected status code: 404 Not Found (configurable with "accept" option)

Full Github Actions output

github-actions · 2026-03-20T23:17:46Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2806/

github-actions · 2026-03-20T23:31:34Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2806/

github-actions · 2026-03-20T23:45:00Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2806/

The ipAddress field had not been used for awhile. It was previously kept for backwards compatibility. We will be removing it from the config.

Kept `AuthServices []string `json:"authSources"`` in `ParameterManifest` since those will be removed when we remove support for native endpoint. Or else it will break the sdk implementation.

Update all the `kind` value from plural to singular. This breaking change only affect users that are currently using the config file v2 format. Config file with the v1 format will still be compatible since we manually convert the config file to the right format under the hood.

* Remove deprecated support for `tools_file` flag. * Deprecate `tools-file`, `tools-files`, and `tools-folder` flag. Renaming them to `config`, `configs`, and `config-folder` flag.

github-actions · 2026-03-23T21:57:21Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2806/

github-actions · 2026-03-23T23:51:45Z

🔎 Preview at https://googleapis.github.io/genai-toolbox/previews/PR-2806/

github-actions · 2026-03-24T00:02:39Z

🧨 Preview deployments removed.

This PR includes the following: * BREAKING CHANGE: Removing cloudsqlmssql support for ipAddress * BREAKING CHANGE: Removing support for authSources * BREAKING CHANGE: Updating flat format config's `kind` value from plural to singular * Deprecating the `tools-file`, `tools-files`, and `tools-folder` flag and adding new `config`, `configs`, and `config-folder` flag. This is the main PR merging into main that includes previously approved PRs. ab64c95

…leapis#2806) This PR includes the following: * BREAKING CHANGE: Removing cloudsqlmssql support for ipAddress * BREAKING CHANGE: Removing support for authSources * BREAKING CHANGE: Updating flat format config's `kind` value from plural to singular * Deprecating the `tools-file`, `tools-files`, and `tools-folder` flag and adding new `config`, `configs`, and `config-folder` flag. This is the main PR merging into main that includes previously approved PRs. ab64c95

) This PR includes the following: * BREAKING CHANGE: Removing cloudsqlmssql support for ipAddress * BREAKING CHANGE: Removing support for authSources * BREAKING CHANGE: Updating flat format config's `kind` value from plural to singular * Deprecating the `tools-file`, `tools-files`, and `tools-folder` flag and adding new `config`, `configs`, and `config-folder` flag. This is the main PR merging into main that includes previously approved PRs.

🤖 I have created a release *beep* *boop* --- ## [0.31.0](v0.30.0...v0.31.0) (2026-03-26) ### ⚠ BREAKING CHANGES * release upgraded docsite ([#2831](#2831)) * **http:** sanitize non-2xx error output ([#2654](#2654)) * add a new `enable-api` flag ([#2846](#2846)) * remove deprecations and update tools-file flag ([#2806](#2806)) ### Features * Add a new `enable-api` flag ([#2846](#2846)) ([7a070da](7a070da)) * **auth:** Add generic `authService` type for MCP ([#2619](#2619)) ([f6678f8](f6678f8)) * **auth:** Add Protected Resource Metadata endpoint ([#2698](#2698)) ([b53dcf2](b53dcf2)) * **auth:** Support manual PRM override ([#2717](#2717)) ([283e4e3](283e4e3)) * **dataplex:** Add support for lookup context tool. ([#2744](#2744)) ([facb69d](facb69d)) * Remove deprecations and update tools-file flag ([#2806](#2806)) ([ab64c95](ab64c95)) ### Bug Fixes * **ci:** Remove search index generation from preview deployment workflow ([#2859](#2859)) ([f8891b8](f8891b8)) * **docs:** Skip empty folders in pagination & reduce PR comment noise ([#2853](#2853)) ([9ebd93a](9ebd93a)) * **http:** Sanitize non-2xx error output ([#2654](#2654)) ([5bef954](5bef954)) * **skills:** Fix integer parameter parsing through agent skills ([#2847](#2847)) ([4564efe](4564efe)) ### Documentation * Release upgraded docsite ([#2831](#2831)) ([5b25ce0](5b25ce0)) --- 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.31.0](v0.30.0...v0.31.0) (2026-03-26) ### ⚠ BREAKING CHANGES * release upgraded docsite ([#2831](#2831)) * **http:** sanitize non-2xx error output ([#2654](#2654)) * add a new `enable-api` flag ([#2846](#2846)) * remove deprecations and update tools-file flag ([#2806](#2806)) ### Features * Add a new `enable-api` flag ([#2846](#2846)) ([7a070da](7a070da)) * **auth:** Add generic `authService` type for MCP ([#2619](#2619)) ([f6678f8](f6678f8)) * **auth:** Add Protected Resource Metadata endpoint ([#2698](#2698)) ([b53dcf2](b53dcf2)) * **auth:** Support manual PRM override ([#2717](#2717)) ([283e4e3](283e4e3)) * **dataplex:** Add support for lookup context tool. ([#2744](#2744)) ([facb69d](facb69d)) * Remove deprecations and update tools-file flag ([#2806](#2806)) ([ab64c95](ab64c95)) ### Bug Fixes * **ci:** Remove search index generation from preview deployment workflow ([#2859](#2859)) ([f8891b8](f8891b8)) * **docs:** Skip empty folders in pagination & reduce PR comment noise ([#2853](#2853)) ([9ebd93a](9ebd93a)) * **http:** Sanitize non-2xx error output ([#2654](#2654)) ([5bef954](5bef954)) * **skills:** Fix integer parameter parsing through agent skills ([#2847](#2847)) ([4564efe](4564efe)) ### Documentation * Release upgraded docsite ([#2831](#2831)) ([5b25ce0](5b25ce0)) --- 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> c6b811c

🤖 I have created a release *beep* *boop* --- ## [0.31.0](googleapis/mcp-toolbox@v0.30.0...v0.31.0) (2026-03-26) ### ⚠ BREAKING CHANGES * release upgraded docsite ([googleapis#2831](googleapis#2831)) * **http:** sanitize non-2xx error output ([googleapis#2654](googleapis#2654)) * add a new `enable-api` flag ([googleapis#2846](googleapis#2846)) * remove deprecations and update tools-file flag ([googleapis#2806](googleapis#2806)) ### Features * Add a new `enable-api` flag ([googleapis#2846](googleapis#2846)) ([7a070da](googleapis@7a070da)) * **auth:** Add generic `authService` type for MCP ([googleapis#2619](googleapis#2619)) ([f6678f8](googleapis@f6678f8)) * **auth:** Add Protected Resource Metadata endpoint ([googleapis#2698](googleapis#2698)) ([b53dcf2](googleapis@b53dcf2)) * **auth:** Support manual PRM override ([googleapis#2717](googleapis#2717)) ([283e4e3](googleapis@283e4e3)) * **dataplex:** Add support for lookup context tool. ([googleapis#2744](googleapis#2744)) ([facb69d](googleapis@facb69d)) * Remove deprecations and update tools-file flag ([googleapis#2806](googleapis#2806)) ([ab64c95](googleapis@ab64c95)) ### Bug Fixes * **ci:** Remove search index generation from preview deployment workflow ([googleapis#2859](googleapis#2859)) ([f8891b8](googleapis@f8891b8)) * **docs:** Skip empty folders in pagination & reduce PR comment noise ([googleapis#2853](googleapis#2853)) ([9ebd93a](googleapis@9ebd93a)) * **http:** Sanitize non-2xx error output ([googleapis#2654](googleapis#2654)) ([5bef954](googleapis@5bef954)) * **skills:** Fix integer parameter parsing through agent skills ([googleapis#2847](googleapis#2847)) ([4564efe](googleapis@4564efe)) ### Documentation * Release upgraded docsite ([googleapis#2831](googleapis#2831)) ([5b25ce0](googleapis@5b25ce0)) --- 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> c6b811c

Yuan325 requested review from a team as code owners March 20, 2026 22:53

blunderbuss-gcf Bot assigned duwenxin99 Mar 20, 2026

gemini-code-assist Bot reviewed Mar 20, 2026

View reviewed changes

Yuan325 force-pushed the remove-deprecation branch from 5614015 to 2256ee6 Compare March 20, 2026 23:13

Yuan325 force-pushed the remove-deprecation branch from 2256ee6 to 00c4f0f Compare March 20, 2026 23:26

Yuan325 force-pushed the remove-deprecation branch 3 times, most recently from 5bbcf4c to 130d744 Compare March 20, 2026 23:40

Yuan325 added 4 commits March 23, 2026 14:51

chore(sources/cloudsqlmssql)!: remove support for ipAddress (#2736)

19cfade

The ipAddress field had not been used for awhile. It was previously kept for backwards compatibility. We will be removing it from the config.

chore!: remove support for authSources (#2735)

7b7cbcc

Kept `AuthServices []string `json:"authSources"`` in `ParameterManifest` since those will be removed when we remove support for native endpoint. Or else it will break the sdk implementation.

chore: rename tools-file flags to config (#2738)

37d297d

* Remove deprecated support for `tools_file` flag. * Deprecate `tools-file`, `tools-files`, and `tools-folder` flag. Renaming them to `config`, `configs`, and `config-folder` flag.

Yuan325 force-pushed the remove-deprecation branch from 130d744 to 2478283 Compare March 23, 2026 21:51

averikitsch approved these changes Mar 23, 2026

View reviewed changes

drstrangelooker approved these changes Mar 23, 2026

View reviewed changes

resolve merge

ad0baf3

Yuan325 force-pushed the remove-deprecation branch from 2478283 to ad0baf3 Compare March 23, 2026 23:27

Merge branch 'main' into remove-deprecation

5c78579

Yuan325 merged commit ab64c95 into main Mar 24, 2026
24 of 25 checks passed

Yuan325 deleted the remove-deprecation branch March 24, 2026 00:01

release-please Bot mentioned this pull request Mar 24, 2026

chore(main): release 0.31.0 #2814

Merged

BrewTestBot mentioned this pull request Mar 27, 2026

mcp-toolbox 0.31.0 Homebrew/homebrew-core#274467

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat!: removing deprecations and update tools-file flag#2806

feat!: removing deprecations and update tools-file flag#2806
Yuan325 merged 6 commits into
mainfrom
remove-deprecation

Yuan325 commented Mar 20, 2026

Uh oh!

gemini-code-assist Bot commented Mar 20, 2026

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

github-actions Bot commented Mar 20, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Mar 20, 2026

Uh oh!

github-actions Bot commented Mar 20, 2026

Uh oh!

github-actions Bot commented Mar 20, 2026

Uh oh!

github-actions Bot commented Mar 23, 2026

Uh oh!

github-actions Bot commented Mar 23, 2026

Uh oh!

Uh oh!

github-actions Bot commented Mar 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Yuan325 commented Mar 20, 2026

Uh oh!

gemini-code-assist Bot commented Mar 20, 2026

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!

github-actions Bot commented Mar 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Link Resolution Note

Summary

Errors per input

Errors in DEVELOPER.md

Errors in docs/en/concepts/telemetry/index.md

Errors in docs/en/resources/sources/alloydb-admin.md

Errors in docs/en/resources/sources/bigtable.md

Errors in docs/en/resources/sources/cloud-healthcare.md

Errors in docs/en/resources/sources/cloud-logging-admin.md

Errors in docs/en/resources/sources/cloud-sql-mssql.md

Errors in docs/en/resources/sources/cloud-sql-pg.md

Errors in docs/en/resources/sources/dataproc.md

Errors in docs/en/resources/sources/redis.md

Errors in docs/en/resources/sources/serverless-spark.md

Errors in docs/en/resources/sources/valkey.md

Errors in docs/en/resources/tools/_index.md

Errors in docs/en/resources/tools/alloydb/alloydb-create-cluster.md

Errors in docs/en/resources/tools/alloydb/alloydb-create-instance.md

Errors in docs/en/resources/tools/alloydb/alloydb-create-user.md

Errors in docs/en/resources/tools/bigquery/bigquery-analyze-contribution.md

Errors in docs/en/resources/tools/bigtable/bigtable-sql.md

Errors in docs/en/resources/tools/cloudsql/cloudsqlcloneinstance.md

Errors in docs/en/resources/tools/cloudsql/cloudsqlrestorebackup.md

Errors in docs/en/resources/tools/firestore/firestore-add-documents.md

Errors in docs/en/resources/tools/firestore/firestore-update-document.md

Errors in docs/TOOLBOX_README.md

Errors in README.md

Uh oh!

github-actions Bot commented Mar 20, 2026

Uh oh!

github-actions Bot commented Mar 20, 2026

Uh oh!

github-actions Bot commented Mar 20, 2026

Uh oh!

github-actions Bot commented Mar 23, 2026

Uh oh!

github-actions Bot commented Mar 23, 2026

Uh oh!

Uh oh!

github-actions Bot commented Mar 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

github-actions Bot commented Mar 20, 2026 •

edited

Loading