feat: support for annotations by drstrangelooker · Pull Request #2007 · googleapis/mcp-toolbox

drstrangelooker · 2025-11-20T19:11:39Z

Description

The MCP spec supports tool annotations like the below structure in the 2025-06-18 version of the spec.
https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations

{
  destructiveHint?: boolean;
  idempotentHint?: boolean;
  openWorldHint?: boolean;
  readOnlyHint?: boolean;
}

Added a ToolAnnotations structure, an Annotations member to the McpManifest structure, and a nil initializer for the Annotations member to all calls to GetMcpManifest.

The ToolAnnotations structure and the member annotations are all defined as pointers so that they are omited when not set. There are times when the zero value is meaningful so this was the only way to make sure that we distinguish between not setting the annotation and setting it with a zero value.

PR Checklist

Thank you for opening a Pull Request! Before submitting your PR, there are a
few things you can do to make sure it goes smoothly:

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 #927

gemini-code-assist · 2025-11-20T19:14:26Z

Summary of Changes

Hello @drstrangelooker, 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 enhances the Model Context Protocol (MCP) implementation by adding support for tool annotations. This feature allows tools to declare specific operational characteristics, such as whether they are read-only or destructive, directly within their manifest. The changes involve introducing a new ToolAnnotations data structure, integrating it into the McpManifest, and updating all tool initializations to accommodate this new field. Special attention was given to maintaining backward compatibility for older MCP versions and explicitly defining ReadOnlyHint for relevant Looker tools to accurately reflect their behavior.

Highlights

New ToolAnnotations Structure: Introduced a ToolAnnotations struct in internal/tools/tools.go to support tool-specific metadata like destructiveHint, idempotentHint, openWorldHint, and readOnlyHint, aligning with the MCP spec.
McpManifest and GetMcpManifest Update: The McpManifest struct now includes an Annotations field, and the GetMcpManifest function has been updated to accept and assign these annotations.
Backward Compatibility for Older MCP Versions: Explicitly set Annotations to nil in older MCP server versions (v20241105 and v20250326) to prevent them from exposing the new annotation fields.
Looker Tool-Specific Annotations: Several Looker tools have been updated to explicitly define ReadOnlyHint within their ToolAnnotations, indicating whether they perform read-only operations.
Widespread GetMcpManifest Call Updates: All other tool initializations were updated to pass nil for the new annotations parameter, ensuring default behavior where annotations are not explicitly set.

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 adds support for tool annotations as defined in the MCP specification, which is a valuable feature. The implementation correctly introduces a ToolAnnotations struct and updates the GetMcpManifest function. However, I've found a few critical issues: the ToolAnnotations struct is missing json tags, which will lead to incorrect serialization, and the logic for excluding annotations in older API versions is incorrect because it modifies copies of slice elements. I've also suggested adding test coverage for the new annotations feature. Addressing these points will ensure the feature is robust and compliant with the spec.

drstrangelooker · 2025-11-20T19:41:13Z

/gemini review

gemini-code-assist

Code Review

This pull request successfully adds support for MCP tool annotations, introducing the ToolAnnotations struct and integrating it into the McpManifest. The widespread updates to GetMcpManifest calls are consistent and correct. I've provided a couple of suggestions for the internal/server/mcp/*/method.go files to enhance safety by avoiding in-place modification of manifest slices, which will make the code more robust. The addition of specific annotations to the Looker tools is a valuable improvement.

averikitsch

What do we think about expose this in the custom tools.yaml?

drstrangelooker · 2025-11-25T15:28:55Z

What do we think about expose this in the custom tools.yaml?

I think that is a great idea.

drstrangelooker · 2025-11-25T18:01:36Z

What do we think about expose this in the custom tools.yaml?

If I understand how yaml serialization is done it should be pretty trivial.

drstrangelooker · 2025-11-25T19:20:50Z

What do we think about expose this in the custom tools.yaml?

@averikitsch I moved it into the tools config. Take a look at the prebuilt looker.yaml for examples.

The MCP spec supports tool annotations like the below structure in the 2025-06-18 version of the spec. https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations ``` { destructiveHint?: boolean; idempotentHint?: boolean; openWorldHint?: boolean; readOnlyHint?: boolean; } ``` Added a ToolAnnotations structure, an Annotations member to the McpManifest structure, and a nil initializer for the Annotations member to all calls to GetMcpManifest. The ToolAnnotations structure and the member annotations are all defined as pointers so that they are omited when not set. There are times when the zero value is meaningful so this was the only way to make sure that we distinguish between not setting the annotation and setting it with a zero value.

