Skip to main content

​
Tools & Toolsets

Tools are functions that extend the agent’s capabilities, organized into logical toolsets that can be enabled or disabled per platform and per specialist. Headmaster ships with a broad built-in tool registry — over 60 tools across 10+ categories.

​
Available tool categories

​
Enabling and disabling tools

1

Open the specialist

Go to Settings → Specialists and pick a specialist.
2

Toggle toolsets

Go to the Tools section and check/uncheck toolsets.
3

Save

A toolset toggled off is not loaded — the agent won’t see or try to use those tools.

​
Using tools from chat

You don’t need to explicitly call tools — the agent picks the right tool based on your request:
→ Agent uses web_search and web_extract.
→ Agent uses terminal.
→ Agent uses browser_navigate and browser_vision.
→ Agent uses image_generate.

​
Tool call display

Every tool call appears in the chat as an expandable block:
Click to expand and see the full tool input and output. This is your audit trail — every tool call is logged.

​
execute_code — programmatic tool calling

The execute_code tool lets the agent run Python scripts that call other Headmaster tools programmatically. This collapses multi-step pipelines into a single inference call. Instead of the agent calling web_search 5 times in sequence, it can write a Python script that calls web_search 5 times in a loop, processes the results, and returns a single summary — faster, cheaper, and more reliable. Example:
The agent writes a Python script that calls web_search for each framework, web_extract on each result, parses the content, builds a comparison table — all in one tool call instead of 10+.

​
mixture_of_agents — collaborative reasoning

The mixture_of_agents tool routes a hard problem through multiple frontier LLMs collaboratively. It makes 5 API calls (4 reference models + 1 aggregator) with maximum reasoning effort. Use it for:
  • Complex math or algorithms.
  • Multi-step analytical reasoning.
  • Problems that benefit from diverse perspectives.
The agent decides when to use it — you don’t need to explicitly request it. It’s used sparingly because it’s expensive (5 API calls per use).

​
Bundled tools

Some tools — web search, image generation, text-to-speech, and browser automation — can be enabled with a single bundled configuration instead of separate API keys for each service. When the bundle is configured:
  • Web search works out of the box — no Firecrawl or SerpAPI key needed.
  • Image generation works — no separate FAL or OpenAI images key needed.
  • Text-to-speech works — no OpenAI TTS key needed.
  • Browser automation works — no separate browser service needed.

​
Tool configuration reference

Terminal Backends

Local, Docker, SSH, Singularity, Modal, and Daytona.

Browser

Full browser automation details.

Image Generation

Full image generation setup guide.

Connections (MCP)

Extend tools with MCP servers.