From 8b33b4cde9bff953284f129b9dab3c7bb3b4786e Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Tue, 9 Dec 2025 11:31:22 +0530
Subject: [PATCH 1/5] docs: Add MCP Toolbox for databases TS SDK Documentation
---
.../google-cloud/mcp-toolbox-for-databases.md | 64 ++++++++++++++++++-
1 file changed, 63 insertions(+), 1 deletion(-)
diff --git a/docs/tools/google-cloud/mcp-toolbox-for-databases.md b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
index 6a6df6b19..1ebdb323e 100644
--- a/docs/tools/google-cloud/mcp-toolbox-for-databases.md
+++ b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
@@ -1,7 +1,7 @@
# MCP Toolbox for Databases
- Supported in ADKPythonGo
+ Supported in ADKPythonGoTS
[MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox) is an
@@ -174,6 +174,68 @@ documentation:
}
```
+=== "TS"
+
+ ADK relies on the `@toolbox-sdk/adk` go module to use Toolbox. Install the
+ module before getting started:
+
+ ```shell
+ npm install @toolbox-sdk/adk
+ ```
+
+ ### Loading Toolbox Tools
+
+ Once you’re Toolbox server is configured and up and running, you can load tools
+ from your server using ADK:
+
+ ```javascript
+ import {FunctionTool, InMemoryRunner, LlmAgent} from '@google/adk';
+ import {Content} from '@google/genai';
+ import {ToolboxClient} from '@toolbox-sdk/core'
+
+ const toolboxClient = new ToolboxClient("http://127.0.0.1:5000");
+ const loadedTools = await toolboxClient.loadToolset();
+
+ export const rootAgent = new LlmAgent({
+ name: 'weather_time_agent',
+ model: 'gemini-2.5-flash',
+ description:
+ 'Agent to answer questions about the time and weather in a city.',
+ instruction:
+ 'You are a helpful agent who can answer user questions about the time and weather in a city.',
+ tools: loadedTools,
+ });
+
+ async function main() {
+ const userId = 'test_user';
+ const appName = rootAgent.name;
+ const runner = new InMemoryRunner({agent: rootAgent, appName});
+ const session = await runner.sessionService.createSession({
+ appName,
+ userId,
+ });
+
+ const prompt = 'What is the weather in New York? And the time?';
+ const content: Content = {
+ role: 'user',
+ parts: [{text: prompt}],
+ };
+ console.log(content);
+ for await (const e of runner.runAsync({
+ userId,
+ sessionId: session.id,
+ newMessage: content,
+ })) {
+ if (e.content?.parts?.[0]?.text) {
+ console.log(`${e.author}: ${JSON.stringify(e.content, null, 2)}`);
+ }
+ }
+ }
+
+ main().catch(console.error);
+ ```
+
+
## Advanced Toolbox Features
Toolbox has a variety of features to make developing Gen AI tools for databases.
From a0146171d972fb9d35ea93cff465d36f9f1dde43 Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Wed, 10 Dec 2025 13:15:12 +0530
Subject: [PATCH 2/5] Update mcp-toolbox-for-databases.md
---
docs/tools/google-cloud/mcp-toolbox-for-databases.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/tools/google-cloud/mcp-toolbox-for-databases.md b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
index 1ebdb323e..3f1e116ff 100644
--- a/docs/tools/google-cloud/mcp-toolbox-for-databases.md
+++ b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
@@ -1,7 +1,7 @@
# MCP Toolbox for Databases
- Supported in ADKPythonGoTS
+ Supported in ADKPythonGoTypescript
[MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox) is an
From cb24916f4b379667f93c7a03f756d4f7abd2b8d4 Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Wed, 10 Dec 2025 13:17:01 +0530
Subject: [PATCH 3/5] use typescript code block
---
docs/tools/google-cloud/mcp-toolbox-for-databases.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/tools/google-cloud/mcp-toolbox-for-databases.md b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
index 3f1e116ff..efc9a477b 100644
--- a/docs/tools/google-cloud/mcp-toolbox-for-databases.md
+++ b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
@@ -188,7 +188,7 @@ documentation:
Once you’re Toolbox server is configured and up and running, you can load tools
from your server using ADK:
- ```javascript
+ ```typescript
import {FunctionTool, InMemoryRunner, LlmAgent} from '@google/adk';
import {Content} from '@google/genai';
import {ToolboxClient} from '@toolbox-sdk/core'
From bd92f1f31b0103a05822e6285fe9b5bc63c38299 Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Wed, 10 Dec 2025 13:18:01 +0530
Subject: [PATCH 4/5] minor changes
---
docs/tools/google-cloud/mcp-toolbox-for-databases.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/docs/tools/google-cloud/mcp-toolbox-for-databases.md b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
index efc9a477b..a054e2133 100644
--- a/docs/tools/google-cloud/mcp-toolbox-for-databases.md
+++ b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
@@ -174,10 +174,10 @@ documentation:
}
```
-=== "TS"
+=== "Typescript"
- ADK relies on the `@toolbox-sdk/adk` go module to use Toolbox. Install the
- module before getting started:
+ ADK relies on the `@toolbox-sdk/adk` TS package to use Toolbox. Install the
+ package before getting started:
```shell
npm install @toolbox-sdk/adk
@@ -189,7 +189,7 @@ documentation:
from your server using ADK:
```typescript
- import {FunctionTool, InMemoryRunner, LlmAgent} from '@google/adk';
+ import {InMemoryRunner, LlmAgent} from '@google/adk';
import {Content} from '@google/genai';
import {ToolboxClient} from '@toolbox-sdk/core'
From 492e7d33231de0d2011a79da59e597068f37250c Mon Sep 17 00:00:00 2001
From: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
Date: Wed, 10 Dec 2025 13:25:13 +0530
Subject: [PATCH 5/5] Update mcp-toolbox-for-databases.md
---
docs/tools/google-cloud/mcp-toolbox-for-databases.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/tools/google-cloud/mcp-toolbox-for-databases.md b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
index a054e2133..563572779 100644
--- a/docs/tools/google-cloud/mcp-toolbox-for-databases.md
+++ b/docs/tools/google-cloud/mcp-toolbox-for-databases.md
@@ -191,7 +191,7 @@ documentation:
```typescript
import {InMemoryRunner, LlmAgent} from '@google/adk';
import {Content} from '@google/genai';
- import {ToolboxClient} from '@toolbox-sdk/core'
+ import {ToolboxClient} from '@toolbox-sdk/adk'
const toolboxClient = new ToolboxClient("http://127.0.0.1:5000");
const loadedTools = await toolboxClient.loadToolset();