…or old versions.

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description The MCP spec supports tool annotations like the below structure in the 2025-06-18 version of the spec. https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations ``` { destructiveHint?: boolean; idempotentHint?: boolean; openWorldHint?: boolean; readOnlyHint?: boolean; } ``` Added a ToolAnnotations structure, an Annotations member to the McpManifest structure, and a nil initializer for the Annotations member to all calls to GetMcpManifest. The ToolAnnotations structure and the member annotations are all defined as pointers so that they are omited when not set. There are times when the zero value is meaningful so this was the only way to make sure that we distinguish between not setting the annotation and setting it with a zero value. ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [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) - [x] Make sure to add `!` if this involve a breaking change 🛠️ Fixes googleapis#927 --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> ac21335

🤖 I have created a release *beep* *boop* --- ## [0.22.0](v0.21.0...v0.22.0) (2025-12-04) ### Features * Add allowed-origins flag ([#1984](#1984)) ([862868f](862868f)) * **tools/postgres:** Add list-query-stats and get-column-cardinality functions ([#1976](#1976)) ([9f76026](9f76026)) * **tools/spanner:** Add spanner list graphs to prebuiltconfigs ([#2056](#2056)) ([0e7fbf4](0e7fbf4)) * **prebuilt/cloud-sql:** Add clone instance tool for cloud sql ([#1845](#1845)) ([5e43630](5e43630)) * **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](1bf0b51)) * **serverless-spark:** Add create_spark_batch tool ([17a9792](17a9792)) * Support alternate accessToken header name ([#1968](#1968)) ([18017d6](18017d6)) * Support for annotations ([#2007](#2007)) ([ac21335](ac21335)) * **tool/mssql:** Set default host and port for MSSQL source ([#1943](#1943)) ([7a9cc63](7a9cc63)) * **tools/cloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([#1722](#1722)) ([8752e05](8752e05)) * **tools/postgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([#1919](#1919)) ([f4b1f0a](f4b1f0a)) * **tools/postgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([#1934](#1934)) ([5ad7c61](5ad7c61)) * **tools/spanner-list-graph:** Tool impl + docs + tests ([#1923](#1923)) ([a0f44d3](a0f44d3)) ### Bug Fixes * Add import for firebirdsql ([#2045](#2045)) ([fb7aae9](fb7aae9)) * Correct FAQ to mention HTTP tools ([#2036](#2036)) ([7b44237](7b44237)) * Format BigQuery numeric output as decimal strings ([#2084](#2084)) ([155bff8](155bff8)) * Set default annotations for tools in code if annotation not provided in yaml ([#2049](#2049)) ([565460c](565460c)) * **tools/alloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([#2046](#2046)) ([a03984c](a03984c)) * **tools/alloydbcreateuser:** Remove duplication of project praram ([#2028](#2028)) ([730ac6d](730ac6d)) * **tools/mongodb:** Remove `required` tag from the `canonical` field ([#2099](#2099)) ([744214e](744214e)) --- 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: Wenxin Du <117315983+duwenxin99@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.22.0](v0.21.0...v0.22.0) (2025-12-04) ### Features * Add allowed-origins flag ([#1984](#1984)) ([862868f](862868f)) * **tools/postgres:** Add list-query-stats and get-column-cardinality functions ([#1976](#1976)) ([9f76026](9f76026)) * **tools/spanner:** Add spanner list graphs to prebuiltconfigs ([#2056](#2056)) ([0e7fbf4](0e7fbf4)) * **prebuilt/cloud-sql:** Add clone instance tool for cloud sql ([#1845](#1845)) ([5e43630](5e43630)) * **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](1bf0b51)) * **serverless-spark:** Add create_spark_batch tool ([17a9792](17a9792)) * Support alternate accessToken header name ([#1968](#1968)) ([18017d6](18017d6)) * Support for annotations ([#2007](#2007)) ([ac21335](ac21335)) * **tool/mssql:** Set default host and port for MSSQL source ([#1943](#1943)) ([7a9cc63](7a9cc63)) * **tools/cloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([#1722](#1722)) ([8752e05](8752e05)) * **tools/postgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([#1919](#1919)) ([f4b1f0a](f4b1f0a)) * **tools/postgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([#1934](#1934)) ([5ad7c61](5ad7c61)) * **tools/spanner-list-graph:** Tool impl + docs + tests ([#1923](#1923)) ([a0f44d3](a0f44d3)) ### Bug Fixes * Add import for firebirdsql ([#2045](#2045)) ([fb7aae9](fb7aae9)) * Correct FAQ to mention HTTP tools ([#2036](#2036)) ([7b44237](7b44237)) * Format BigQuery numeric output as decimal strings ([#2084](#2084)) ([155bff8](155bff8)) * Set default annotations for tools in code if annotation not provided in yaml ([#2049](#2049)) ([565460c](565460c)) * **tools/alloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([#2046](#2046)) ([a03984c](a03984c)) * **tools/alloydbcreateuser:** Remove duplication of project praram ([#2028](#2028)) ([730ac6d](730ac6d)) * **tools/mongodb:** Remove `required` tag from the `canonical` field ([#2099](#2099)) ([744214e](744214e)) --- 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: Wenxin Du <117315983+duwenxin99@users.noreply.github.com> cb4529c

