docs!: update docsite by dishaprakash · Pull Request #2831 · googleapis/mcp-toolbox

dishaprakash · 2026-03-24T19:52:16Z

Description

This PR creates the new v1 docsite.

Documentation Section

Clear use-case based folder structure and navigation

Integrations Section

New folder structure for each source and compatible tools
Integration specific samples are moved into their folders

Samples

New samples gallery to search for samples from all across the documentation site
Search and filter based on tags

Reference

FAQ and CLI details

Hugo

New secondary top navbar
Increased search capability

Merge conflicts

versioning.md has been added to path docs/en/reference/versioning.md
style-guide has been added to path docs/en/reference/style-guide.md

CloudFlare setup

workflows added to deploy to cloudflare for new release, dev and previous release
individual ephemeral PR preview using cloudflare pages

Individual PRs

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

## Description This PR adds the user-guide section of the docsite The structure is as follows * /introduction: Architectural overview and high-level details * Current introduction page * /getting-started * Index Page: * Usage methodologies for the toolbox, including links to various clients * Distinction between custom-developed and prebuilt configurations * Comparison of build-time versus runtime tool implementation * /configuration: * Index page: High level information on how to configure MCP Toolbox to your liking * **Definitions:** Tool, Source, Prompts, etc * **Env Vars**: PORT, DEBUG, GOOGLE\_APPLICATION\_CREDENTIALS. * /authentication: Split into Authorized invocation, Authentication parameters & Google sign in \+ Client SDK Usage * /prebuilt-configs: Guide on using prebuilt configs * /sources: Guide on configuring a source * /tools: Guide on configuring a tool \+ Client SDK Usage \+ Invoking from CLI \+ Client SDK Usage * /toolsets: Guide on configuring a toolset \+ Client SDK Usage \+ Client SDK Usage \+ Generating skills from toolsets * /prompts: Guide on configuring prompts \+ Link to guide on using it with Gemini CLI * /embedding-models: Guide on configuring models \+ Gemini Embeddings * /toolbox-ui: Debugging with the MCP Toolbox UI * /connect-to: * Index page: Connection Toolbox to multiple environments * /client-sdks: * `/py`: Python SDK Readme * `/toolbox-core`: Core SDK Readme * `/toolbox-langchain`: Toolbox Langchain SDK Readme * `/toolbox-llamaindex`: Toolbox LlamaIndex SDK Readme * `/toolbox-adk`: Toolbox ADK SDK Readme * `/js`: JS SDK Readme * `/toolbox-core`: Core SDK Readme * `/toolbox-adk`: Toolbox ADK SDK Readme * `/go`: Go SDK Readme * `/core`: Core SDK Readme * `/tbgenkit`: Tbgenkit SDK Readme * `/tbadk`: Tbadk SDK Readme * /mcp-client * /gemini-cli: Lists all extensions available * /ides: * /alloydb-pg * /alloydb-pg-admin * … * /deploy-to: * Index page: Various ways to deploy the server * /docker: Deploy to Docker * /kubernetes: Deploy to Kubernetes * /cloud-run: Deploy to Cloud Run * /monitoring: OpenTelemetry and how to export it ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description This PR adds the Integration section to the docsite * /integrations/bigquery (Example Structure): * **Overview**: What is this source? * **Prerequisites**: IAM permissions & API enablement. * **Server Config**: tools.yaml snippet * **Tool Reference**: bigquery-sql \-\> /integrations/bigquery/bigquery-analyze-contribution/ ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com>

## Description This PR Adds the Build with MCP Toolbox Section * /build-with-mcp-toolbox: * Move samples into this folder * This section will also contain all the SDK samples currently being added into the documentation * /python * /quickstart * /js * /quickstart * /go * /quickstart * /openai-go: Sample * /langchain-go: Sample * /genai-go: Sample * /adk-go: Sample * /mcp-inspector-quickstart * /prompts-with-gemini-cli * /deploy-adk-agent ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com>

## Description This PR adds the reference section to the docsite * /reference/cli: Full toolbox \--help output. * /reference/FAQ: It also: - updates the CI tests to point to the new directory for sample testing - updates the new paths in the release-please config - updates DEVELOPER.md - updated Gemini.md - adds a production security warning to all the `deploy-to` pages about the `allowed-hosts` and `allowed-origins` flags ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com>

