Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 47 additions & 4 deletions docs/en/sdks/JS-sdk/_index.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
---
title: "JS SDK"
title: "Javascript"
type: docs
weight: 7
description: >
JS SDKs to connect to the MCP Toolbox server.
Javascript SDKs to connect to the MCP Toolbox server.
---


## Overview

The MCP Toolbox service provides a centralized way to manage and expose tools
Expand All @@ -22,4 +21,48 @@ These JS SDKs act as clients for that service. They handle the communication nee
By using these SDKs, you can easily leverage your Toolbox-managed tools directly
within your JS applications or AI orchestration frameworks.

[Github](https://github.com/googleapis/mcp-toolbox-sdk-js)
## Which Package Should I Use?

Choosing the right package depends on how you are building your application:

- [`@toolbox-sdk/core`](https://github.com/googleapis/mcp-toolbox-sdk-js/tree/main/packages/toolbox-core):
This is a framework agnostic way to connect the tools to popular frameworks
like Langchain, LlamaIndex and Genkit.
- [`@toolbox-sdk/adk`](https://github.com/googleapis/mcp-toolbox-sdk-js/tree/main/packages/toolbox-adk):
This package provides a seamless way to connect to [Google ADK TS](https://github.com/google/adk-js).

## Available Packages

This repository hosts the following TS packages. See the package-specific
README for detailed installation and usage instructions:

| Package | Target Use Case | Integration | Path | Details (README) | Npm Version |
| :------ | :---------- | :---------- | :---------------------- | :---------- | :---------
Comment thread
rapid-killer-9 marked this conversation as resolved.
Outdated
| `toolbox-core` | Framework-agnostic / Custom applications | Use directly / Custom | `packages/toolbox-core/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-core/README.md) | ![npm](https://img.shields.io/npm/v/@toolbox-sdk/core) |
| `toolbox-adk` | ADK applications | ADK | `packages/toolbox-adk/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-adk/README.md) | ![npm](https://img.shields.io/npm/v/@toolbox-sdk/adk) |


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

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 core, framework-agnostic SDK
npm install @toolbox-sdk/core
Comment thread
rapid-killer-9 marked this conversation as resolved.
```



{{< notice note >}}
Source code for [js-sdk](https://github.com/googleapis/mcp-toolbox-sdk-js)
{{< /notice >}}
Comment thread
rapid-killer-9 marked this conversation as resolved.
Loading