🤖 I have created a release *beep* *boop* --- ## [0.22.0](googleapis/mcp-toolbox@v0.21.0...v0.22.0) (2025-12-04) ### Features * Add allowed-origins flag ([googleapis#1984](googleapis#1984)) ([862868f](googleapis@862868f)) * **tools/postgres:** Add list-query-stats and get-column-cardinality functions ([googleapis#1976](googleapis#1976)) ([9f76026](googleapis@9f76026)) * **tools/spanner:** Add spanner list graphs to prebuiltconfigs ([googleapis#2056](googleapis#2056)) ([0e7fbf4](googleapis@0e7fbf4)) * **prebuilt/cloud-sql:** Add clone instance tool for cloud sql ([googleapis#1845](googleapis#1845)) ([5e43630](googleapis@5e43630)) * **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](googleapis@1bf0b51)) * **serverless-spark:** Add create_spark_batch tool ([17a9792](googleapis@17a9792)) * Support alternate accessToken header name ([googleapis#1968](googleapis#1968)) ([18017d6](googleapis@18017d6)) * Support for annotations ([googleapis#2007](googleapis#2007)) ([ac21335](googleapis@ac21335)) * **tool/mssql:** Set default host and port for MSSQL source ([googleapis#1943](googleapis#1943)) ([7a9cc63](googleapis@7a9cc63)) * **tools/cloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([googleapis#1722](googleapis#1722)) ([8752e05](googleapis@8752e05)) * **tools/postgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([googleapis#1919](googleapis#1919)) ([f4b1f0a](googleapis@f4b1f0a)) * **tools/postgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([googleapis#1934](googleapis#1934)) ([5ad7c61](googleapis@5ad7c61)) * **tools/spanner-list-graph:** Tool impl + docs + tests ([googleapis#1923](googleapis#1923)) ([a0f44d3](googleapis@a0f44d3)) ### Bug Fixes * Add import for firebirdsql ([googleapis#2045](googleapis#2045)) ([fb7aae9](googleapis@fb7aae9)) * Correct FAQ to mention HTTP tools ([googleapis#2036](googleapis#2036)) ([7b44237](googleapis@7b44237)) * Format BigQuery numeric output as decimal strings ([googleapis#2084](googleapis#2084)) ([155bff8](googleapis@155bff8)) * Set default annotations for tools in code if annotation not provided in yaml ([googleapis#2049](googleapis#2049)) ([565460c](googleapis@565460c)) * **tools/alloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([googleapis#2046](googleapis#2046)) ([a03984c](googleapis@a03984c)) * **tools/alloydbcreateuser:** Remove duplication of project praram ([googleapis#2028](googleapis#2028)) ([730ac6d](googleapis@730ac6d)) * **tools/mongodb:** Remove `required` tag from the `canonical` field ([googleapis#2099](googleapis#2099)) ([744214e](googleapis@744214e)) --- 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: Wenxin Du <117315983+duwenxin99@users.noreply.github.com> cb4529c

