Toolbox ADK (Agent Development Kit)

1.0.0 verified Fri May 01 auth: no python

Integrates the MCP Toolbox with Google ADK (Agent Development Kit) for building AI agents. Version 1.0.0, Python >=3.10. Early release, rapid changes expected.

pip install toolbox-adk

Common errors

error ModuleNotFoundError: No module named 'toolbox_adk' ↓

cause The package is not installed or installed in a different environment.

fix

Run 'pip install toolbox-adk' in your current environment.

error ImportError: cannot import name 'ToolboxTool' from 'toolbox_adk' ↓

cause The installed version is pre-1.0.0 and uses a different class name or the package is corrupted.

fix

Upgrade: 'pip install --upgrade toolbox-adk' and then import ToolboxTool.

error ValueError: Missing URL for ToolboxTool. Provide a 'url' parameter or set the TOOLBOX_URL environment variable. ↓

cause No URL specified and TOOLBOX_URL env var not set.

fix

Either pass url='http://...' to ToolboxTool constructor, or set TOOLBOX_URL environment variable.

Warnings

breaking Requires Python >=3.10. Using older Python leads to SyntaxError or dependency conflicts. ↓

fix Upgrade Python to 3.10+ or use a virtual environment with the correct version.

gotcha The Toolbox URL must point to a running MCP Toolbox server. Missing or invalid URL causes connection errors on first tool call. ↓

fix Ensure TOOLBOX_URL is set and the server is running before initializing the agent.

deprecated The import path 'from toolbox_adk import ToolboxToolTool' was used in pre-release versions. That symbol is removed in 1.0.0. ↓

fix Use 'from toolbox_adk import ToolboxTool' instead.

Imports

ToolboxTool
```
from toolbox_adk import ToolboxTool
```
Common mistake: attempting 'import toolbox' instead of importing specific class.

Quickstart

Minimal setup to use a ToolboxTool inside an ADK agent.

from toolbox_adk import ToolboxTool
from google.adk.agents import Agent
from google.adk.tools import ToolContext

url = os.environ.get('TOOLBOX_URL', 'http://localhost:8080')
api_key = os.environ.get('TOOLBOX_API_KEY', '')

toolbox_tool = ToolboxTool(url=url, api_key=api_key)
agent = Agent(model='gemini-pro', tools=[toolbox_tool])

# Example usage
for event in agent.run("What tools are available?"):
    print(event.content)