{"id":24718,"library":"toolbox-adk","title":"Toolbox ADK (Agent Development Kit)","description":"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.","status":"active","version":"1.0.0","language":"python","source_language":"en","source_url":"https://github.com/googleapis/mcp-toolbox-sdk-python.git","tags":["agent development kit","adk","mcp","toolbox","google"],"install":[{"cmd":"pip install toolbox-adk","lang":"bash","label":"Default installation"}],"dependencies":[],"imports":[{"note":"Common mistake: attempting 'import toolbox' instead of importing specific class.","wrong":"","symbol":"ToolboxTool","correct":"from toolbox_adk import ToolboxTool"}],"quickstart":{"code":"from toolbox_adk import ToolboxTool\nfrom google.adk.agents import Agent\nfrom google.adk.tools import ToolContext\n\nurl = os.environ.get('TOOLBOX_URL', 'http://localhost:8080')\napi_key = os.environ.get('TOOLBOX_API_KEY', '')\n\ntoolbox_tool = ToolboxTool(url=url, api_key=api_key)\nagent = Agent(model='gemini-pro', tools=[toolbox_tool])\n\n# Example usage\nfor event in agent.run(\"What tools are available?\"):\n    print(event.content)","lang":"python","description":"Minimal setup to use a ToolboxTool inside an ADK agent."},"warnings":[{"fix":"Upgrade Python to 3.10+ or use a virtual environment with the correct version.","message":"Requires Python >=3.10. Using older Python leads to SyntaxError or dependency conflicts.","severity":"breaking","affected_versions":"<3.10"},{"fix":"Ensure TOOLBOX_URL is set and the server is running before initializing the agent.","message":"The Toolbox URL must point to a running MCP Toolbox server. Missing or invalid URL causes connection errors on first tool call.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'from toolbox_adk import ToolboxTool' instead.","message":"The import path 'from toolbox_adk import ToolboxToolTool' was used in pre-release versions. That symbol is removed in 1.0.0.","severity":"deprecated","affected_versions":"<1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install toolbox-adk' in your current environment.","cause":"The package is not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'toolbox_adk'"},{"fix":"Upgrade: 'pip install --upgrade toolbox-adk' and then import ToolboxTool.","cause":"The installed version is pre-1.0.0 and uses a different class name or the package is corrupted.","error":"ImportError: cannot import name 'ToolboxTool' from 'toolbox_adk'"},{"fix":"Either pass url='http://...' to ToolboxTool constructor, or set TOOLBOX_URL environment variable.","cause":"No URL specified and TOOLBOX_URL env var not set.","error":"ValueError: Missing URL for ToolboxTool. Provide a 'url' parameter or set the TOOLBOX_URL environment variable."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}