{/* Auto-generated by scripts/generate_mcp_docs.py; do not edit by hand. */}

<ResponseField name="Workspaces" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="workspaces_list_workspaces" type="tool">
  List all workspaces accessible to the authenticated user.

  Returns a JSON array of workspace objects with id, name, and role.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Workflows" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="workflows_create_workflow" type="tool">
  Create a new workflow in a workspace.
    </ResponseField>
    <ResponseField name="workflows_get_workflow" type="tool">
  Get metadata for a specific workflow.
    </ResponseField>
    <ResponseField name="workflows_edit_workflow" type="tool">
  Edit a draft workflow using RFC 6902 JSON Patch.
    </ResponseField>
    <ResponseField name="workflows_update_workflow" type="tool">
  Update workflow metadata and optional inline YAML.
    </ResponseField>
    <ResponseField name="workflows_list_workflows" type="tool">
  List workflows in a workspace.
    </ResponseField>
    <ResponseField name="workflows_list_workflow_tree" type="tool">
  List workflow folders and workflows under a path.
    </ResponseField>
    <ResponseField name="workflows_create_workflow_folder" type="tool">
  Create a workflow folder by absolute path.
    </ResponseField>
    <ResponseField name="workflows_move_workflows" type="tool">
  Move workflows into or out of a folder.

  This tool is best-effort and non-atomic. If one workflow fails to move, the remaining workflow moves still proceed.
    </ResponseField>
    <ResponseField name="workflows_list_actions" type="tool">
  Search or browse available actions and return compact context metadata.

  Supports three usage modes:
  -> **Search**: provide `query` to search by name/description across all namespaces. Example: list_actions(workspace_id, query="send message")
  -> **Browse namespace**: provide `namespace` without `query` to list all actions in a namespace. Example: list_actions(workspace_id, namespace="core")
  -> **Browse all**: omit both to list all available actions.

  Common namespaces: `core`, `tools`, `ai`.
    </ResponseField>
    <ResponseField name="workflows_sync_custom_registry" type="tool">
  Sync the organization's custom action registry from its remote git repository.

  Pulls the latest code from the custom registry repo registered in the caller's organization, builds a versioned tarball, and makes the synced actions available to agents and workflows. Use this after pushing changes to the custom integrations repo, or to roll forward/back to a specific commit. Existing published workflows must be republished to pick up newly synced action versions.
    </ResponseField>
    <ResponseField name="workflows_get_action_context" type="tool">
  Get full schema and configuration context for a single action.

  Use this after discovering an action via `list_actions` to get the complete parameter schema needed to write the `args:` block in a workflow definition.

  Example action names: "core.http_request", "core.script.run_python", "core.transform.reshape".
    </ResponseField>
    <ResponseField name="workflows_get_workflow_authoring_context" type="tool">
  Get compact workflow authoring context for selected actions.

  Returns everything needed to write a workflow definition: action schemas, available secrets, and workspace variables. Use this before calling `create_workflow` or `update_workflow`.

  Two input modes (provide one or neither):
  -> **By name**: pass `actions` with an `action_names` list.
  -> **By search**: pass `query` to search for actions by name/description
    </ResponseField>
    <ResponseField name="workflows_validate_workflow" type="tool">
  Validate a workflow's draft state.

  Checks that the workflow DSL is structurally sound and that arguments are valid.
    </ResponseField>
    <ResponseField name="workflows_prepare_template_file_upload" type="tool">
  Prepare a staged template YAML upload for remote `/mcp` clients.
    </ResponseField>
    <ResponseField name="workflows_validate_template_action" type="tool">
  Validate a template action YAML file.

  Validates YAML parsing, template schema correctness, step action references, argument schemas, and expression references.
    </ResponseField>
    <ResponseField name="workflows_publish_workflow" type="tool">
  Publish (commit) a workflow, creating a new versioned definition.

  This validates the workflow, freezes registry dependencies, and creates a new workflow definition version.
    </ResponseField>
    <ResponseField name="workflows_run_draft_workflow" type="tool">
  Run a workflow from its current draft state (without publishing).

  Optionally update the workflow's title/description before running.
    </ResponseField>
    <ResponseField name="workflows_run_published_workflow" type="tool">
  Run the latest published version of a workflow.

  The workflow must have been published (committed) at least once.
    </ResponseField>
    <ResponseField name="workflows_list_workflow_executions" type="tool">
  List recent executions for a workflow.

  Use this to see run history, check which runs succeeded or failed, and find execution IDs for deeper inspection with get_workflow_execution.
    </ResponseField>
    <ResponseField name="workflows_get_workflow_execution" type="tool">
  Get status and details of a specific workflow execution.

  Returns execution metadata (status, timing) and a compact event timeline showing each action's status, timing, and any errors. Use this to debug failed runs or check the progress of running workflows.
    </ResponseField>
    <ResponseField name="workflows_get_webhook" type="tool">
  Get webhook configuration for a workflow.
    </ResponseField>
    <ResponseField name="workflows_update_webhook" type="tool">
  Update webhook configuration for a workflow.
    </ResponseField>
    <ResponseField name="workflows_get_case_trigger" type="tool">
  Get case trigger configuration for a workflow.
    </ResponseField>
    <ResponseField name="workflows_update_case_trigger" type="tool">
  Update an existing case trigger for a workflow.
    </ResponseField>
    <ResponseField name="workflows_list_workflow_tags" type="tool">
  List workflow tag definitions in a workspace.

  Returns a JSON array of tag objects with `id`, `name`, `ref`, and `color`.
    </ResponseField>
    <ResponseField name="workflows_create_workflow_tag" type="tool">
  Create a workflow tag definition.
    </ResponseField>
    <ResponseField name="workflows_update_workflow_tag" type="tool">
  Update a workflow tag definition.
    </ResponseField>
    <ResponseField name="workflows_delete_workflow_tag" type="tool">
  Delete a workflow tag definition.
    </ResponseField>
    <ResponseField name="workflows_list_tags_for_workflow" type="tool">
  List tags attached to a workflow.

  Returns a JSON array of tag objects with `id`, `name`, `ref`, and `color`.
    </ResponseField>
    <ResponseField name="workflows_add_workflow_tag" type="tool">
  Attach an existing workflow tag definition to a workflow.
    </ResponseField>
    <ResponseField name="workflows_remove_workflow_tag" type="tool">
  Remove a workflow tag association from a workflow.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Cases" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="cases_list_cases" type="tool">
  List cases in a workspace with default sorting.
    </ResponseField>
    <ResponseField name="cases_search_cases" type="tool">
  Search cases with filtering and sorting.
    </ResponseField>
    <ResponseField name="cases_get_case" type="tool">
  Get a specific case with full details including fields, tags, and description.
    </ResponseField>
    <ResponseField name="cases_create_case" type="tool">
  Create a new case.
    </ResponseField>
    <ResponseField name="cases_update_case" type="tool">
  Update a case. Only provided fields are changed.
    </ResponseField>
    <ResponseField name="cases_list_case_comments" type="tool">
  List all comments for a case.
    </ResponseField>
    <ResponseField name="cases_list_case_comment_threads" type="tool">
  List comment threads for a case. Each thread contains the root comment and its replies.
    </ResponseField>
    <ResponseField name="cases_create_case_comment" type="tool">
  Create a new comment on a case. Provide ``parent_id`` to reply to an existing comment.
    </ResponseField>
    <ResponseField name="cases_update_case_comment" type="tool">
  Update an existing comment on a case.
    </ResponseField>
    <ResponseField name="cases_delete_case_comment" type="tool">
  Delete a comment from a case.
    </ResponseField>
    <ResponseField name="cases_list_case_tasks" type="tool">
  List all tasks for a case.
    </ResponseField>
    <ResponseField name="cases_get_case_task" type="tool">
  Get a specific case task by ID.
    </ResponseField>
    <ResponseField name="cases_create_case_task" type="tool">
  Create a new task on a case.
    </ResponseField>
    <ResponseField name="cases_update_case_task" type="tool">
  Update a case task. Only provided fields are changed.
    </ResponseField>
    <ResponseField name="cases_run_case_task" type="tool">
  Run the workflow associated with a case task.

  Fetches the task's ``workflow_id`` and ``default_trigger_values``, merges them with ``case_id`` and ``task_id`` context (plus any caller-supplied overrides), then executes the latest published version of the workflow.
    </ResponseField>
    <ResponseField name="cases_list_case_events" type="tool">
  List activity events for a case. Events are system-generated audit entries that track every change to a case — status changes, priority changes, assignee changes, comments, tasks, tags, field changes, etc.
    </ResponseField>
    <ResponseField name="cases_list_case_tags" type="tool">
  List case tag definitions in a workspace.

  Returns a JSON array of tag objects with `id`, `name`, `ref`, and `color`.
    </ResponseField>
    <ResponseField name="cases_create_case_tag" type="tool">
  Create a case tag definition.
    </ResponseField>
    <ResponseField name="cases_update_case_tag" type="tool">
  Update a case tag definition.
    </ResponseField>
    <ResponseField name="cases_delete_case_tag" type="tool">
  Delete a case tag definition.
    </ResponseField>
    <ResponseField name="cases_list_tags_for_case" type="tool">
  List tags attached to a case.

  Returns a JSON array of tag objects with `id`, `name`, `ref`, and `color`.
    </ResponseField>
    <ResponseField name="cases_add_case_tag" type="tool">
  Attach a case tag to a case.
    </ResponseField>
    <ResponseField name="cases_remove_case_tag" type="tool">
  Remove a case tag association from a case.
    </ResponseField>
    <ResponseField name="cases_list_case_fields" type="tool">
  List case field definitions in a workspace.

  Returns a JSON array of field objects with `id`, `type`, `description`, `nullable`, `default`, `reserved`, `options`, and optional `kind`.
    </ResponseField>
    <ResponseField name="cases_create_case_field" type="tool">
  Create a case field definition.

  Supports optional create-only `kind`: `LONG_TEXT` requires `type="TEXT"` and `URL` requires `type="JSONB"`.
    </ResponseField>
    <ResponseField name="cases_update_case_field" type="tool">
  Update a case field definition.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Tables" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="tables_list_tables" type="tool">
  List workspace tables.
    </ResponseField>
    <ResponseField name="tables_create_table" type="tool">
  Create a table with optional columns.
    </ResponseField>
    <ResponseField name="tables_get_table" type="tool">
  Get table definition and index metadata.
    </ResponseField>
    <ResponseField name="tables_update_table" type="tool">
  Update table metadata.
    </ResponseField>
    <ResponseField name="tables_insert_table_row" type="tool">
  Insert a table row.
    </ResponseField>
    <ResponseField name="tables_update_table_row" type="tool">
  Update a table row.
    </ResponseField>
    <ResponseField name="tables_search_table_rows" type="tool">
  Search rows in a table.
    </ResponseField>
    <ResponseField name="tables_export_csv" type="tool">
  Export table data as a staged download URL.
    </ResponseField>
    <ResponseField name="tables_create_column_index" type="tool">
  Create a unique index on a table column. Only one unique index per table is allowed.
    </ResponseField>
    <ResponseField name="tables_drop_column_index" type="tool">
  Drop the unique index on a table column.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Variables" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="variables_list_variables" type="tool">
  List workspace variables.
    </ResponseField>
    <ResponseField name="variables_get_variable" type="tool">
  Get a workspace variable.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Secrets" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="secrets_list_secrets_metadata" type="tool">
  List secret metadata without secret values.
    </ResponseField>
    <ResponseField name="secrets_get_secret_metadata" type="tool">
  Get secret metadata by name without secret values.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Integrations" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="integrations_list_integrations" type="tool">
  List workspace integrations useful for workflow and preset authoring.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="Agents" type="Namespace">
  <Expandable title="Tools">
    <ResponseField name="agents_get_agent_preset_authoring_context" type="tool">
  Get models, integrations, output_type guidance, and other preset authoring context.
    </ResponseField>
    <ResponseField name="agents_create_agent_preset" type="tool">
  Create an agent preset in the selected workspace.
    </ResponseField>
    <ResponseField name="agents_update_agent_preset" type="tool">
  Update an existing agent preset in the selected workspace.
    </ResponseField>
    <ResponseField name="agents_upload_skill" type="tool">
  Upload a local skill directory into Tracecat as a workspace skill.

  Agents should read the local directory themselves, preserve relative paths, include the root ``SKILL.md`` file, and pass every file in ``files`` using ``content_base64``.
    </ResponseField>
    <ResponseField name="agents_list_agent_presets" type="tool">
  List saved agent preset slugs and names.

  Use `get_agent_preset` for the full preset definition.
    </ResponseField>
    <ResponseField name="agents_get_agent_preset" type="tool">
  Get the full configuration for a saved agent preset by slug.
    </ResponseField>
    <ResponseField name="agents_run_agent_preset" type="tool">
  Run an agent preset with a prompt and return text or approval status.

  Creates an ephemeral session, triggers the agent workflow, and waits for the response. The agent has access to all tools configured on the preset.
    </ResponseField>
  </Expandable>
</ResponseField>