🤖 I have created a release *beep* *boop* --- ## [0.22.0](v0.21.0...v0.22.0) (2025-12-04) ### Features * Add allowed-origins flag ([#1984](#1984)) ([862868f](862868f)) * **tools/postgres:** Add list-query-stats and get-column-cardinality functions ([#1976](#1976)) ([9f76026](9f76026)) * **tools/spanner:** Add spanner list graphs to prebuiltconfigs ([#2056](#2056)) ([0e7fbf4](0e7fbf4)) * **prebuilt/cloud-sql:** Add clone instance tool for cloud sql ([#1845](#1845)) ([5e43630](5e43630)) * **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](1bf0b51)) * **serverless-spark:** Add create_spark_batch tool ([17a9792](17a9792)) * Support alternate accessToken header name ([#1968](#1968)) ([18017d6](18017d6)) * Support for annotations ([#2007](#2007)) ([ac21335](ac21335)) * **tool/mssql:** Set default host and port for MSSQL source ([#1943](#1943)) ([7a9cc63](7a9cc63)) * **tools/cloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([#1722](#1722)) ([8752e05](8752e05)) * **tools/postgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([#1919](#1919)) ([f4b1f0a](f4b1f0a)) * **tools/postgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([#1934](#1934)) ([5ad7c61](5ad7c61)) * **tools/spanner-list-graph:** Tool impl + docs + tests ([#1923](#1923)) ([a0f44d3](a0f44d3)) ### Bug Fixes * Add import for firebirdsql ([#2045](#2045)) ([fb7aae9](fb7aae9)) * Correct FAQ to mention HTTP tools ([#2036](#2036)) ([7b44237](7b44237)) * Format BigQuery numeric output as decimal strings ([#2084](#2084)) ([155bff8](155bff8)) * Set default annotations for tools in code if annotation not provided in yaml ([#2049](#2049)) ([565460c](565460c)) * **tools/alloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([#2046](#2046)) ([a03984c](a03984c)) * **tools/alloydbcreateuser:** Remove duplication of project praram ([#2028](#2028)) ([730ac6d](730ac6d)) * **tools/mongodb:** Remove `required` tag from the `canonical` field ([#2099](#2099)) ([744214e](744214e)) --- 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: Wenxin Du <117315983+duwenxin99@users.noreply.github.com>

## Description The MCP spec supports tool annotations like the below structure in the 2025-06-18 version of the spec. https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations ``` { destructiveHint?: boolean; idempotentHint?: boolean; openWorldHint?: boolean; readOnlyHint?: boolean; } ``` Added a ToolAnnotations structure, an Annotations member to the McpManifest structure, and a nil initializer for the Annotations member to all calls to GetMcpManifest. The ToolAnnotations structure and the member annotations are all defined as pointers so that they are omited when not set. There are times when the zero value is meaningful so this was the only way to make sure that we distinguish between not setting the annotation and setting it with a zero value. ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [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) - [x] Make sure to add `!` if this involve a breaking change 🛠️ Fixes googleapis#927 --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.22.0](googleapis/mcp-toolbox@v0.21.0...v0.22.0) (2025-12-04) ### Features * Add allowed-origins flag ([googleapis#1984](googleapis#1984)) ([862868f](googleapis@862868f)) * **tools/postgres:** Add list-query-stats and get-column-cardinality functions ([googleapis#1976](googleapis#1976)) ([9f76026](googleapis@9f76026)) * **tools/spanner:** Add spanner list graphs to prebuiltconfigs ([googleapis#2056](googleapis#2056)) ([0e7fbf4](googleapis@0e7fbf4)) * **prebuilt/cloud-sql:** Add clone instance tool for cloud sql ([googleapis#1845](googleapis#1845)) ([5e43630](googleapis@5e43630)) * **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](googleapis@1bf0b51)) * **serverless-spark:** Add create_spark_batch tool ([17a9792](googleapis@17a9792)) * Support alternate accessToken header name ([googleapis#1968](googleapis#1968)) ([18017d6](googleapis@18017d6)) * Support for annotations ([googleapis#2007](googleapis#2007)) ([ac21335](googleapis@ac21335)) * **tool/mssql:** Set default host and port for MSSQL source ([googleapis#1943](googleapis#1943)) ([7a9cc63](googleapis@7a9cc63)) * **tools/cloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([googleapis#1722](googleapis#1722)) ([8752e05](googleapis@8752e05)) * **tools/postgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([googleapis#1919](googleapis#1919)) ([f4b1f0a](googleapis@f4b1f0a)) * **tools/postgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([googleapis#1934](googleapis#1934)) ([5ad7c61](googleapis@5ad7c61)) * **tools/spanner-list-graph:** Tool impl + docs + tests ([googleapis#1923](googleapis#1923)) ([a0f44d3](googleapis@a0f44d3)) ### Bug Fixes * Add import for firebirdsql ([googleapis#2045](googleapis#2045)) ([fb7aae9](googleapis@fb7aae9)) * Correct FAQ to mention HTTP tools ([googleapis#2036](googleapis#2036)) ([7b44237](googleapis@7b44237)) * Format BigQuery numeric output as decimal strings ([googleapis#2084](googleapis#2084)) ([155bff8](googleapis@155bff8)) * Set default annotations for tools in code if annotation not provided in yaml ([googleapis#2049](googleapis#2049)) ([565460c](googleapis@565460c)) * **tools/alloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([googleapis#2046](googleapis#2046)) ([a03984c](googleapis@a03984c)) * **tools/alloydbcreateuser:** Remove duplication of project praram ([googleapis#2028](googleapis#2028)) ([730ac6d](googleapis@730ac6d)) * **tools/mongodb:** Remove `required` tag from the `canonical` field ([googleapis#2099](googleapis#2099)) ([744214e](googleapis@744214e)) --- 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: Wenxin Du <117315983+duwenxin99@users.noreply.github.com>

