Mcp Toolbox Sdk Go

MCP Toolbox SDKs for Go

[](https://opensource.org/licenses/Apache-2.0) [](https://mcp-toolbox.dev/) [](https://discord.gg/Dmm69peqjh) [](https://medium.com/@mcp_toolbox)

Core Module : [](https://goreportcard.com/report/github.com/googleapis/mcp-toolbox-sdk-go/core) [](https://img.shields.io/github/v/release/googleapis/mcp-toolbox-sdk-go?filter=core/v*) [](https://img.shields.io/github/go-mod/go-version/googleapis/mcp-toolbox-sdk-go?filename=core/go.mod)

TBADK Module : [](https://goreportcard.com/report/github.com/googleapis/mcp-toolbox-sdk-go/tbadk) [](https://img.shields.io/github/v/release/googleapis/mcp-toolbox-sdk-go?filter=tbadk/v*) [](https://img.shields.io/github/go-mod/go-version/googleapis/mcp-toolbox-sdk-go?filename=tbadk/go.mod)

TBGenkit Module : [](https://goreportcard.com/report/github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit) [](https://img.shields.io/github/v/release/googleapis/mcp-toolbox-sdk-go?filter=tbgenkit/v*) [](https://img.shields.io/github/go-mod/go-version/googleapis/mcp-toolbox-sdk-go?filename=tbgenkit/go.mod)

> [!IMPORTANT] > Breaking Change Notice: As of version 0.6.0, this repository has transitioned to a multi-module structure. > For new versions (v0.6.0+): You must import specific modules (e.g., go get github.com/googleapis/mcp-toolbox-sdk-go/core). > For older versions (v0.5.1 and below): The repository remains a single-module library (go get github.com/googleapis/mcp-toolbox-sdk-go). > * Please update your imports and go.mod accordingly when upgrading.

This repository contains the Go SDKs for MCP Toolbox. These SDKs allow you to load and use tools defined in your MCP Toolbox server as standard Go structs within your Agentic applications.

For comprehensive guides and advanced configuration, visit the Main Documentation Site.

• [Overview](#overview)
• [Available Packages](#available-packages)
• [Quick Start](#quick-start)
• [Contributing](#contributing)
• [License](#license)
• [Support](#support)

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.

The Go SDK act as clients for that service. They handle the communication needed to:

• Fetch tool definitions from your running Toolbox instance.
• Provide convenient Go structs representing those tools.
• Invoke the tools (calling the underlying APIs/services configured in Toolbox).
• Handle authentication and parameter binding as needed.

By using the SDK, you can easily leverage your MCP Toolbox-managed tools directly within your Go applications or AI orchestration frameworks.

Available Packages

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

| Package | Target Use Case | Path | Documentation | | :------ | :----------| :--- | :---------- | | core | Framework-agnostic / Custom apps | core/ | Go SDK Core Guide | | tbadk | ADK Go Integration | tbadk/ | ADK Package Guide | | tbgenkit | Genkit Go Integration | tbgenkit/ | Genkit Package Guide |

Quick Start

1. Set up the Toolbox Service: Ensure you have a running MCP Toolbox server. Follow the MCP Toolbox Server Quickstart.
2. Install the Appropriate SDK:

```bash # For the core, framework-agnostic SDK go get github.com/googleapis/mcp-toolbox-sdk-go/core

# For ADK Go go get github.com/googleapis/mcp-toolbox-sdk-go/tbadk

# For Genkit Go go get github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit ```

1. Explore Tutorials: Check out the Go Quickstart Tutorial for a full walkthrough.

Contributing

Contributions are welcome! Please refer to the CONTRIBUTING.md to get started.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Support

If you encounter issues or have questions, please check the existing GitHub Issues for the main Toolbox project. If your issue is specific to one of the SDKs, please look for existing issues here or open a new issue in this repository.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: googleapis
• Source: googleapis/mcp-toolbox-sdk-go
• License: Apache-2.0
• Homepage: https://mcp-toolbox.dev/documentation/introduction/

Install and usage instructions live in the source repository linked above.