Tools registry
List and inspect available AI tools with full parameter schemas
These endpoints list the tools a session can run and return each one's parameter schema and plan tier. Reach for them when you're building a UI that offers tools to pick from, validating input, or deciding what a session should be allowed to call. The tools you discover here are the same ones the model invokes during a turn in Message execution.
Tools Registry
GET /api/v1/tools lists the tools a session can call; GET /api/v1/tools/:name returns one tool's parameter schema.
With a key, GET /api/v1/tools (reference) returns the catalogue: each tool's name, display_name, category, a one-line description, tier and requires_gpu. It has no parameter schemas; read those one tool at a time. Without a key both routes return 401.
Get Tool Schema
GET /api/v1/tools/:name returns one tool's definition, including its parameter schema (reference).
Tool Categories
category values come from the tool definitions, for example database, bioinformatics, omics, literature, structure, docking, admet, design and synthesis. Read the category field of the catalogue for the full set rather than hard-coding it, and filter on it client-side.
For the job-based compute tools, see Job Types Catalog.
Read next
- Job Types Catalog — searchable catalog of available tools
- Sessions overview — how the sessions API works
- REST Jobs — submit jobs directly via REST
Was this page helpful?