Python

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.

These Python SDKs act as clients for that service. They handle the communication needed to:

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

By using these SDKs, you can easily leverage your Toolbox-managed tools directly within your Python applications or AI orchestration frameworks.

Which Package Should I Use?

Choosing the right package depends on how you are building your application:

• toolbox-adk: Use this package if you are building your application using Google ADK (Agent Development Kit). It provides tools that are directly compatible with the Google ADK ecosystem (BaseTool / BaseToolset interface) handling authentication propagation, header management, and tool wrapping automatically.
• toolbox-core: Use this package if you are not using LangChain/LangGraph or any other orchestration framework, or if you need a framework-agnostic way to interact with Toolbox tools (e.g., for custom orchestration logic or direct use in Python scripts).
• toolbox-langchain: Use this package if you are building your application using the LangChain or LangGraph frameworks. It provides tools that are directly compatible with the LangChain ecosystem (BaseTool interface), simplifying integration.
• toolbox-llamaindex: Use this package if you are building your application using the LlamaIndex framework. It provides tools that are directly compatible with the LlamaIndex ecosystem (BaseTool interface), simplifying integration.

Available Packages

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

Package	Target Use Case	Integration	Path	Details (README)	PyPI Status
toolbox-adk	Google ADK applications	Google ADK	packages/toolbox-adk/	📄 View README
toolbox-core	Framework-agnostic / Custom applications	Use directly / Custom	packages/toolbox-core/	📄 View README
toolbox-langchain	LangChain / LangGraph applications	LangChain / LangGraph	packages/toolbox-langchain/	📄 View README
toolbox-llamaindex	LlamaIndex applications	LlamaIndex	packages/toolbox-llamaindex/	📄 View README

Getting Started

To get started using Toolbox tools with an application, follow these general steps:

1. Set up and Run the Toolbox Service:

   Before using the SDKs, you need the main MCP Toolbox service running. Follow the instructions here: Toolbox Getting Started Guide

2. Install the Appropriate SDK:

   Choose the package based on your needs (see “Which Package Should I Use?” above) and install it:

   # For the Google ADK Integration
   pip install google-adk[toolbox]
   
   # OR
   
   # For the core, framework-agnostic SDK
   pip install toolbox-core
   
   # OR
   
   # For LangChain/LangGraph integration
   pip install toolbox-langchain
   
   # OR
   
   # For the LlamaIndex integration
   pip install toolbox-llamaindex