This SDK allows you to seamlessly integrate the functionalities of Toolbox allowing you to load and use tools defined in the service as standard Go structs within your GenAI applications.

For comprehensive guides, authentication examples, and advanced configuration, visit the Go SDK Core Documentation.

• MCP Toolbox Core SDK
  • Installation
  • Quickstart
  • Usage
• Contributing
• License
• Support

go get github.com/googleapis/mcp-toolbox-sdk-go/core

This SDK is supported on Go version 1.24.4 and higher.

Here's a minimal example to get you started. Ensure your Toolbox service is running and accessible.

package main

import (
	"context"
	"fmt"
	"github.com/googleapis/mcp-toolbox-sdk-go/core"
)

func quickstart() string {
	ctx := context.Background()
	inputs := map[string]any{"location": "London"}
	client, err := core.NewToolboxClient("http://localhost:5000")
	if err != nil {
		return fmt.Sprintln("Could not start Toolbox Client", err)
	}
	tool, err := client.LoadTool("get_weather", ctx)
	if err != nil {
		return fmt.Sprintln("Could not load Toolbox Tool", err)
	}
	result, err := tool.Invoke(ctx, inputs)
	if err != nil {
		return fmt.Sprintln("Could not invoke tool", err)
	}
	return fmt.Sprintln(result)
}

func main() {
	fmt.Println(quickstart())
}

The core package provides a framework-agnostic way to interact with your MCP Toolbox server. For detailed guides and advanced configuration, please visit the following sections on our Documentation Site:

• Transport Protocols
• Loading Tools
• Invoking Tools
• Client to Server Authentication
• Authenticating Tools
• Binding Parameter Values
• Default Parameters
• Using with Orchestration Frameworks

Contributions are welcome! Please refer to the DEVELOPER.md file for guidelines on how to set up a development environment and run tests.

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

If you encounter issues or have questions, check the existing GitHub Issues for the main Toolbox project.