Skip to main content

ToolUniverse Logo ToolUniverse: Democratizing AI scientists

Documentation Paper PyPI version MCP Registry Website Slack WeChat LinkedIn X PyPI Downloads

Install

AI agent (recommended) — open your AI agent and run:

Read https://aiscientist.tools/setup.md and set up ToolUniverse for me.

The agent will walk you through MCP configuration, API keys, skill installation, and validation.

or set up manually

Add to your MCP config file:

{
  "mcpServers": {
    "tooluniverse": {
      "command": "uvx",
      "args": ["--refresh", "tooluniverse"],
      "env": {"PYTHONIOENCODING": "utf-8"}
    }
  }
}

--refresh checks PyPI for the newest release on every launch. Drop it ("args": ["tooluniverse"]) to start faster from uv's cache — then upgrade with uv cache clean tooluniverse.

Install agent skills:

npx skills add mims-harvard/ToolUniverse

Claude Code users — one line, no config file:

claude plugin marketplace add mims-harvard/ToolUniverse
claude plugin install tooluniverse@tooluniverse

Python developers — install the SDK. Install uv first and do not use system pip: on a current Mac, pip install tooluniverse fails with externally-managed-environment (PEP 668) and python3 -m venv can fail at ensurepip. uv manages its own Python and avoids both.

curl -LsSf https://astral.sh/uv/install.sh | sh   # if you don't have uv
uv venv --python 3.12 && source .venv/bin/activate
uv pip install tooluniverse

The base install covers the API and database tools. Local ML, cheminformatics, and plotting tools need extras — uv pip install 'tooluniverse[all]', or a single group such as [ml], [visualization], [bioinformatics]. Note [all] excludes pdf, singlecell, smolagents, client, and build, which install by name. Run tooluniverse-doctor to see which groups are missing.

tu CLI — discover, inspect, run, and test tools from the terminal. Python SDK — programmatic access for building AI scientist systems.

Building AI Scientists with ToolUniverse

Click to watch the demo (YouTube) (Bilibili)

What is ToolUniverse?

ToolUniverse is an ecosystem for creating AI scientist systems from any large language model. Powered by the AI-Tool Interaction Protocol, it standardizes how LLMs identify and call tools, integrating more than 1000 machine learning models, datasets, APIs, and scientific packages for data analysis, knowledge retrieval, and experimental design.

Key features:

  • AI-Tool Interaction Protocol: Standardized interface governing how AI scientists issue tool requests and receive results
  • Universal AI Model Support: Works with Claude, GPT, Gemini, Qwen, Deepseek, and open models
  • MCP Integration: Native Model Context Protocol server with configurable transport and tool selection
  • Async Operations: Long-running tasks (protein docking, molecular simulations) with progress tracking and parallel execution
  • Tool Composition: Chain tools for sequential or parallel execution in self-directed workflows
  • Compact Mode: Reduces 1000+ tools to 4-5 core discovery tools, saving ~99% context window
  • CLI (tu): Discover, inspect, run, and test tools directly from the terminal — 9 subcommands for interactive and scripted workflows
  • Agent Skills: 68 pre-built research workflows for drug discovery, precision oncology, rare disease diagnosis, pharmacovigilance, and more
  • Literature Search: Unified search across PubMed, Semantic Scholar, ArXiv, BioRxiv, Europe PMC, and more
  • Two-Tier Result Caching: In-memory LRU + SQLite persistence with per-tool fingerprinting for 10x speedup, offline support, and reproducibility
  • Continuous Expansion: Register new tools locally or remotely without additional configuration

AI Scientists Powered by ToolUniverse

Building your project with ToolUniverse? Submit via GitHub Pull Request or contact us.

TxAgent: AI Agent for Therapeutic Reasoning [Project] [Paper] [PyPI] [GitHub] [HuggingFace]

TxAgent leverages ToolUniverse's scientific tool ecosystem to solve complex therapeutic reasoning tasks.


Medea: An Omics AI Agent for Therapeutic Discovery [Project] [Paper] [GitHub]

Medea integrates ToolUniverse tools for multi-omics analysis to identify therapeutic targets and predict drug responses across cancer, autoimmune, and other diseases.

Documentation

Full documentation: zitniklab.hms.harvard.edu/ToolUniverse

Community

Shanghua Gao, the lead creator of this project, is currently on the job market.

Slack · GitHub Issues · Shanghua Gao · Marinka Zitnik

Leaders: Shanghua Gao · Marinka Zitnik

Contributors: Shanghua Gao · Richard Zhu · Pengwei Sui · Zhenglun Kong · Sufian Aldogom · Yepeng Huang · Ayush Noori · Reza Shamji · Krishna Parvataneni · Theodoros Tsiligkaridis · Marinka Zitnik

Citation

@article{gao2025democratizingaiscientistsusing,
      title={Democratizing AI scientists using ToolUniverse}, 
      author={Shanghua Gao and Richard Zhu and Pengwei Sui and Zhenglun Kong and Sufian Aldogom and Yepeng Huang and Ayush Noori and Reza Shamji and Krishna Parvataneni and Theodoros Tsiligkaridis and Marinka Zitnik},
      year={2025},
      eprint={2509.23426},
      archivePrefix={arXiv},
      primaryClass={cs.AI},
      url={https://arxiv.org/abs/2509.23426}, 
}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tooluniverse-1.4.1.tar.gz (5.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tooluniverse-1.4.1-py3-none-any.whl (7.9 MB view details)

Uploaded Python 3

File details

Details for the file tooluniverse-1.4.1.tar.gz.

File metadata

  • Download URL: tooluniverse-1.4.1.tar.gz
  • Upload date:
  • Size: 5.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tooluniverse-1.4.1.tar.gz
Algorithm Hash digest
SHA256 a46f2ee1f02ceaf832951e8996500908722a6a472b6543e9e7da29489492c51d
MD5 e75ae883b640341b46c6c7e7ce669547
BLAKE2b-256 f186f88778e9d4ddd871f5812437285563295085aaff11420c686c9bdb6052e4

See more details on using hashes here.

File details

Details for the file tooluniverse-1.4.1-py3-none-any.whl.

File metadata

  • Download URL: tooluniverse-1.4.1-py3-none-any.whl
  • Upload date:
  • Size: 7.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tooluniverse-1.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7a09a88ce493dbd1411cd467464fe48dd84b16a05a94de9a469b6097c320fd3a
MD5 7d42ecbe65908d45f986034466805258
BLAKE2b-256 ffca72e6639f0b5ccb1bac25b6f19b17712e608562f3c3c1677ce2b15114cacf

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page