The Tools registry
The Agent Tools registry is where every tool in your project lives. By the end of this page you will know how to find any tool and read its status at a glance.
Prerequisites
- A project created (Create your first project).
- Owner, Admin, or Developer role.
Open the registry
In your project sidebar, expand Agentic Workspace and click Tools. You land on the Agent Tools page.
The page has two top-level tabs, each with a live count:
- Tools — System and Project tools.
- MCP Servers — external servers you’ve connected.
The button in the top-right changes with the active tab: Create Tool on the Tools tab, Add MCP Server on the MCP Servers tab (see MCP servers).
Filter the Tools tab
The Tools tab gives you several ways to narrow the list.
| Control | What it does |
|---|---|
| Search tools… | Filters by name or tool key as you type. |
| All / System / Project | Scope sub-tabs. Each shows a count. |
| Category | Filter by Function, Data Pull, or Action (or All Categories). |
| Ready only | Show only tools whose configuration status is Ready. The toggle shows how many that is. |
Read a tool card
Each tool appears as a card. The badges tell you everything you need before opening it.
- Display name and tool key (the tool key is shown in monospace).
- Configuration status — Ready, Config Required, or Config Missing (see Configuration & secrets).
- System badge — marks a built-in tool. Project tools instead show a lifecycle badge (Draft, Published, or Deprecated).
- Category badge — hover for its meaning:
- Function — “Pure computation, cacheable”
- Data Pull — “Read-only data fetch, TTL cached”
- Action — “Side-effect operation, never cached”
- Classification badge — the tool’s data sensitivity (Public / Internal / Confidential / Restricted).
- HIL badge — present when the tool “Requires Human-in-the-Loop approval.”
- Latest: v{n} — the latest version of the tool.
The registry card shows only the everyday lifecycle states — Draft, Published, Deprecated. The full lifecycle (which also includes Ready for Review and Archived) is managed from a published tool’s lifecycle controls.
Empty states
If a filter matches nothing, the Tools tab shows No tools found with a hint to adjust your search or filter. When ready-only is active, a Show all tools button clears it. On a fresh project, you’ll be prompted to Create your first custom tool for this project.
System vs Project tools
The About Agent Tools box on the Tools tab sums it up:
System tools are built-in capabilities provided by qRaptor (calculator, datetime, etc.). Project tools are custom tools you create for your specific use cases. Tools can be assigned to agents to extend their capabilities.
For the full list of built-in tools, see Built-in tools.
Common issues
- A tool shows Config Required — it needs a configuration value. Open the tool to see which one, then add it under Configuration → Integrations.
- A tool isn’t available to agents — only Published tools can be used. Check its lifecycle badge.
- Can’t find a built-in tool — switch the scope sub-tab to System, or clear the category filter.