Skip to main content

Toolsets

A Toolset is a named, reusable collection of Tools. Instead of attaching ten individual tools to every agent that needs them, you create a toolset once — "Research Stack", "Dev Utilities", "Data Pipeline" — and attach the whole set in a single click. Every agent that uses the toolset automatically gets any tools you add to it later.

Core concepts

Toolset

A team-scoped collection of tools with a name and optional description. Toolsets are versioned — adding or removing a tool from a toolset takes effect immediately for all agents that use it.

agent_toolset pivot

Agents reference toolsets via the agent_toolset pivot table. At execution time, ResolveAgentToolsAction expands all attached toolsets into the flat tool list the agent actually uses.

Semantic tool selection

When an agent has more than 15 active tools, FleetQ automatically narrows the tool list using pgvector cosine similarity (>0.75) against the current task description — so the LLM receives only the most relevant tools for each step.

Priority & overrides

Each toolset attachment can carry per-agent credential overrides, so the same "GitHub" toolset can use a different token for different agents without duplicating the toolset.

Typical workflow

  1. Create a toolset — go to /toolsets/create, give it a name, and add tools from your library.
  2. Attach to agents — open any agent and select the toolset under Tools. One click replaces manual tool-by-tool wiring.
  3. Update once, applies everywhere — add a new tool to the toolset and every agent using it picks it up automatically on the next run.

MCP tools

Tool Description
toolset_list List all toolsets for the team.
toolset_get Get details of a specific toolset including its tool members.
toolset_create Create a new toolset with a name, description, and initial tool IDs.
toolset_update Update toolset name, description, or tool membership.
toolset_delete Delete a toolset (does not delete the underlying tools).

Related concepts

  • Tools — the individual MCP and built-in tools that make up a toolset.
  • Agents — attach toolsets on the agent detail page under Tools.
  • Credentials — per-agent credential overrides on toolset attachments.