Python SDK

Python SDKs to connect to the MCP Toolbox server.

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-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.
  • 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).

Available Packages

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

PackageTarget Use CaseIntegrationPathDetails (README)PyPI Status
toolbox-coreFramework-agnostic / Custom applicationsUse directly / Custompackages/toolbox-core/📄 View READMEpypi version
toolbox-langchainLangChain / LangGraph applicationsLangChain / LangGraphpackages/toolbox-langchain/📄 View READMEpypi version
toolbox-llamaindexLlamaIndex applicationsLlamaIndexpackages/toolbox-llamaindex/📄 View READMEpypi version

Note

Source code for python-sdk


Adk

MCP Toolbox ADK SDK for integrating functionalities of MCP Toolbox into your apps.