ToolUniverse

1.1.11 verified Sat May 09 auth: no python

A comprehensive collection of scientific tools for Agentic AI, offering integration with the ToolUniverse SDK and MCP Server to support advanced scientific workflows. Current version 1.1.11, requires Python >=3.10. Actively maintained with frequent releases.

pip install tooluniverse

Common errors

error ModuleNotFoundError: No module named 'tooluniverse' ↓

cause Package not installed or installed as 'tooluniverse-sdk' (old name).

fix

Run: pip install tooluniverse

error ImportError: cannot import name 'ToolUniverse' from 'tooluniverse' ↓

cause Incorrect import path; ToolUniverse is not directly in package if using old submodule.

fix

Ensure you are using the correct package version and import: from tooluniverse import ToolUniverse

error tooluniverse.exceptions.AuthenticationError: API key not found ↓

cause TOOLUNIVERSE_API_KEY environment variable not set or empty.

fix

Set TOOLUNIVERSE_API_KEY='your_key' in environment or pass api_key='your_key' to ToolUniverse constructor.

error ValueError: Python 3.10 or higher is required ↓

cause Running on Python 3.9 or older.

fix

Upgrade Python to 3.10+ and reinstall tooluniverse.

Warnings

breaking Package renamed from 'tooluniverse-sdk' to 'tooluniverse' in version 1.0.0. Old package is deprecated. ↓

fix Uninstall old package: pip uninstall tooluniverse-sdk; install new: pip install tooluniverse

gotcha API key must be set via environment variable TOOLUNIVERSE_API_KEY or passed to ToolUniverse constructor. If missing, some tools will fail with authentication errors. ↓

fix Set TOOLUNIVERSE_API_KEY in environment or pass api_key argument.

breaking Python 3.10+ required. Using older Python may cause import errors or dependency conflicts. ↓

fix Upgrade to Python 3.10 or higher.

deprecated The old 'tooluniverse.sdk' module path is deprecated in v1.1.0+; use direct imports from 'tooluniverse'. ↓

fix Change imports: from tooluniverse import ToolUniverse instead of from tooluniverse.sdk import ToolUniverse

gotcha Some tools require external APIs (e.g., ChEMBL, Orphanet) and may have rate limits or require additional authentication. ↓

fix Check tool documentation for specific prerequisites and rate limits.

Install

pip install 'tooluniverse==1.1.11'

Imports

ToolUniverse
wrong
```
from tooluniverse.sdk import ToolUniverse
```
correct
```
from tooluniverse import ToolUniverse
```
Incorrect submodule path; ToolUniverse class is at top-level package.

register_tool

wrong

from tooluniverse.registry import register_tool

correct

from tooluniverse import register_tool

register_tool is available directly from tooluniverse.

ToolConfig

wrong

from tooluniverse.schemas import ToolConfig

correct

from tooluniverse import ToolConfig

ToolConfig is exported at package level.

Quickstart

Initialize ToolUniverse client, list tools, and execute an example tool.

import os
from tooluniverse import ToolUniverse

# Initialize the client (set TOOLUNIVERSE_API_KEY env var)
tu = ToolUniverse(api_key=os.environ.get('TOOLUNIVERSE_API_KEY', ''))

# List available tools
tools = tu.list_tools()
print(tools[:2])

# Execute a tool (e.g., simple echo for demonstration)
result = tu.execute_tool('echo', {'message': 'Hello, ToolUniverse!'})
print(result)