Merge branch 'skoshatwar/issue-fix-580' of https://github.com/saurabhkoshatwar/mcp-toolbox-sdk-python into skoshatwar/issue-fix-580

Author: saurabhkoshatwar

.github/sync-repo-settings.yaml

@@ -67,12 +67,12 @@ jobs:
         with:
           python-version: "3.13"
 
+      - name: Install test requirements
+        run: pip install -e .[test]
+
       - name: Install library requirements
         run: pip install -r requirements.txt
 
-      - name: Install test requirements
-        run: pip install .[test]
-
       - name: Run linters
         run: |
           black --check .

.github/workflows/lint-toolbox-adk.yaml

@@ -67,12 +67,12 @@ jobs:
         with:
           python-version: "3.13"
 
+      - name: Install test requirements
+        run: pip install -e .[test]
+
       - name: Install library requirements
         run: pip install -r requirements.txt
 
-      - name: Install test requirements
-        run: pip install .[test]
-
       - name: Run linters
         run: |
           black --check .

.github/workflows/lint-toolbox-core.yaml

@@ -67,12 +67,12 @@ jobs:
         with:
           python-version: "3.13"
 
+      - name: Install test requirements
+        run: pip install -e .[test]
+
       - name: Install library requirements
         run: pip install -r requirements.txt
 
-      - name: Install test requirements
-        run: pip install .[test]
-
       - name: Run linters
         run: |
           black --check .

.github/workflows/lint-toolbox-langchain.yaml

@@ -67,12 +67,12 @@ jobs:
         with:
           python-version: "3.13"
 
+      - name: Install test requirements
+        run: pip install -e .[test]
+
       - name: Install library requirements
         run: pip install -r requirements.txt
 
-      - name: Install test requirements
-        run: pip install .[test]
-
       - name: Run linters
         run: |
           black --check .

.github/workflows/lint-toolbox-llamaindex.yaml

@@ -1,6 +1,6 @@
 {
-  "packages/toolbox-langchain": "0.6.0",
-  "packages/toolbox-core": "0.6.0",
+  "packages/toolbox-langchain": "1.0.0",
+  "packages/toolbox-core": "1.0.0",
   "packages/toolbox-llamaindex": "0.6.0",
-  "packages/toolbox-adk": "0.7.0"
+  "packages/toolbox-adk": "1.0.0"
 }

.release-please-manifest.json

@@ -14,83 +14,33 @@ applications. These SDKs allow you to load tools defined in Toolbox and use them
 as standard Python functions or objects within popular orchestration frameworks
 or your custom code.
 
