\n![\"architecture\"](\"docs/en/documentation/introduction/architecture.png\")
\n
\n\n\n\nCore
\n\n1. Install [Toolbox Core SDK][toolbox-core]:\n\n ```bash\n pip install toolbox-core\n ```\n\n1. Load tools:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = await client.load_toolset(\"toolset_name\")\n ```\n\nFor more detailed instructions on using the Toolbox Core SDK, see the\n[project's README][toolbox-core-readme].\n\n[toolbox-core]: https://pypi.org/project/toolbox-core/\n[toolbox-core-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md\n\n\n\nLangChain / LangGraph
\n\n1. Install [Toolbox LangChain SDK][toolbox-langchain]:\n\n ```bash\n pip install toolbox-langchain\n ```\n\n1. Load tools:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = client.load_toolset()\n ```\n\n For more detailed instructions on using the Toolbox LangChain SDK, see the\n [project's README][toolbox-langchain-readme].\n\n [toolbox-langchain]: https://pypi.org/project/toolbox-langchain/\n [toolbox-langchain-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md\n\n\n\nLlamaIndex
\n\n1. Install [Toolbox Llamaindex SDK][toolbox-llamaindex]:\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n1. Load tools:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = client.load_toolset()\n ```\n\n For more detailed instructions on using the Toolbox Llamaindex SDK, see the\n [project's README][toolbox-llamaindex-readme].\n\n [toolbox-llamaindex]: https://pypi.org/project/toolbox-llamaindex/\n [toolbox-llamaindex-readme]: https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md\n\n
\n\n\n\nCore
\n\n1. Install [Toolbox Core SDK][toolbox-core-js]:\n\n ```bash\n npm install @toolbox-sdk/core\n ```\n\n1. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk/core';\n\n // update the url to point to your server\n const URL = 'http://127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n // these tools can be passed to your application!\n const tools = await client.loadToolset('toolsetName');\n ```\n\n For more detailed instructions on using the Toolbox Core SDK, see the\n [project's README][toolbox-core-js-readme].\n\n [toolbox-core-js]: https://www.npmjs.com/package/@toolbox-sdk/core\n [toolbox-core-js-readme]: https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-core/README.md\n\n\n\nLangChain / LangGraph
\n\n1. Install [Toolbox Core SDK][toolbox-core-js]:\n\n ```bash\n npm install @toolbox-sdk/core\n ```\n\n2. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk/core';\n\n // update the url to point to your server\n const URL = 'http://127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n // these tools can be passed to your application!\n const toolboxTools = await client.loadToolset('toolsetName');\n\n // Define the basics of the tool: name, description, schema and core logic\n const getTool = (toolboxTool) => tool(currTool, {\n name: toolboxTool.getName(),\n description: toolboxTool.getDescription(),\n schema: toolboxTool.getParamSchema()\n });\n\n // Use these tools in your Langchain/Langraph applications\n const tools = toolboxTools.map(getTool);\n ```\n\n\n\nGenkit
\n\n1. Install [Toolbox Core SDK][toolbox-core-js]:\n\n ```bash\n npm install @toolbox-sdk/core\n ```\n\n2. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk/core';\n import { genkit } from 'genkit';\n\n // Initialise genkit\n const ai = genkit({\n plugins: [\n googleAI({\n apiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY\n })\n ],\n model: googleAI.model('gemini-2.0-flash'),\n });\n\n // update the url to point to your server\n const URL = 'http://127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n // these tools can be passed to your application!\n const toolboxTools = await client.loadToolset('toolsetName');\n\n // Define the basics of the tool: name, description, schema and core logic\n const getTool = (toolboxTool) => ai.defineTool({\n name: toolboxTool.getName(),\n description: toolboxTool.getDescription(),\n schema: toolboxTool.getParamSchema()\n }, toolboxTool)\n\n // Use these tools in your Genkit applications\n const tools = toolboxTools.map(getTool);\n ```\n\n\n\nADK
\n\n1. Install [Toolbox ADK SDK][toolbox-adk-js]:\n\n ```bash\n npm install @toolbox-sdk/adk\n ```\n\n2. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk/adk';\n\n // update the url to point to your server\n const URL = 'http://127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n // these tools can be passed to your application!\n const tools = await client.loadToolset('toolsetName');\n ```\n\n For more detailed instructions on using the Toolbox ADK SDK, see the\n [project's README][toolbox-adk-js-readme].\n\n [toolbox-adk-js]: https://www.npmjs.com/package/@toolbox-sdk/adk\n [toolbox-adk-js-readme]:\n https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-adk/README.md\n\n
\n\n\n\nCore
\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com/googleapis/mcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"github.com/googleapis/mcp-toolbox-sdk-go/core\"\n \"context\"\n )\n\n func main() {\n // Make sure to add the error checks\n // update the url to point to your server\n URL := \"http://127.0.0.1:5000\";\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n // Framework agnostic tools\n tools, err := client.LoadToolset(\"toolsetName\", ctx)\n }\n ```\n\n For more detailed instructions on using the Toolbox Go SDK, see the\n [project's README][toolbox-core-go-readme].\n\n [toolbox-go]: https://pkg.go.dev/github.com/googleapis/mcp-toolbox-sdk-go/core\n [toolbox-core-go-readme]: https://github.com/googleapis/mcp-toolbox-sdk-go/blob/main/core/README.md\n\n\n\nLangChain Go
\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com/googleapis/mcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding/json\"\n\n \"github.com/googleapis/mcp-toolbox-sdk-go/core\"\n \"github.com/tmc/langchaingo/llms\"\n )\n\n func main() {\n // Make sure to add the error checks\n // update the url to point to your server\n URL := \"http://127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n // Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n // Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var paramsSchema map[string]any\n _ = json.Unmarshal(inputschema, ¶msSchema)\n\n // Use this tool with LangChainGo\n langChainTool := llms.Tool{\n Type: \"function\",\n Function: &llms.FunctionDefinition{\n Name: tool.Name(),\n Description: tool.Description(),\n Parameters: paramsSchema,\n },\n }\n }\n\n ```\n\n\n\nGenkit
\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com/googleapis/mcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n import (\n \"context\"\n \"log\"\n\n \"github.com/firebase/genkit/go/genkit\"\n \"github.com/googleapis/mcp-toolbox-sdk-go/core\"\n \"github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit\"\n )\n\n func main() {\n // Make sure to add the error checks\n // Update the url to point to your server\n URL := \"http://127.0.0.1:5000\"\n ctx := context.Background()\n g := genkit.Init(ctx)\n\n client, err := core.NewToolboxClient(URL)\n\n // Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n // Convert the tool using the tbgenkit package\n // Use this tool with Genkit Go\n genkitTool, err := tbgenkit.ToGenkitTool(tool, g)\n if err != nil {\n log.Fatalf(\"Failed to convert tool: %v\\n\", err)\n }\n log.Printf(\"Successfully converted tool: %s\", genkitTool.Name())\n }\n ```\n\n\n\nGo GenAI
\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com/googleapis/mcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding/json\"\n\n \"github.com/googleapis/mcp-toolbox-sdk-go/core\"\n \"google.golang.org/genai\"\n )\n\n func main() {\n // Make sure to add the error checks\n // Update the url to point to your server\n URL := \"http://127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n // Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n // Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var schema *genai.Schema\n _ = json.Unmarshal(inputschema, &schema)\n\n funcDeclaration := &genai.FunctionDeclaration{\n Name: tool.Name(),\n Description: tool.Description(),\n Parameters: schema,\n }\n\n // Use this tool with Go GenAI\n genAITool := &genai.Tool{\n FunctionDeclarations: []*genai.FunctionDeclaration{funcDeclaration},\n }\n }\n ```\n\n\n\nOpenAI Go
\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com/googleapis/mcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding/json\"\n\n \"github.com/googleapis/mcp-toolbox-sdk-go/core\"\n openai \"github.com/openai/openai-go\"\n )\n\n func main() {\n // Make sure to add the error checks\n // Update the url to point to your server\n URL := \"http://127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n // Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n // Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var paramsSchema openai.FunctionParameters\n _ = json.Unmarshal(inputschema, ¶msSchema)\n\n // Use this tool with OpenAI Go\n openAITool := openai.ChatCompletionToolParam{\n Function: openai.FunctionDefinitionParam{\n Name: tool.Name(),\n Description: openai.String(tool.Description()),\n Parameters: paramsSchema,\n },\n }\n\n }\n ```\n\n\n\nADK Go
\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com/googleapis/mcp-toolbox-sdk-go\n ```\n\n1. Load tools:\n\n ```go\n package main\n\n import (\n \"github.com/googleapis/mcp-toolbox-sdk-go/tbadk\"\n \"context\"\n )\n\n func main() {\n // Make sure to add the error checks\n // Update the url to point to your server\n URL := \"http://127.0.0.1:5000\"\n ctx := context.Background()\n client, err := tbadk.NewToolboxClient(URL)\n if err != nil {\n return fmt.Sprintln(\"Could not start Toolbox Client\", err)\n }\n\n // Use this tool with ADK Go\n tool, err := client.LoadTool(\"toolName\", ctx)\n if err != nil {\n return fmt.Sprintln(\"Could not load Toolbox Tool\", err)\n }\n }\n ```\n\n For more detailed instructions on using the Toolbox Go SDK, see the\n [project's README][toolbox-core-go-readme].\n\n\n