Tool Catalog

Before you execute a tool, you need to discover what’s available. The catalog is how you browse toolkits and find the right tool slug — for example, finding that “send an email via Gmail” maps to GMAIL_SEND_EMAIL. Once you know the slug, you can bind it to an agent and execute it. The catalog is the set of tools available to your agents, organized into toolkits by provider. List toolkits, inspect individual tools, and discover what is available in a given scope.

Key concepts

Term	Meaning
Toolkit	A provider grouping of related tools (e.g. `GMAIL`).
Tool	A single callable action (e.g. `GMAIL_SEND_EMAIL`).
Slug	The `UPPER_CASE` identifier for a toolkit or tool.
Discovery	Listing tools available to an agent in a given scope.

Available toolkits

Toolkit	Provider
`GMAIL`	Google
`GOOGLE_SHEETS`	Google
`SLACK`	Slack
`GITHUB`	GitHub
`JIRA`	Atlassian
`WHATSAPP`	Meta

Browse the catalog

Python
curl

# List toolkits
toolkits = client.tools.list_toolkits()

# List tools in a toolkit
tools = client.tools.list_tools(toolkit="GMAIL")

# Get a single tool
tool = client.tools.get_tool("GMAIL_SEND_EMAIL")

# Discover tools available to an agent in scope
available = client.tools.discover_tools(scope="agent")

curl https://api.hexelstudio.com/tools/v1/toolkits \
  -H "Authorization: Bearer $TOKEN"

curl "https://api.hexelstudio.com/tools/v1/tools?toolkit=GMAIL" \
  -H "Authorization: Bearer $TOKEN"

curl "https://api.hexelstudio.com/tools/v1/tools/discover?scope=agent" \
  -H "Authorization: Bearer $TOKEN"

Tool lifecycle

Tools move through states so you can rely on stable behavior:

State	Meaning
`draft`	In development; not generally available.
`published`	Available for use.
`deprecated`	Still works, but slated for removal.
`retired`	No longer callable.

Errors

HTTP	`code`	When
`404`	—	The toolkit or tool slug doesn’t exist.
`400`	`INVALID_REQUEST`	Invalid `scope` on discover, or a malformed query.

Security

Concern	Detail
Scoping	Discovery is scoped to your organization, workspace, and environment.
Allow-lists	Tools excluded by a workspace group do not appear in discovery results.
Lifecycle	Pin to `published` tools in production. `deprecated` tools continue to work but have a removal date — migrate before they are retired.

Common mistakes

Hardcoding tool slugs without discovery. Use discover_tools to see what an agent can call in context.
Depending on deprecated tools. Migrate before a tool reaches retired.

Best practices

Discover tools by scope rather than assuming availability.
Pin to published tools for production workloads.
Watch the changelog for deprecation notices.

Connected Accounts

Authorize a provider before using its tools.

Bindings

Grant an agent access to a toolkit.

Executing Tools

Call a tool once you have found it.

Tools (concept)

The model behind the catalog.

Billing & Usage

Support

Key concepts

Available toolkits

Browse the catalog

Tool lifecycle

Errors

Security

Common mistakes

Best practices

Connected Accounts

Bindings

Executing Tools

Tools (concept)

​Key concepts

​Available toolkits

​Browse the catalog

​Tool lifecycle

​Errors

​Security

​Common mistakes

​Best practices

​Related pages

Connected Accounts

Bindings

Executing Tools

Tools (concept)

Key concepts

Available toolkits

Browse the catalog

Tool lifecycle

Errors

Security

Common mistakes

Best practices

Related pages