> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Available tools

> The tools the Noxus MCP server exposes, grouped by domain

The server advertises its full tool list on connect, so you rarely need to name tools yourself — the model picks them. This page is a reference for what's available and how access is gated. Tool names and schemas may evolve; the live `tools/list` from your connection is always authoritative.

<Info>
  Every tool runs **as your API key**, in its workspace. A tool the key lacks
  permission for is refused — see [Permissions](#permissions).
</Info>

## Workflows

Build, version, and run flows.

* **Manage** — `workflows_list`, `workflows_get`, `workflows_update`, `workflows_delete`, `workflows_list_versions`, `workflows_save_version`
* **Run** — `workflows_run`, `workflows_run_partial`, `workflows_list_runs`
* **Author (node graph)** — `workflows_build`, `workflows_get_state`, `workflows_edit_nodes`, `workflows_add_node`, `workflows_link_nodes`, `workflows_remove_node`, `workflows_validate`, `workflows_autolayout`, `workflows_create_trigger`, `workflows_list_variables`
* **Node catalog** — `workflows_get_node_schemas`, `workflows_search_nodes`, `workflows_get_node_outputs`

## Runs

Inspect executions.

* `runs_list`, `runs_get`, `runs_get_status`, `runs_wait`, `runs_inspect`, `runs_get_node`

## Agents (co-workers)

* `agents_list`, `agents_get`, `agents_create`, `agents_update`, `agents_delete`
* `agents_list_triggers`, `agents_add_trigger`

## Conversations

Chat with an agent and read history.

* `conversations_list`, `conversations_get`, `conversations_create`, `conversations_update`, `conversations_delete`
* `conversations_chat`, `conversations_get_messages`, `conversations_inspect_messages`

## Knowledge bases

Manage KBs and their documents, and retrieve from them.

* **Manage** — `knowledge_bases_list`, `knowledge_bases_get`, `knowledge_bases_create`, `knowledge_bases_delete`
* **Documents** — `knowledge_bases_upload_documents`, `knowledge_bases_list_documents`, `knowledge_bases_get_document`, `knowledge_bases_delete_document`, `knowledge_bases_export_documents`, `knowledge_bases_get_runs`, `knowledge_bases_get_tree`, `knowledge_bases_list_folder`
* **Search** — `knowledge_bases_search`, `knowledge_bases_search_documents`

## Data tables

Structured rows + read-only SQL.

* **Schema** — `tables_list`, `tables_get_schema`, `tables_create`, `tables_add_column`
* **Rows** — `tables_get_rows`, `tables_insert_rows`, `tables_update_rows`, `tables_delete_rows`
* **Query** — `tables_query` (read-only SQL across the workspace's tables)

## Sandboxes

Ephemeral code-execution environments.

* `sandboxes_create`, `sandboxes_list`, `sandboxes_get`, `sandboxes_delete`
* `sandboxes_run_command`, `sandboxes_write_file`, `sandboxes_read_file`

## Deployments (channels)

Publish an agent to a channel.

* `deployments_list_channels`, `deployments_list`, `deployments_get`, `deployments_create`, `deployments_activate`, `deployments_deactivate`, `deployments_delete`

## Files

* `files_upload`, `files_download`

## Workspaces & admin

* `workspaces_list`
* `admin_get_me`, `admin_list_workspaces`, `admin_create_workspace`

## Documentation

Let the model look things up in the Noxus docs.

* `documentation_list_sections`, `documentation_read`, `documentation_search`

## Permissions

Tools are gated by the **permissions of the API key** you connected with — identical to the REST API. A few consequences worth knowing:

* A **read-only** key can list/read/search but can't create, edit, or delete.
* Running code in a sandbox requires the **`sandboxes:run`** permission (it is never implied by general resource access).
* Tenant-wide actions (creating workspaces, managing users) require a **system API key** — an ordinary workspace key can't perform them.

If a tool is refused, the connected key is missing that permission — mint a key with the needed scope, or use a key from a workspace where you have the role. See [Authentication](/sdk/concepts/authentication).