## Description This PR adds workflows necessary for the cloudflare pages deployment Changes: - Compressed `edit-headers.gif` from 38MiB to 8MiB for smoother cloudflare deployment - `deploy_dev_docs_to_cf.yaml`: To build and push the hugo site to branch `cloudflare-pages` - `deploy_previous_version_docs_to_cf.yaml`: To build and push older versions to branch `cloudflare-pages` at `v<version>/` and `/` (root) - `deploy_versioned_docs_to_cf.yaml`: To build and push newly released version to branch `cloudflare-pages` at `v<version>/` and `/` (root) - `cloudflare_sync.yaml`: To one shot deploy the `cloudflare-pages` branch to `mcp-toolbox.dev` through the cloudflare wrangler GHA - `docs_preview_deploy_cf.yaml`: To build and deploy PR Preview (without pull_request_target) to cloudflare and attach a comment on the PR with the deployed link. Uses `marocchino/sticky-pull-request-comment@v2` action to mkae sure the preview comment is updated instead of creating a new comment on every deployment. - `docs_preview_clean_cf.yaml`: To clean PR Preview (without pull_request_target) from cloudflare and attach a comment on the PR The CF deployement for pr previews will fail until we add the tokens into repo secret. I will add those right before merging to main ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com>

) ## Description **1. Version Deep Re-routing** * Upgraded the version dropdown menu with deep-routing JavaScript. * When a user switches versions, the script now dynamically strips the base URL and preserves their current page path, seamlessly dropping them onto the exact same page in the selected version (or displays 404 error is the same page doesn't exist in the destination version). **2. Pagination** * **Pagination:** Implemented pagination across the docs to improve navigation and readability for longer lists/sections. **3. Banner** * **Migration Banner:** Added a global migration banner to Github Pages docsite with a redirection URL ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description This PR: - Optimizes llms.txt and llms-full.txt to help navigate an AI agent through our documentation - Adds version param to alter the above mentioned files ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description This PR adds page standardization rules for the source integrations. The proposed standard for source pages is: - No `#` H1 heading as title acts as the heading - `## About` (Required) - `## Available Tools` (Optional) - `## Requirements` (Optional) - `## Example` (Required) - `## Reference` (Required) - `## Advanced Usage` (Optional) - `## Troubleshooting` (Optional) - `## Additional Resources` (Optional) A `lint-docs.yaml` GHA Workflow is added to conduct the CI check, which runs the .ci/lint-docs-source-page.sh script which has the bash script for the above mentioned check This CI Check also checks for files above the size of 24MB ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description This PR adds page standardization rules for the tool pages. The proposed standard for tool pages is: Frontmatter title must end with "Tool" - No `#` H1 heading as title acts as the heading - `## About` (Required) - `## Compatible Sources` (Optional) - `## Requirements` (Optional) - `## Parameters` (Optional) - `## Example` (Required) - `## Output Format` (Optional) - `## Reference` (Optional) - `## Advanced Usage` (Optional) - `## Troubleshooting` (Optional) - `## Additional Resources` (Optional) This structure was chosen as the tools page vary widely between integrations If the `## Compatible Sources` heading is used, the {{< compatible-sources >}} shortcode must be placed directly beneath it. The existing lint-docs.yml GHA Workflow is updated to conduct this CI check alongside the source pages, which runs the .ci/lint-docs-tool-page.sh script which has the bash script for the above mentioned check ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

