Compare commits

..
3 changed files with 35 additions and 123 deletions
@@ -1,8 +1,8 @@
---
lineage_type: import
upstream_source: https://github.com/mims-harvard/ToolUniverse/blob/e2520a96/skills/setup-tooluniverse/SKILL.md
upstream_sha: e2520a96
imported_at: 2026-06-26
upstream_source: https://github.com/mims-harvard/ToolUniverse/blob/7dace8a3/skills/setup-tooluniverse/SKILL.md
upstream_sha: 7dace8a3
imported_at: 2026-07-16
prompt_class: catalogue
upstream_changes: accepted
name: setup-tooluniverse
@@ -156,7 +156,7 @@ Make sure Step 2 is done (`uv --version` works).
> claude plugin marketplace add mims-harvard/ToolUniverse
> claude plugin install tooluniverse@tooluniverse
> ```
> This installs MCP server + 115 skills + slash commands in one step.
> This installs MCP server + 115 skills + slash commands in one step. Then see the `tooluniverse-claude-code-plugin` skill's "Recommended: turn on auto-update" step so future releases apply without manual `claude plugin update`.
| Client | File | How to Access |
|--------|------|---------------|
@@ -1,115 +0,0 @@
---
lineage_type: import
upstream_source: https://github.com/mims-harvard/ToolUniverse/blob/beea85fa/skills/tooluniverse-antigravity-plugin/SKILL.md
upstream_sha: beea85fa
imported_at: 2026-07-21
prompt_class: unknown
upstream_changes: accepted
name: tooluniverse-antigravity-plugin
description: Install, set up, verify, update, pin, uninstall, or troubleshoot the ToolUniverse plugin on Google Antigravity (AGY / Antigravity IDE / Antigravity 2.0). ALWAYS consult this skill for any of those — don't answer from memory, because the exact CLI name (agy), the "agy plugin install <path>" flow, the uvx tooluniverse MCP server, and the API-key env vars are easy to get wrong. Use it whenever someone wants to get ToolUniverse (or "the 1000+ scientific tools" / "the harvard tools") working on Antigravity, says the Antigravity plugin or its tools/skills won't load, hits a uvx or MCP-server startup error, asks how Antigravity updates it, wants to pin or remove it, or finds it running an old tool version. Not for the Codex plugin (use tooluniverse-codex-plugin) or Claude Code plugin (use tooluniverse-claude-code-plugin), for running research with the tools, or for authoring new tools or skills.
disable-model-invocation: true
---
# Install the ToolUniverse Plugin for Google Antigravity (AGY)
One-step install on Google Antigravity (AGY / Antigravity IDE / Antigravity 2.0): an MCP server exposing 1000+ scientific tools plus 120+ research skills — all auto-configured.
## Prerequisites (check once)
```bash
uv --version # provides `uvx`; if missing: curl -LsSf https://astral.sh/uv/install.sh | sh
agy --version # Antigravity CLI; if missing: https://antigravity.google
```
## Install
In Antigravity, plugins can be installed using the `agy` CLI:
### Option 1: Direct path / imported plugin install (recommended)
```bash
# If installed via Claude Code / Codex marketplace cache or cloned repo:
agy plugin install /path/to/ToolUniverse/plugin
```
### Option 2: Clone + install
```bash
git clone https://github.com/mims-harvard/ToolUniverse.git
cd ToolUniverse
agy plugin install ./plugin
```
Restart Antigravity. The MCP server auto-starts via `uvx tooluniverse` on first use (~30 s cold start while the package downloads, instant after).
## Verify it worked
```bash
agy plugin list
```
Expect output showing `tooluniverse` under `imports`:
```json
{
"imports": [
{
"name": "tooluniverse",
"source": "claude-code",
"components": [
"skills",
"agents",
"mcpServers",
"hooks",
"commands"
]
}
]
}
```
Inside Antigravity, just ask naturally:
```
What are the top mutated genes in breast cancer?
Research the drug metformin.
```
The research skills auto-activate on matching questions, and the MCP tools are discovered and run via `find_tools``execute_tool` — no command prefix needed.
## What you get
| Component | What it does | How it's used |
|---|---|---|
| **MCP server** | 1000+ tools via `find_tools`, `get_tool_info`, `execute_tool` | Auto-loaded; no action needed |
| **120+ skills** | Structured research workflows (drug discovery, variant interpretation, pharmacovigilance, phylogenetics, statistical modeling, etc.) | Auto-activate on matching questions |
| **Research agent** | Autonomous multi-database research subagent | Auto-routed on complex research tasks |
## API keys (optional, but recommended)
Most tools work without keys. For higher rate limits or gated databases, set the keys you care about in `~/.gemini/config/plugins/tooluniverse/mcp_config.json` or pass them in environment variables:
```bash
export NCBI_API_KEY="your_key"
export ONCOKB_API_TOKEN="your_token"
export SEMANTIC_SCHOLAR_API_KEY="your_key"
```
## Update
```bash
uv cache clean tooluniverse
```
Restart Antigravity.
## Troubleshooting
| Symptom | Fix |
|---|---|
| `uvx: command not found` | Install `uv` (see Prerequisites), reopen terminal. |
| MCP server won't start | Run `uv cache clean tooluniverse` or `uvx --refresh tooluniverse --help` in terminal. |
| Plugin installs but tools missing | Restart Antigravity CLI/IDE. First launch downloads the package (~30 s). |
| `requires-python >= 3.10` | `uv python install 3.12` |
Still stuck: https://github.com/mims-harvard/ToolUniverse/issues
@@ -1,8 +1,8 @@
---
lineage_type: import
upstream_source: https://github.com/mims-harvard/ToolUniverse/blob/e2520a96/skills/tooluniverse-claude-code-plugin/SKILL.md
upstream_sha: e2520a96
imported_at: 2026-06-26
upstream_source: https://github.com/mims-harvard/ToolUniverse/blob/7dace8a3/skills/tooluniverse-claude-code-plugin/SKILL.md
upstream_sha: 7dace8a3
imported_at: 2026-07-16
prompt_class: catalogue
upstream_changes: accepted
name: tooluniverse-claude-code-plugin
@@ -21,7 +21,7 @@ uv --version # must exist; if not: curl -LsSf https://astral.sh/uv/install
claude --version # Claude Code CLI; if not: https://claude.com/claude-code
```
## Install (two commands)
## Install
```bash
# 1. Register the ToolUniverse marketplace from GitHub
@@ -33,6 +33,29 @@ claude plugin install tooluniverse@tooluniverse
That's it. Restart Claude Code. The MCP server auto-starts via `uvx tooluniverse` on first use (~30 s cold start, instant after).
### Recommended: turn on auto-update
Third-party marketplaces default to **no auto-update** — without this, new tools/skills only reach you when you remember to run `claude plugin update tooluniverse` (see Update below). Turn it on once:
```bash
python3 -c "
import json, pathlib, sys
p = pathlib.Path.home() / '.claude/plugins/known_marketplaces.json'
d = json.loads(p.read_text())
if 'tooluniverse' not in d:
sys.exit('Run the marketplace add command above first')
d['tooluniverse']['autoUpdate'] = True
p.write_text(json.dumps(d, indent=2))
print('autoUpdate enabled for tooluniverse')
"
```
Equivalent interactive path: `/plugin` → Marketplaces → `tooluniverse` → Enable auto-update.
With this on, Claude Code checks for marketplace + plugin updates in the background after each session start (up to a ~10 min random delay) and updates the installed plugin on disk automatically. You'll get a `/reload-plugins` prompt when an update lands, or it applies on your next launch — no more manual `claude plugin update`.
This is local, per-machine state — it can't be shipped as a default from the plugin's own manifest. `marketplace.json` has no `autoUpdate` field; Claude Code intentionally keeps this a per-installation trust boundary so a publisher can't force silent auto-updates onto a user's machine.
### Important: Remove global skills if previously installed
If you previously installed ToolUniverse skills globally (via `tooluniverse-install-skills` or manual copy), **remove them**. The plugin includes all skills — global copies interfere with the plugin's skill routing.
@@ -121,6 +144,10 @@ Full API-key list: `setup-tooluniverse` skill → `API_KEYS_REFERENCE.md`.
## Update
If you enabled auto-update above, this happens automatically in the background — no action needed.
Otherwise, update manually:
```bash
claude plugin update tooluniverse
# Also refresh the MCP server's tool cache: