# Mcp Toolbox Sdk Go

> Go SDK for interacting with the MCP Toolbox for Databases.

- **Type:** MCP server
- **Install:** `agentstack add mcp-googleapis-mcp-toolbox-sdk-go`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [googleapis](https://agentstack.voostack.com/s/googleapis)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [googleapis](https://github.com/googleapis)
- **Source:** https://github.com/googleapis/mcp-toolbox-sdk-go
- **Website:** https://mcp-toolbox.dev/documentation/introduction/

## Install

```sh
agentstack add mcp-googleapis-mcp-toolbox-sdk-go
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://github.com/googleapis/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](https://mcp-toolbox.dev/).

- [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](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/go-sdk/core/) |
| `tbadk` | ADK Go Integration | `tbadk/` | [ADK Package Guide](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/go-sdk/tbadk/) |
| `tbgenkit` | Genkit Go Integration | `tbgenkit/` | [Genkit Package Guide](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/go-sdk/tbgenkit/) |

## Quick Start

1.  **Set up the Toolbox Service**: Ensure you have a running MCP Toolbox server. Follow the [MCP Toolbox Server Quickstart](https://mcp-toolbox.dev/documentation/introduction/).
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
    ```
3.  **Explore Tutorials**: Check out the [Go Quickstart Tutorial](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/go-sdk/) for a full walkthrough.

## Contributing

Contributions are welcome! Please refer to the
[`CONTRIBUTING.md`](https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/CONTRIBUTING.md)
to get started.

## License

This project is licensed under the Apache License 2.0. See the
[LICENSE](https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/LICENSE) file
for details.

## Support

If you encounter issues or have questions, please check the existing [GitHub
Issues](https://github.com/googleapis/mcp-toolbox/issues) for the main Toolbox
project. If your issue is specific to one of the SDKs, please look for existing
issues [here](https://github.com/googleapis/mcp-toolbox-sdk-go/issues) 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](https://github.com/googleapis)
- **Source:** [googleapis/mcp-toolbox-sdk-go](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-googleapis-mcp-toolbox-sdk-go
- Seller: https://agentstack.voostack.com/s/googleapis
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.