-This simplifies the process of incorporating external functionalities (like
-Databases or APIs) managed by Toolbox into your GenAI applications.
+For comprehensive guides and advanced configuration, visit the [Main Documentation Site](https://googleapis.github.io/genai-toolbox/).
+
 
 <!-- TOC -->
-- [Overview](#overview)
-- [Which Package Should I Use?](#which-package-should-i-use)
 - [Available Packages](#available-packages)
-- [Getting Started](#getting-started)
+- [Quickstart](#quickstart)
 - [Contributing](#contributing)
 - [License](#license)
 - [Support](#support)
 
 <!-- /TOC -->
 
-## Overview
-
-The MCP Toolbox service provides a centralized way to manage and expose tools
-(like API connectors, database query tools, etc.) for use by GenAI applications.
-
-These Python SDKs act as clients for that service. They handle the communication needed to:
-
-* Fetch tool definitions from your running Toolbox instance.
-* Provide convenient Python objects or functions representing those tools.
-* Invoke the tools (calling the underlying APIs/services configured in Toolbox).
-* Handle authentication and parameter binding as needed.
-
-By using these SDKs, you can easily leverage your Toolbox-managed tools directly
-within your Python applications or AI orchestration frameworks.
-
-## Which Package Should I Use?
-
-Choosing the right package depends on how you are building your application:
-
-* [`toolbox-adk`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-adk):
-  Use this package if you are building your application using Google ADK (Agent Development Kit).
-  It provides tools that are directly compatible with the
-  Google ADK ecosystem (`BaseTool` / `BaseToolset` interface) handling authentication propagation, header management, and tool wrapping automatically.
-* [`toolbox-core`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core):
-  Use this package if you are not using LangChain/LangGraph or any other
-  orchestration framework, or if you need a framework-agnostic way to interact
-  with Toolbox tools (e.g., for custom orchestration logic or direct use in
-  Python scripts).
-* [`toolbox-langchain`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-langchain):
-  Use this package if you are building your application using the LangChain or
-  LangGraph frameworks. It provides tools that are directly compatible with the
-  LangChain ecosystem (`BaseTool` interface), simplifying integration.
-* [`toolbox-llamaindex`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-llamaindex):
-  Use this package if you are building your application using the LlamaIndex framework. 
-  It provides tools that are directly compatible with the
-  LlamaIndex ecosystem (`BaseTool` interface), simplifying integration.
-
 ## Available Packages
 
-This repository hosts the following Python packages. See the package-specific
-README for detailed installation and usage instructions:
+This repository hosts the following Python packages. See the package-specific READMEs or the docsite for detailed usage:
 
-| Package | Target Use Case | Integration | Path | Details (README) | PyPI Status |
-| :------ | :---------- | :---------- | :---------------------- | :---------- | :--------- 
-| `toolbox-adk` | Google ADK applications | Google ADK | `packages/toolbox-adk/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-adk/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-adk.svg) |
-| `toolbox-core` | Framework-agnostic / Custom applications | Use directly / Custom | `packages/toolbox-core/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-core/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-core.svg) |
-| `toolbox-langchain` | LangChain / LangGraph applications | LangChain / LangGraph | `packages/toolbox-langchain/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-langchain.svg) |
-| `toolbox-llamaindex` | LlamaIndex  applications                 | LlamaIndex            | `packages/toolbox-llamaindex/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-llamaindex/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-llamaindex.svg) |
+| Package | Target Use Case | Path | Documentation |
+| :------ | :---------- | :--- | :---------- |
+| `toolbox-core` | Framework-agnostic / Custom apps | `packages/toolbox-core/` | [Python Core Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/core/) |
+| `toolbox-adk` | Google ADK Integration | `packages/toolbox-adk/` | [ADK Package Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/adk/) |
+| `toolbox-langchain` | LangChain / LangGraph Integration | `packages/toolbox-langchain/` | [LangChain Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/langchain/) |
+| `toolbox-llamaindex` | LlamaIndex Integration | `packages/toolbox-llamaindex/` | [LlamaIndex Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/) |
 
+## Quickstart
 
-## Getting Started
-
-To get started using Toolbox tools with an application, follow these general steps:
-
-1.  **Set up and Run the Toolbox Service:**
-
-    Before using the SDKs, you need the main MCP Toolbox service running. Follow
-    the instructions here: [**Toolbox Getting Started
-    Guide**](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started)
-
+1.  **Set up the Toolbox Service**: Ensure you have a running MCP Toolbox server. Follow the [MCP Toolbox Server Getting Started Guide](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started).
 2.  **Install the Appropriate SDK:**
-    
-    Choose the package based on your needs (see "[Which Package Should I Use?](#which-package-should-i-use)" above) and install it:
 
     ```bash
     # For the Google ADK
@@ -105,23 +55,13 @@ To get started using Toolbox tools with an application, follow these general ste
 
     # For LangChain/LangGraph integration
     pip install toolbox-langchain
+
+    # OR
 
     # For the LlamaIndex integration
     pip install toolbox-llamaindex
-    ```
-
-3.  **Use the SDK:**
-
-    Consult the README for your chosen package (linked in the "[Available
-    Packages](#available-packages)" section above) for detailed instructions on
-    how to connect the client, load tool definitions, invoke tools, configure
-    authentication/binding, and integrate them into your application or
-    framework.
 
-> [!TIP]
-> For a complete, end-to-end example including setting up the service and using
-> an SDK, see the full tutorial: [**Toolbox Quickstart
-> Tutorial**](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart)
+3.  **Explore Tutorials**: Check out the [Python Quickstart Tutorial](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart/) for a full walkthrough.
 
 ## Contributing
 

README.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-python/compare/toolbox-adk-v0.7.0...toolbox-adk-v1.0.0) (2026-03-25)
+
+
+### Features
+
+* **adk:** Enable support for ADK 2.0 ([#584](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/584)) ([7effeb5](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/7effeb518e88329b32fa32bbacc08bf9e6de5de4))
+* **adk:** Support `ToolContext` for `auth_token_getters` in `toolbox-adk` ([#579](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/579)) ([05e5f2c](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/05e5f2cba0a123c14594508eeee6bd228274b138))
+* **core:** add observability with OpenTelemetry ([#583](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/583)) ([d479385](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/d479385cccf31a7cb1dffcc4634ddb6fe7ef932a))
+
+
+### Bug Fixes
+
+* **adk:** Preserve complex schema types (arrays/objects) in `FunctionDeclaration` mapping ([#594](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/594)) ([c91e7d5](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/c91e7d50383c10f4c4e9ee682c6da3912b574612))
+* **adk:** remove id_token monkey patch following upstream ADK fix ([#602](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/602)) ([d9cd9aa](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/d9cd9aa5a0fd80349be78e9b6a5242af469e463a))
+
+
+### Documentation
+
+* Documentation migrated to MCP Toolbox official docsite. ([#581](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/581)) ([da12899](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/da1289944d8d401c0d2b958ae47da42da729848e))
+
 ## [0.7.0](https://github.com/googleapis/mcp-toolbox-sdk-python/compare/toolbox-adk-v0.6.1...toolbox-adk-v0.7.0) (2026-03-05)