🤖 I have created a release *beep* *boop* --- ## [0.22.0](googleapis/mcp-toolbox@v0.21.0...v0.22.0) (2025-12-04) ### Features * Add allowed-origins flag ([#1984](googleapis/mcp-toolbox#1984)) ([862868f](googleapis/mcp-toolbox@862868f)) * **tools/postgres:** Add list-query-stats and get-column-cardinality functions ([#1976](googleapis/mcp-toolbox#1976)) ([9f76026](googleapis/mcp-toolbox@9f76026)) * **tools/spanner:** Add spanner list graphs to prebuiltconfigs ([#2056](googleapis/mcp-toolbox#2056)) ([0e7fbf4](googleapis/mcp-toolbox@0e7fbf4)) * **prebuilt/cloud-sql:** Add clone instance tool for cloud sql ([#1845](googleapis/mcp-toolbox#1845)) ([5e43630](googleapis/mcp-toolbox@5e43630)) * **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](googleapis/mcp-toolbox@1bf0b51)) * **serverless-spark:** Add create_spark_batch tool ([17a9792](googleapis/mcp-toolbox@17a9792)) * Support alternate accessToken header name ([#1968](googleapis/mcp-toolbox#1968)) ([18017d6](googleapis/mcp-toolbox@18017d6)) * Support for annotations ([#2007](googleapis/mcp-toolbox#2007)) ([ac21335](googleapis/mcp-toolbox@ac21335)) * **tool/mssql:** Set default host and port for MSSQL source ([#1943](googleapis/mcp-toolbox#1943)) ([7a9cc63](googleapis/mcp-toolbox@7a9cc63)) * **tools/cloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([#1722](googleapis/mcp-toolbox#1722)) ([8752e05](googleapis/mcp-toolbox@8752e05)) * **tools/postgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([#1919](googleapis/mcp-toolbox#1919)) ([f4b1f0a](googleapis/mcp-toolbox@f4b1f0a)) * **tools/postgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([#1934](googleapis/mcp-toolbox#1934)) ([5ad7c61](googleapis/mcp-toolbox@5ad7c61)) * **tools/spanner-list-graph:** Tool impl + docs + tests ([#1923](googleapis/mcp-toolbox#1923)) ([a0f44d3](googleapis/mcp-toolbox@a0f44d3)) ### Bug Fixes * Add import for firebirdsql ([#2045](googleapis/mcp-toolbox#2045)) ([fb7aae9](googleapis/mcp-toolbox@fb7aae9)) * Correct FAQ to mention HTTP tools ([#2036](googleapis/mcp-toolbox#2036)) ([7b44237](googleapis/mcp-toolbox@7b44237)) * Format BigQuery numeric output as decimal strings ([#2084](googleapis/mcp-toolbox#2084)) ([155bff8](googleapis/mcp-toolbox@155bff8)) * Set default annotations for tools in code if annotation not provided in yaml ([#2049](googleapis/mcp-toolbox#2049)) ([565460c](googleapis/mcp-toolbox@565460c)) * **tools/alloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([#2046](googleapis/mcp-toolbox#2046)) ([a03984c](googleapis/mcp-toolbox@a03984c)) * **tools/alloydbcreateuser:** Remove duplication of project praram ([#2028](googleapis/mcp-toolbox#2028)) ([730ac6d](googleapis/mcp-toolbox@730ac6d)) * **tools/mongodb:** Remove `required` tag from the `canonical` field ([#2099](googleapis/mcp-toolbox#2099)) ([744214e](googleapis/mcp-toolbox@744214e)) --- 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: Wenxin Du <117315983+duwenxin99@users.noreply.github.com>

