tu — ToolUniverse CLI¶

tu is the command-line interface for ToolUniverse. It mirrors the compact-mode MCP tools so you can discover and call tools directly from your shell.

tu <command> [options]

Output is human-readable by default. Add --json for pretty JSON or --raw for compact JSON (pipe-friendly).

—

Commands¶

list¶

List available tools. Default view shows category counts; add --categories to list tools within a category.

tu list                               # category overview
tu list --categories uniprot          # tools in a category
tu list --mode basic --limit 20       # names + descriptions
tu list --mode custom --fields name type category

Modes: names, categories (default), basic, by_category, summary, custom

grep¶

Search tools by text or regex.

tu grep protein                       # substring search in names
tu grep protein --field description
tu grep '^UniProt' --mode regex

Fields: name (default), description, type, category

find¶

Find tools by natural-language query (keyword scoring, no API key needed).

tu find 'protein structure analysis'
tu find 'search for drug targets' --limit 5
tu find 'gene expression' --categories GTEx ENCODE

info¶

Show the schema for one or more tools.

tu info UniProt_get_entry_by_accession
tu info UniProt_get_entry_by_accession --detail brief
tu info UniProt_get_entry_by_accession ChEMBL_get_molecule

run¶

Execute a tool. Arguments can be key=value pairs or a JSON string.

tu run UniProt_get_entry_by_accession accession=P12345
tu run list_tools '{"mode": "categories"}'

test¶

Test a tool with example inputs and report pass/fail.

tu test Dryad_search_datasets              # use built-in example inputs
tu test MyAPI_search '{"q": "test"}'       # custom input

status¶

Show how many tools are loaded and the top categories.

tu status

build¶

Regenerate the static tool registry and coding-API wrapper files. Output defaults to .tooluniverse/coding_api/; use --output to override.

tu build
tu build --output ./my_tools

serve¶

Start the MCP stdio server (equivalent to running tooluniverse).

tu serve

—