…ns (#2670) ## Description ### Key Changes - Added Google Analytics tracking ID. - Added on-page feedback buttons for documentation. - Adds estimated reading time for each page. - Implemented Pagefind to replace the existing documentation search. ### Context: Pagefind Search Implementation Unlike our previous in-memory search, Pagefind generates a highly compressed, pre-calculated search index at build time. To support this: - **CI/CD**: All deployment workflows (Cloudflare Pages, GitHub Pages, and PR Previews) have been updated to automatically run ```npx pagefind --site public``` immediately after the Hugo build step. - **Local Development**: hugo server running solely in memory will no longer render search results by default. Developers must generate the physical files and index them locally using ```hugo --environment development && npx pagefind ...``` before running the local server. - **Docs & Config**: `DEVELOPER.md` and `gemini.md` have been updated with the new local testing instructions, and `.hugo/static/pagefind/` has been added to .gitignore to prevent committing local binary indexes. ### Rationale: Why Pagefind? Why add a new build step and shift away from our default search? Ultimately, we are trading a bit of build-time complexity for a leap in user experience. - Search Engine Experience: Instead of basic title matching or keyword filtering, Pagefind provides relevant results, substring matching, and highlights the exact context of the match directly in the search dropdown. - Better Scaling: It only delivers the exact data chunks needed for a specific query, meaning our docs can grow and search will remain fast. - Cleans Up Deployment Branches: Our previous search solution resulted in numerous offline index files across our `versioned-gh-pages` branch, contributing to repository bloat over time. Pagefind consolidates its compressed chunks into a single pagefind/ directory, keeping our deployment branches clean and tidy. ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description This PR: - Splits PR Preview into build and deploy workflows to fix RCE Vulnerability. - Moves pre and post processing to `Build with MCP toolbox` - Adds headings to `_index.md` pages which lists the directories under it. - Adds discord link and medium logo - Reference the quickstarts from getting-started ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description Update the root folder name: - User-guide to documentation - Build-with-mcp-toolbox to Samples-hub *NOTE:* This PR only makes structural changes, the UI will not be accurate to the end product. Please see PR #2790 for complete UI changes ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

## Description Update integrations section structure to split source, tools and samples under each integration *NOTE:* This PR only makes structural changes, the UI will not be accurate to the end product. Please see PR #2790 for complete UI changes ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here>

## Description This PR: - Renames samples-hub to samples - Adds UI for a samples gallery to showcase all samples across the docsite - Adds new UI components - Secondary navigation tab - Better search UI - Displays selected version on the version selector - Non clashing themes and colors - Adds documentation into - Developer.md - Gemini.md - Updates information based on new changes to the llms.txt and llms-full.txt ## 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](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] 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 - [ ] 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

propogating change 129958e

propogating 6efb7ba

propogatin commit - 6efb7ba#diff-9decf7648a3794d66d6356aa2c9663f1fcebd53a12ce4ebe26fa44c7ce85629d

propogating 2d79660

propogating commit- https://github.com/googleapis/genai-toolbox/blob/c233eee98cd9621526cb286245f3874f5bd6e7da/docs/en/how-to/generate_skill.md?plain=1

propogating commit - c233eee#diff-e9de3746fb2826708456e70f9808b42e21e366b262b1cbba96c3cc8a26d5b13f

propogating commit - 63d448d#diff-63ffaadf7ee36d5ea87be004ad927604bf0e9ace7a5cf297252e9c609e52e2d8

propogating change

propogating commit- 63d448d

propogating commit - 63d448d

propogating commit - d3baf77

propogating change a136e16

commit - 73bf962

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - googleapis#2647 - googleapis#2648 - googleapis#2649 - googleapis#2650 - googleapis#2652 - googleapis#2664 - googleapis#2665 - googleapis#2666 - googleapis#2668 - googleapis#2670 - googleapis#2723 - googleapis#2779 - googleapis#2788 - googleapis#2790 ## 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - #2647 - #2648 - #2649 - #2650 - #2652 - #2664 - #2665 - #2666 - #2668 - #2670 - #2723 - #2779 - #2788 - #2790 ## 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - googleapis#2647 - googleapis#2648 - googleapis#2649 - googleapis#2650 - googleapis#2652 - googleapis#2664 - googleapis#2665 - googleapis#2666 - googleapis#2668 - googleapis#2670 - googleapis#2723 - googleapis#2779 - googleapis#2788 - googleapis#2790 ## 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

🤖 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

## Description This PR creates the new v1 docsite. ### Documentation Section - Clear use-case based folder structure and navigation ### Integrations Section - New folder structure for each source and compatible tools - Integration specific samples are moved into their folders ### Samples - New samples gallery to search for samples from all across the documentation site - Search and filter based on tags ### Reference - FAQ and CLI details ### Hugo - New secondary top navbar - Increased search capability ## Merge conflicts - versioning.md has been added to path `docs/en/reference/versioning.md` - style-guide has been added to path `docs/en/reference/style-guide.md` ## CloudFlare setup - workflows added to deploy to cloudflare for new release, dev and previous release - individual ephemeral PR preview using cloudflare pages ## Individual PRs - googleapis#2647 - googleapis#2648 - googleapis#2649 - googleapis#2650 - googleapis#2652 - googleapis#2664 - googleapis#2665 - googleapis#2666 - googleapis#2668 - googleapis#2670 - googleapis#2723 - googleapis#2779 - googleapis#2788 - googleapis#2790 ## 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 #<issue_number_goes_here> --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> Co-authored-by: Averi Kitsch <akitsch@google.com> 5b25ce0

🤖 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

dishaprakash and others added 30 commits March 6, 2026 21:55

Update package-lock.json

1aa68a8

propogating change 129958e

Update package-lock.json

f682bc6

propogating 6efb7ba

Update agent.test.js

6885483

propogatin commit - 6efb7ba#diff-9decf7648a3794d66d6356aa2c9663f1fcebd53a12ce4ebe26fa44c7ce85629d

Update package-lock.json

9cef936

Update package-lock.json

7e1f199

propogating 2d79660

Update generate_skill.md

2a1b591

propogating commit- https://github.com/googleapis/genai-toolbox/blob/c233eee98cd9621526cb286245f3874f5bd6e7da/docs/en/how-to/generate_skill.md?plain=1

Update cli.md

53cc4b2

propogating commit - c233eee#diff-e9de3746fb2826708456e70f9808b42e21e366b262b1cbba96c3cc8a26d5b13f

Update _index.md

4732e34

propogating commit - 63d448d#diff-63ffaadf7ee36d5ea87be004ad927604bf0e9ace7a5cf297252e9c609e52e2d8

Update index.md

dc67f2c

propogating change

Update index.md

9b3de83

propogating commit- 63d448d

Update _index.md

beb3141

propogating commit - 63d448d

Update source.md

2ee5e5d

propogating commit - d3baf77

Update source.md

0cea268

propogating commit - d3baf77

Update _index.md

ecdf58f

propogating change a136e16

Update package-lock.json

55b2f67

Update generate_skill.md

1ef93c7

commit - 73bf962

Yuan325 changed the title ~~docs!: v1 docsite~~ docs!: update docsite Mar 26, 2026

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

docs!: update docsite#2831

docs!: update docsite#2831
dishaprakash merged 86 commits intomainfrom
documentation-reorg

dishaprakash commented Mar 24, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

dishaprakash commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Documentation Section

Integrations Section

Samples

Reference

Hugo

Merge conflicts

CloudFlare setup

Individual PRs

PR Checklist

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

dishaprakash commented Mar 24, 2026 •

edited

Loading