MCP Toolbox SDKs for Go

Core Module :

TBADK Module :

TBGenkit Module :

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
• Available Packages
• Quick Start
• Contributing
• License
• 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:

   # 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

3. 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.