drstrangelooker requested a review from a team November 20, 2025 19:11

blunderbuss-gcf Bot assigned duwenxin99 Nov 20, 2025

drstrangelooker force-pushed the looker-tool-annotations branch from 29df8e5 to 9fcd0c8 Compare November 20, 2025 19:23

gemini-code-assist Bot reviewed Nov 20, 2025

View reviewed changes

Comment thread internal/server/mcp/v20241105/method.go Outdated

Comment thread internal/server/mcp/v20250326/method.go Outdated

Comment thread internal/tools/tools.go

drstrangelooker force-pushed the looker-tool-annotations branch 2 times, most recently from 10a3797 to 980d771 Compare November 20, 2025 19:39

gemini-code-assist Bot reviewed Nov 20, 2025

View reviewed changes

Comment thread internal/server/mcp/v20241105/method.go Outdated

Comment thread internal/server/mcp/v20250326/method.go Outdated

drstrangelooker force-pushed the looker-tool-annotations branch 2 times, most recently from bb350cf to 195089c Compare November 24, 2025 15:47

duwenxin99 approved these changes Nov 24, 2025

View reviewed changes

Comment thread internal/tools/tools_test.go Outdated

averikitsch added the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Nov 24, 2025

drstrangelooker force-pushed the looker-tool-annotations branch 2 times, most recently from 8703b2c to 0ac456f Compare November 24, 2025 17:52

averikitsch reviewed Nov 25, 2025

View reviewed changes

Comment thread internal/tools/tools.go

averikitsch reviewed Nov 25, 2025

View reviewed changes

drstrangelooker force-pushed the looker-tool-annotations branch 2 times, most recently from c448a81 to 5be1e7d Compare November 25, 2025 16:30

drstrangelooker force-pushed the looker-tool-annotations branch 4 times, most recently from 645a2d9 to d6a4400 Compare November 25, 2025 23:05

averikitsch removed the do not merge Indicates a pull request not ready for merge, due to either quality or timing. label Nov 26, 2025

drstrangelooker and others added 3 commits November 26, 2025 08:36

chore: add destructive to LookML tools, fix negation of annotations f…

9f95293

…or old versions.

chore: Apply suggestions from Gemini code review

a46de61

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

drstrangelooker added 5 commits November 26, 2025 08:36

chore: fix lint issue

edacae1

chore: tests for ToolAnnotations

7e53b19

chore: merge changes for cloudsqlupgradeprecheck

b40d687

chore: fix spannerlistgraphs with annotations pointer

59b1499

chore: Move annotations config into tools yaml file

b80efcd

drstrangelooker force-pushed the looker-tool-annotations branch from d6a4400 to b80efcd Compare November 26, 2025 13:37

drstrangelooker enabled auto-merge (squash) November 26, 2025 13:37

drstrangelooker merged commit ac21335 into main Nov 26, 2025
11 checks passed

drstrangelooker deleted the looker-tool-annotations branch November 26, 2025 13:53

release-please Bot mentioned this pull request Nov 26, 2025

chore(main): release 0.22.0 #1997

Merged

BrewTestBot mentioned this pull request Dec 5, 2025

mcp-toolbox 0.22.0 Homebrew/homebrew-core#257162

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: support for annotations#2007

feat: support for annotations#2007
drstrangelooker merged 8 commits into
mainfrom
looker-tool-annotations

drstrangelooker commented Nov 20, 2025

Uh oh!

gemini-code-assist Bot commented Nov 20, 2025

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

drstrangelooker commented Nov 20, 2025

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

averikitsch left a comment

Uh oh!

drstrangelooker commented Nov 25, 2025

Uh oh!

drstrangelooker commented Nov 25, 2025

Uh oh!

drstrangelooker commented Nov 25, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

drstrangelooker commented Nov 20, 2025

Description

PR Checklist

Uh oh!

gemini-code-assist Bot commented Nov 20, 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!

drstrangelooker commented Nov 20, 2025

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!

averikitsch left a comment

Choose a reason for hiding this comment

Uh oh!

drstrangelooker commented Nov 25, 2025

Uh oh!

drstrangelooker commented Nov 25, 2025

Uh oh!

drstrangelooker commented Nov 25, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants