Skip to main content
Glama
sam-david

unreal-mcp

by sam-david

unreal-mcp

The most comprehensive MCP server for Unreal Engine — 127 tools across 16 subsystems, with 4 transport layers and no mandatory C++ plugin.

Beta — This project is under active development and testing. Tools are being validated against UE 5.6. Some tools may not work as expected. Bug reports and contributions are welcome.

Why This One?

unreal-mcp

flopperam

chongdashu

kvick-games

ChiR24

Tools

127

~30

~20

~5

36

Transports

4

1

1

1

1

Requires C++ plugin

No

Yes

Yes

Yes

Yes

Build/package tools

Yes

No

No

No

Partial

Most Unreal MCP projects require compiling and installing a custom C++ plugin into your UE project. This one works out of the box by using Unreal's built-in Python and Remote Control plugins — zero-install beyond enabling what already ships with UE.

Related MCP server: UE-MCP

Quick Start

Prerequisites

  • Node.js >= 18

  • Unreal Engine 5.x with editor open

  • Python Editor Script Plugin enabled (built-in) with Enable Remote Execution checked in its settings

Install

git clone https://github.com/YOUR_USERNAME/unreal-mcp.git
cd unreal-mcp
npm install
npm run build

Add to Claude Code

Per-project (from your UE project directory):

claude mcp add --transport stdio unreal-mcp -- node /path/to/unreal-mcp/dist/bin.js

Global (available in all projects):

claude mcp add --scope user --transport stdio unreal-mcp -- node /path/to/unreal-mcp/dist/bin.js

Then drop a .unrealmcp.json in each UE project:

{
  "projectPath": "."
}

Add to Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "unreal": {
      "command": "node",
      "args": ["/path/to/unreal-mcp/dist/bin.js"],
      "env": {
        "UNREAL_MCP_PROJECT_PATH": "/path/to/YourProject.uproject"
      }
    }
  }
}

Tool Modules

Module

Tools

Description

actor

10

Spawn, delete, transform, select, duplicate, tag actors

asset

16

List, search, import, export, rename, delete, validate assets

blueprint

12

Create blueprints, add components/variables/functions, graph nodes

build

9

Build targets, cook content, package, generate project files

material

13

Create materials/instances, add expressions, wire graphs

console

6

Execute Python, console commands, screenshots, viewport camera

sequencer

8

Create sequences, add tracks/bindings, set playback range

animation

6

Animation blueprints, montages, modifiers, skeletal mesh

niagara

8

Spawn particle systems, set parameters (float/vector/color/bool)

editor-utils

8

Undo/redo, LOD generation, collision, lightmap UVs, utility widgets

testing

8

Automation tests, map check, data validation, Gauntlet

profiling

5

CSV profiling, Unreal Insights traces, stat commands

source-control

6

Status, checkout, checkin, revert, mark for add, diff

world-partition

4

Data layers, streaming sources, loaded cells

remote-control-presets

5

List/get/set preset properties, call preset functions

plugin

3

List, enable, disable plugins in .uproject

Architecture

MCP Client (Claude Code, Claude Desktop, etc.)
  ↕ stdio (MCP protocol)
unreal-mcp server
  ↕ 4 transport layers
Unreal Engine

Transport Layers

Transport

Protocol

Port

What It Needs

Python Remote Execution

UDP multicast + inverted TCP

6776

Python Editor Script Plugin (built-in)

Remote Control API

HTTP REST

30010

Remote Control API plugin (built-in)

Plugin Bridge

TCP, length-prefixed JSON

55557

Optional C++ plugin

Subprocess Runner

Spawns UAT/UBT processes

N/A

Engine path only

The server probes all transports on startup and tools gracefully degrade. Most tools use Python Remote Execution. Build tools use subprocess. The optional C++ plugin adds deep Blueprint graph manipulation.

Two Paths

  • Core path (no plugin): Python + Remote Control covers ~95% of tools. Just enable the built-in UE plugins.

  • Plugin path (optional): C++ plugin on port 55557 adds K2 node graph manipulation, faster bulk operations, and editor UI integration. Falls back to Python automatically when unavailable.

Configuration

Three-layer priority: CLI args > environment variables > config file > defaults.

Environment Variables

Variable

Default

Description

UNREAL_MCP_PROJECT_PATH

Path to .uproject file or project directory

UNREAL_MCP_ENGINE_PATH

auto-detect

UE engine install path

UNREAL_MCP_RC_PORT

30010

Remote Control API port

UNREAL_MCP_PYTHON_PORT

6776

Python Remote Execution port

UNREAL_MCP_PLATFORM

Win64

Target platform

UNREAL_MCP_CONFIGURATION

Development

Build configuration

UNREAL_MCP_MODULES

all

Comma-separated list of modules to enable

CLI Arguments

node dist/bin.js --project-path /path/to/project --engine-path /path/to/UE_5.5 --rc-port 30010

Config File

Place .unrealmcp.json in your project directory or home directory:

{
  "projectPath": ".",
  "platform": "Win64",
  "configuration": "Development",
  "enabledModules": ["console", "actor", "asset", "build", "blueprint", "material"]
}

Unreal Editor Setup

Required (for most tools)

  1. Edit > Plugins > enable Python Editor Script Plugin

  2. Restart the editor

  3. Edit > Project Settings > Plugins > Python > scroll to Remote Execution section:

    • Check Enable Remote Execution

    • UE 5.3+ IMPORTANT: Change Multicast Bind Address from 127.0.0.1 to 0.0.0.0 — Epic changed the default in 5.3 and it breaks external tools

    • Verify Multicast Group Endpoint is 239.0.0.1:6766

  4. Restart the editor again

Still getting "No Unreal Editor nodes found"?

  • VPN/Tailscale users: Tailscale's virtual network adapter can hijack multicast. Try temporarily disabling Tailscale, or disable the Tailscale network adapter in Windows Network Connections.

  • Firewall: Allow UDP port 6766 and TCP port 6776, or temporarily disable Windows Firewall to test.

  • Multiple adapters: WSL, Hyper-V, and VPN adapters can all cause multicast to bind to the wrong interface. Disabling unused adapters helps.

Optional (for Remote Control tools)

  1. Edit > Plugins > enable Remote Control API

  2. Restart the editor

  3. Edit > Project Settings > Plugins > Remote Control > Server:

    • Check Restrict Server Access — this sounds restrictive but actually enables the sub-options below (unchecked = features hidden/off)

    • Check Enable Remote Python Execution

    • Check Allow Console Command Remote Execution

    • Allowed Origins: leave blank or add 127.0.0.1

    • These take effect immediately, no restart needed

Optional (for Blueprint graph tools)

Install the C++ plugin from plugin/UnrealMCPBridge/ into your project's Plugins/ directory. This enables add_graph_node, connect_graph_nodes, and remove_graph_node.

Development

npm run dev        # Watch-mode dev server
npm run build      # Compile TypeScript
npm run lint       # Biome linter
npm run fmt        # Biome formatter
npm test           # Run tests

License

MIT

Available Tools

127 tools
add_actor_bindingC

Bind an actor to a level sequence for animation.

ParametersJSON Schema
NameRequiredDescriptionDefault
actor_nameYesActor name or label to bind
sequence_pathYesLevelSequence asset path

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description only says 'bind' and 'attachment,' which implies a mutating operation, but there are no annotations (none provided) and no behavioral details: what happens to existing bindings, whether it overwrites or appends, permissions needed, or any operation details. With the burden fully on the description, this gap is significant.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence: 'Bind an actor to a sequence for animation attachment.' It is concise and front-loaded. Every word of the description is useful.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

A simple two parameter tool with 100% schema coverage. However, there is no output schema and no behavioral details or effects on the asset/sequence/relationship are described. The description does not clarify return values, nor the possible side effects or postconditions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The parameter schema covers both 'actor_name' and 'sequence_path' with descriptions, so the structured parameter help is already complete. The description text adds a bit of semantic nuance not strictly in the schema ('label' vs 'name') but largely overlaps. Since 100% of the parameters are described in the schema, the baseline is a 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb and resource: 'Bind an actor to a sequence for animation attachment.' It identifies the specific operation (binding actor to sequence) but does not explicitly differentiate it from sibling tools like add_track or set_actor_tags. It conveys a unique function but lacks explicit separation from alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given for when to use this tool versus alternatives or when not to use it. The implied context is 'for animation attachment', but there are no explicit exclusionary criteria, prerequisites, or recommended usage situations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_blueprint_componentB

Add a component to a Blueprint.

ParametersJSON Schema
NameRequiredDescriptionDefault
blueprint_pathYesBlueprint asset path
component_nameNoName for the component
component_classYesComponent class (e.g., StaticMeshComponent, BoxCollisionComponent, PointLightComponent)

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states the action without mentioning side effects (e.g., modification of the blueprint asset), persistence, or error conditions. This is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no filler, front-loading the action and target. Maximum conciseness without sacrificing clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 3 parameters, no output schema, and no annotations. The description is too brief to cover prerequisites, behavior on failure, or relation to the blueprint asset (e.g., whether it saves or requires an open blueprint). It only communicates the core purpose.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds no parameter information beyond what the schema's property descriptions provide, but no deduction is needed since the schema is complete.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action ('Add a component') on a specific resource ('a Blueprint'), which clearly distinguishes from sibling tools like add_blueprint_variable and add_blueprint_function. The verb and object are unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, nor any prerequisites or exclusions. The tool name and description imply its use, but there is no explicit context or comparison to sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_blueprint_functionB

Add a custom function to a Blueprint.

ParametersJSON Schema
NameRequiredDescriptionDefault
function_nameYesFunction name
blueprint_pathYesBlueprint asset path

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations, so the description must disclose behavioral traits. It only states the action without mentioning side effects like asset modification, whether compilation is triggered, or whether changes are reversible. For a mutation tool, this lack of transparency is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no wasted words. It is appropriately concise for a tool with only two parameters, though it sacrifices details that could improve usefulness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Without annotations or an output schema, the description fails to provide critical context for a mutation tool, such as preconditions, side effects, or post-conditions. This makes the tool risky to invoke without additional information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides 100% coverage with descriptions for both parameters ('Function name' and 'Blueprint asset path'). The tool description adds no additional meaning beyond the schema, so the baseline score of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Add a custom function to a Blueprint' clearly states the action (add) and the resource (custom function to a Blueprint). It effectively distinguishes this tool from siblings like add_blueprint_component and add_blueprint_variable, which add other element types.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives, nor any prerequisites or exclusions. The usage is only implied by the tool name and bare description, which is insufficient for an agent to decide between this and similar 'add' tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_blueprint_variableB

Add a variable to a Blueprint.

ParametersJSON Schema
NameRequiredDescriptionDefault
default_valueNoDefault value as string
variable_nameYesVariable name
variable_typeYesVariable type
blueprint_pathYesBlueprint asset path

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description does not disclose any behavioral traits beyond the basic action. It fails to mention side effects such as whether the Blueprint asset is modified on disk, whether compilation is triggered, or what happens if the variable already exists. Since no annotations are provided, the description carries the full burden, and this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no unnecessary words. It is concise and well-structured, though it is quite terse and could provide a bit more detail without becoming verbose. This is efficient but border-line under-specification.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of annotations and output schema, the description is too brief to be complete. It does not explain side effects, prerequisites, or the significance of the default_value parameter. For a mutation tool that modifies a Blueprint asset, more context is needed for an agent to use it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage for all 4 parameters, so the schema already explains variable_name, variable_type, blueprint_path, and default_value. The tool description adds no additional parameter semantics. According to the rubric, high schema coverage yields a baseline of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Add a variable to a Blueprint.' It uses a specific verb ('Add') and a specific resource (a variable), which distinguishes it from sibling tools like add_blueprint_component and add_blueprint_function. The purpose is unambiguous even though minimal.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention any prerequisites, exclusions, or contrast with sibling tools (e.g., add_blueprint_function). The only implied usage is the obvious action, but there is no explicit context or alternative differentiation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_graph_nodeA

Add a node to a Blueprint's event graph. Requires the optional C++ plugin for full node type support. Falls back to Python for basic operations.

ParametersJSON Schema
NameRequiredDescriptionDefault
xNoX position in graph
yNoY position in graph
node_typeYesNode type (e.g., Branch, Print, CallFunction, VariableGet, VariableSet, ReceiveBeginPlay, ReceiveTick, Comparison, Switch, ExecutionSequence, SpawnActor, DynamicCast, etc.)
propertiesNoNode-specific properties (e.g., {function_name: 'PrintString', target_class: 'KismetSystemLibrary'})
blueprint_pathYesBlueprint asset path

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of disclosing behavior. It reveals a meaningful dependency: 'Requires the optional C++ plugin for full node type support. Falls back to Python for basic operations.' This explains potential degradation in functionality. However, it does not disclose side effects, return values, or failure modes, which are important for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences and immediately states the core action with a noun phrase. Every word contributes: the first sentence defines the purpose, the second provides essential caveats. No filler or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool mutates a Blueprint graph and has no output schema or annotations. The description does not mention what the tool returns, whether the blueprint must be loaded/compiled, or what happens if the event graph is missing. While the plugin caveat and schema cover some aspects, important operational details are absent for a mutation tool of moderate complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds minimal parameter-related value beyond noting that node type support may be limited without the plugin, which relates to the node_type parameter. It does not clarify coordinate ranges, property formats, or blueprint path expectations beyond the schema's own descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Add a node to a Blueprint's event graph.' This clearly distinguishes it from sibling tools like add_blueprint_component and add_blueprint_variable, which target different Blueprint elements. The scope is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives context about the optional C++ plugin requirement and Python fallback, which implies when the tool may be limited. However, it does not explicitly state when to use this tool over alternatives like connect_graph_nodes, nor does it mention exclusions such as Blueprint types or unsupported node categories. Usage guidance is present but implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_trackB

Add a track to an actor binding in a sequence.

ParametersJSON Schema
NameRequiredDescriptionDefault
binding_idYesBinding ID (from add_actor_binding or get_sequence_info)
track_typeYesTrack class name
sequence_pathYesLevelSequence asset path

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states the basic mutation action ('Add') without explaining side effects, whether duplicate tracks are allowed, what happens if the binding does not exist, or what the tool returns. This is a significant transparency gap for a mutating operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single clear sentence with no filler. It is front-loaded with the action and target, and every word contributes meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations and no output schema, the description must do more than one sentence. It does not explain workflow context (e.g., create sequence → add actor binding → add track), behavioral caveats, or expected outcomes. Even though the schema documents parameters well, the overall tool context is under-specified for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and each parameter already has a clear description (e.g., binding_id comes from add_actor_binding or get_sequence_info). The tool description adds no parameter-level meaning beyond what the schema already provides, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource: 'Add a track to an actor binding in a sequence.' It clearly distinguishes this tool from siblings like add_actor_binding, which adds a binding itself, and create_level_sequence, which creates a sequence. The intended operation is immediately understandable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'to an actor binding in a sequence' implies the user must already have a sequence and a binding, but there is no explicit guidance on when to use this tool versus alternatives, no prerequisites stated, and no caveats about ordering (e.g., after add_actor_binding). Usage is implied rather than spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

apply_anim_modifierC

Apply an animation modifier to an animation sequence.

ParametersJSON Schema
NameRequiredDescriptionDefault
sequence_pathYesAnimSequence asset path
modifier_classYesAnimation modifier class name

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the burden of explaining side effects and constraints. It only says 'Apply', which implies a modification, but does not disclose whether the original asset is mutated, what the modifier does, or any potential side effects. This is insufficient given the absence of annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, highly concise with no fluff. It covers the essential action and object, though it lacks elaboration. Structure is simple and direct.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Without annotations alert, the description must carry full weight. It does not explain what happens when applied, whether it alters the original sequence or creates a new one, any prerequisites (e.g., sequence must exist), or return values. Given two parameters and no output schema, the description is too thin for reliable tool selection and invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema descriptions are present for both parameters ('AnimSequence path' and 'Animation modifier class name'), achieving 100% coverage. However, they are terse and do not explain expected formats, allowed values, or how they interact. Baseline 3 is appropriate since schema provides basic definitions but no additional semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (apply) and the resource (animation modifier to an animation sequence). It is specific enough to distinguish from generic tools like 'apply_material', though it does not explicitly differentiate from sibling animation tools or list alternatives. The verb-resource pairing is clear, but lacks detail on what 'modifier' means in this context.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus similar animation tools (e.g., create_anim_blueprint, get_sequence_info). The description is minimal and does not mention exclusions, prerequisites, or scenarios where this tool is preferred over others.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

apply_materialC

Apply a material to an actor's mesh component.

ParametersJSON Schema
NameRequiredDescriptionDefault
actor_nameYesActor name or label
slot_indexNoMaterial slot index
material_pathYesMaterial asset path

TDQS

C2.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for behavioral disclosure. It only mentions the action without noting side effects, error conditions, or whether the operation is destructive or reversible.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence with no redundancy, making it appropriately sized for the operation's simplicity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is minimal and lacks crucial context such as error handling, expected outcomes, or edge cases, despite the tool's moderate complexity. It is not complete enough for a user to fully understand the behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool description adds no extra meaning beyond the schema's parameter descriptions, which are already trivial ('Actor name or label', etc.). It does not clarify how parameters relate to the operation or provide default behaviors.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'apply' and the resource 'material', targeting 'an actor's mesh component', which is specific and distinguishes from other tools like execution or testing.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No information is provided about when to use this tool versus alternatives, nor are any prerequisites or context given. The description lacks any guidance on selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

build_cook_runA

Full BuildCookRun pipeline — build, cook, stage, package, and optionally deploy/run. This is the primary command for packaging a project.

ParametersJSON Schema
NameRequiredDescriptionDefault
runNoRun after packaging
cookNoCook content for target platform
buildNoCompile C++ code
stageNoStage files for packaging
deployNoDeploy to device
archiveNoArchive the build
iterateNoIterative cook (faster rebuilds)
packageNoCreate distributable package
platformNoTarget platform
compressedNoCompress pak files
configurationNoBuild configuration
additional_argsNoAdditional UAT arguments

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden. It discloses that the tool executes a multi-stage pipeline and can optionally deploy/run, which is useful. However, it does not mention side effects, prerequisites, or output behavior; for a complex build pipeline this is limited transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is a single, front-loaded sentence that efficiently communicates the tool's purpose and pipeline steps. No unnecessary words or repetition of schema details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 12-parameter pipeline with no output schema and no annotations, the description is somewhat minimal. It conveys the high-level purpose but omits details like what the command returns, how long it takes, or how it relates to sibling single-step commands. Still, the schema covers parameter semantics, so it is not wholly inadequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for all 12 parameters, each with its own description. The tool description does not add parameter-level semantics beyond this, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly identifies the tool as the full BuildCookRun pipeline, enumerating the stages (build, cook, stage, package, optionally deploy/run) and positioning it as the primary packaging command. This is specific and distinguishes it from single-step siblings like build_target or cook_content.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says this is the primary command for packaging, which gives some context, but it does not explicitly mention alternatives or explain when to use specific tools like cook_content or package_project. The 'primary' phrasing implies preference but lacks explicit when/when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

build_graphB

Execute a BuildGraph XML script for CI/CD automation.

ParametersJSON Schema
NameRequiredDescriptionDefault
targetYesBuildGraph target to execute
script_pathYesPath to the BuildGraph XML script
additional_argsNoAdditional arguments

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden for behavioral disclosure. It does not state whether this operation is read-only or destructive, what side effects it may have (e.g., modifying build artifacts), or whether it requires special privileges. For a tool that executes scripts, this lack of transparency is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that is front-loaded with the core action. It is efficient and to the point, but it could add a bit more context without becoming verbose, such as a note about the `additional_args` parameter or typical usage patterns.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (execution of scripts, potential side effects, and need for clear behavioral expectations) and the absence of annotations or an output schema, the description is underspecified. It does not explain return values, error handling, or the effect of the `additional_args` parameter, leaving the agent with an incomplete picture for a potentially impactful operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description mentions 'BuildGraph XML script' and 'target', which aligns with the script_path and target parameters, but it adds no additional semantics beyond the schema. The schema already describes each parameter at 100% coverage, so the description does not substantially enhance understanding of parameter usage or formats.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it executes a BuildGraph XML script for CI/CD automation, specifying the resource (XML script) and the action (execute). It is somewhat distinct from siblings like build_target or build_cook_run, but it doesn't explicitly differentiate itself or clarify what BuildGraph is, so it falls short of a perfect 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies it is used for CI/CD automation, but it does not provide explicit guidance on when to use this tool versus alternatives like build_target or build_cook_run. No exclusions or alternative tool mentions are made, leaving the usage context somewhat ambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

build_pluginC

Build a plugin standalone.

ParametersJSON Schema
NameRequiredDescriptionDefault
platformNoTarget platform
output_pathYesOutput directory for the built plugin
plugin_pathYesPath to the .uplugin file

TDQS

C2.4/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, placing full burden on the description. The single sentence 'Build a plugin standalone' discloses no behavioral traits such as side effects, required environment, outputs, or error handling. This is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely brief, but this is under-specification rather than concise clarity. It lacks essential context that a tool description should provide, making the brevity a detriment rather than a strength.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a build operation with no annotations and no output schema, the description should explain what 'standalone' means, the build process, expected outputs, and potential prerequisites. It provides none of this, leaving the agent without adequate context for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. All three parameters are documented in the schema, and the description does not add any additional semantic meaning beyond what the schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Build') and resource ('plugin'), which clearly indicates the tool's core function. It partially distinguishes from sibling build tools by targeting plugins, though the term 'standalone' is vague and could be more explicit about the build output type.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool instead of alternatives. Sibling tools like build_target, build_cook_run, and package_project exist, but the description does not mention any differentiation or context for choosing this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

build_targetB

Build a C++ target using UnrealBuildTool. Compiles the project's C++ code.

ParametersJSON Schema
NameRequiredDescriptionDefault
cleanNoClean build
targetNoBuild target: Editor, Game, Client, ServerEditor
platformNoTarget platform (default from config, e.g., Win64)
configurationNoBuild config: Debug, DebugGame, Development, Shipping, Test

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of disclosing behavior. It does not mention that building modifies the project, may be long-running, requires credentials or environment setup, or whether it cleans before building. The brief statement 'Compiles the project's C++ code' is tautological and adds no transparency beyond the name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is only two short sentences, so it is concise. However, it is so minimal that it misses important structural information like expected inputs, outputs, or side effects. While it is not verbose, it is under-specified and could benefit from more specific detail without being overly long.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Building a C++ target is a complex operation that typically involves compilation, possibly linking, and can affect the project state. The description does not mention that it compiles for a specific platform or configuration, what happens on success/failure, or whether it returns a build status. Without an output schema, the description should explain what the tool returns, but it doesn't. This is incomplete for a build operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

All four parameters have descriptions in the schema (coverage 100%), so the schema already explains their meanings. The tool description adds no parameter-level detail beyond what the schema provides, which is consistent with baseline 3. The schema's descriptions are adequate (e.g., 'Build target: Editor, Game, Client, Server').

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Build a C++ target using UnrealBuildTool' and adds 'Compiles the project's C++ code.' This is a specific verb-resource pair that distinguishes it from sibling tools like build_plugin, build_cook_run, or generate_project_files, which have different scopes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as build_plugin, cook_content, or package_project. There is no mention of prerequisites, exclusions, or scenarios where a different tool would be more appropriate. The description merely states what it does without contextual direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

call_preset_functionC

Call a function exposed via a Remote Control Preset.

ParametersJSON Schema
NameRequiredDescriptionDefault
parametersNoFunction parameters
preset_nameYesPreset name
function_nameYesExposed function name

TDQS

C2.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present to disclose read-only status, destructive potential, or rate limits. The description's verb 'call' implies invocation, but no side effects, permissions, or error behavior are disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is one concise sentence of nine words. It omits examples, parameter details, and usage context, making it too terse to compensate for the sparse annotations and ambiguous preset terminology.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, no behavior on failure, no return value description. The preset concept is undefined, and given the parametrized params object and semantic gap, the agent cannot reliably know what the function returns, whether it is safe, or if it accepts nonstring values. Lacks key information for a call-related tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers 100% of parameters with names and types (including an 'other properties' object for flexible parameters). However, the description only restates the schema label ('Function parameters') and adds no deeper meaning about specific expected keys, value formats, or the parameter object's structure.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action: 'Call a function' exposed via a Remote Control preset, but it does not identify what a Remote Control preset is, how functions are exposed, or what makes this distinct from sibling tools like get_preset_info, list_presets, or get_preset_property.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives such as execute_python_code, execute_console_command, or direct preset property getters. There is no mention of context, preconditions, or consequences.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

clean_projectC

Clean build artifacts for the project.

ParametersJSON Schema
NameRequiredDescriptionDefault
platformNoTarget platform

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of revealing side effects. 'Clean build artifacts' implies deletion or removal, but it does not state what exactly is deleted, whether it is safe to run, or if it has any irreversible consequences. This is a significant gap for a potentially destructive operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no fluff, which is concise. It is front-loaded with the primary action. However, it lacks any elaboration on scope or effects, which might make it too terse for a destructive operation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description must convey the full behavior. It only states 'clean build artifacts' without detailing what is removed, whether it is irreversible, whether it affects the entire project or just the specified platform, or what the outcome is. The tool is likely destructive (cleaning) but no warnings or side effects are mentioned. Hence, incomplete for safe usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%: the only parameter 'platform' has a description 'Target platform' in the schema itself. The tool description adds no further meaning about the parameter, so it provides minimal added value. Baseline of 3 is appropriate since the schema already covers the parameter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly indicates the tool's purpose: to clean build artifacts from the project. The verb 'clean' and resource 'build artifacts' are specific, and it distinguishes from sibling build tools (e.g., build_target, package_project) which create artifacts. However, it does not specify what specific artifact types are cleaned (e.g., intermediate files, caches), leaving some ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, typical scenarios, or cases where this should not be used (e.g., avoid during active builds). With many sibling tools for building and cooking, the description lacks direction for an agent to decide when this is the appropriate choice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

compile_blueprintC

Compile a Blueprint.

ParametersJSON Schema
NameRequiredDescriptionDefault
blueprint_pathYesBlueprint asset path

TDQS

C2.4/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It merely states 'Compile a Blueprint' without revealing side effects, whether it saves/overwrites, what happens on compilation errors, or any required setup. This is too vague to inform an agent about potential impacts or prerequisites.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no filler or redundancy. It is efficiently minimal, though perhaps overly terse. It earns its place but leaves significant information unsaid, preventing a perfect score.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a compilation tool with no output schema, no annotations, and only one self-explanatory parameter, the description is insufficient. It does not mention expected outcomes, compilation errors, or whether the compiled asset is saved/updated, leaving the agent without critical context for such an operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already fully covers the single parameter 'blueprint_path' with a clear description ('Blueprint asset path'). The tool description adds no additional semantic detail about the parameter, but since schema coverage is 100%, the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Compile') and resource ('Blueprint'), making the basic action clear. However, it lacks detail on what compiling entails and does not differentiate from related sibling tools like create_blueprint or get_blueprint_info beyond the verb itself. It is a minimal, generic statement rather than a fully clarifying one.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives such as build_target, create_blueprint, or recompile_material. No prerequisites, expected usage context, or exclusions are provided. The description is purely a one-line action statement with no usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

connect_graph_nodesB

Wire two node pins together in a Blueprint graph. Requires the optional C++ plugin.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_pinYesSource pin name
target_pinYesTarget pin name
blueprint_pathYesBlueprint asset path
source_node_idYesSource node ID
target_node_idYesTarget node ID

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions the plugin requirement but does not state whether the operation is destructive, whether it checks pin compatibility, what the result of a successful or failed connection looks like, or any side effects. This is a significant gap for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is one concise sentence with a necessary caveat about the plugin requirement. There is no fluff or redundant information, making it efficient and front-loaded with the core purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of graph wiring (5 params, no output schema, no annotations), the description is too brief. It does not explain what a node ID is, how to obtain it (sibling tools like list_graph_nodes could help), what happens after wiring, or any expected return value. The plugin requirement is the only contextual detail, leaving the agent under-equipped.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with basic descriptions for all five parameters. The tool description adds no additional meaning beyond the schema, so the baseline score of 3 is appropriate. However, the parameters like source_pin and target_pin are only described as 'pin name', without further context on how to format them.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Wire two node pins together in a Blueprint graph.' This uses a specific verb ('wire') and resource ('node pins in a Blueprint graph'), distinguishing it from sibling tools like add_graph_node or remove_graph_node which operate on nodes themselves.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by describing the action, but it does not explicitly mention when to use this tool versus alternatives like connect_material_expressions. The only additional guidance is the requirement for the optional C++ plugin, which is a prerequisite rather than usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

connect_material_expressionsB

Wire two material expression nodes together.

ParametersJSON Schema
NameRequiredDescriptionDefault
material_pathYesMaterial asset path
to_input_nameNoTarget input pin name (empty string for first/default input)
from_output_nameNoSource output pin name (empty string for first/default output)
to_expression_nameYesTarget expression name
from_expression_nameYesSource expression name

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the burden. It does not disclose that this likely modifies a material asset, requires compatible pins, or that connections are directional. The behavior beyond the literal action is entirely unspecified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with zero redundancy. It immediately communicates the core action and target, making it easy for an agent to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 5 parameters and no output schema or annotations, the description is too minimal. It does not explain the direction of wiring, default pin behavior, or side effects on the material asset. The agent would need to infer or explore to understand the full context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds little beyond restating that two nodes are involved; it does not clarify the roles of from/to expressions or input/output pins. The schema already handles parameter details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'wire' and names the resource 'material expression nodes,' clearly distinguishing it from sibling tools like connect_graph_nodes (which likely targets blueprint graphs) and connect_material_property (which connects material properties). The action and target are unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, no prerequisites, and no exclusions. It simply states the operation without any contextual cues for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

connect_material_propertyB

Connect an expression to a material output property (BaseColor, Normal, Metallic, Roughness, etc.).

ParametersJSON Schema
NameRequiredDescriptionDefault
output_nameNoExpression output pin name (empty string for first/default output)
material_pathYesMaterial asset path
expression_nameYesExpression name to connect
material_propertyYesMaterial property to connect to

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose side effects. It only says 'Connect' without mentioning that this modifies the material asset, may require saving, or whether it overwrites existing connections. This is a mutation tool with zero behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single concise sentence that directly states the purpose with useful property examples. No wasted words, perfectly sized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool modifies a material asset, but there is no output schema and no annotations. The description doesn't explain return values, side effects, or preconditions. Given the mutation nature, it should at least note the need to save or that existing connections are replaced. Not complete for safe invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, with descriptions for all four parameters, so the baseline is 3. The description adds nothing beyond the schema; it only lists example properties that already appear in the enum. No additional semantic value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states the action (connect), the entities (an expression and a material output property), and gives concrete examples (BaseColor, Normal, etc.). This distinguishes it from sibling tools like connect_material_expressions, which likely connects expressions to each other.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when-to-use or alternatives are provided. The description gives no context about prerequisites (e.g., material must be loaded) or when to prefer this over connect_material_expressions. Usage is only implied by the property list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

consolidate_assetsB

Consolidate duplicate assets — replace references from source assets to a target asset.

ParametersJSON Schema
NameRequiredDescriptionDefault
target_pathYesTarget asset path to keep
source_pathsYesSource asset paths to consolidate into target

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It reveals that references are replaced but does not state whether source assets are deleted, kept, or otherwise modified, nor any side effects (e.g., if target assets are overwritten). For a potentially destructive operation, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is concise and front-loaded with the tool's purpose. It contains no filler and every word contributes to understanding the action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that this is a mutation tool with no annotations and no output schema, the description should explain the full impact, such as whether source assets are removed, whether the target is permanently modified, and if there are any constraints (e.g., related packages). The current description leaves this ambiguous, making it incomplete for an operation that could have significant consequences.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with both parameters clearly described in the schema (target_path: 'Target asset path to keep', source_paths: 'Source asset paths to consolidate into target'). The description adds minimal extra meaning beyond the schema, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Consolidate duplicate assets' and specifies the mechanism: 'replace references from source assets to a target asset.' This distinguishes it from sibling tools like fix_redirectors (which fixes broken references) and import_asset (which imports new assets). However, it could be slightly more explicit about the scope (e.g., all duplicates in the project) but is adequate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use this tool (when there are duplicate assets to merge) but does not explicitly contrast with alternatives or state when not to use it. There is no mention of prerequisites like whether the source and target must be in the same package. The intended context is implied but not spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

content_auditA

Run content audit to find costly or problematic assets (runs ContentAudit commandlet).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses the execution mechanism ('runs ContentAudit commandlet') and the nature of the task (finding costly/problematic assets), suggesting a read-only analysis. However, it doesn't state whether the audit modifies assets, requires specific permissions, or produces a detailed report, leaving important behavioral traits unspecified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that efficiently conveys purpose and execution. Every word adds value, with no redundancy or extraneous information. It is appropriately sized for a zero-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no parameters, no output schema, and no annotations, the description is the sole source of information. It covers what the tool does and how it executes, but it does not clarify what the agent should expect as a result (e.g., a list of assets, console output, or a report). This gap prevents full contextual completeness for an agent invoking the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters (empty object), so parameter semantics are not applicable. The description correctly omits any parameter explanation. Baseline for 0 params is 4, and the description does not need to compensate for any missing schema details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Run content audit to find costly or problematic assets'. It uses a specific verb ('run') and resource ('content audit'), and the additional parenthetical 'runs ContentAudit commandlet' adds technical specificity. This distinguishes it from siblings like validate_assets or fix_redirectors.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide guidance on when to use this tool versus alternatives. It implies usage through its purpose (finding costly/problematic assets), but there is no explicit context, exclusions, or mention of sibling tools. The user is left to infer when 'content_audit' is preferable to tools like validate_assets or consolidate_assets.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

cook_contentB

Cook content only (no C++ build). Converts assets to platform-specific format.

ParametersJSON Schema
NameRequiredDescriptionDefault
mapsNoSpecific maps to cook (empty = all)
iterateNoIterative cook
platformNoTarget platform

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations, so the description carries the burden. It discloses the function's purpose but does not mention side effects, the impact on existing assets, whether it is destructive (e.g., overwrites files), or any required conditions (e.g., platform availability). Given the mutation potential, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, concise and front-loaded with the action. It wastes no words but could be slightly more informative about the process. It is efficient and to the point.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 3 optional parameters and no output schema. The description covers the basic purpose but does not explain the behavior of 'iterate' or 'maps', nor the return value or side effects. Given the tool's potential complexity, the description is minimally complete but lacks detail about the cook process and dependencies.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of parameters with descriptions, so baseline is 3. The description adds no extra meaning beyond the schema, but it doesn't need to given the schema coverage. Yet, the description could add typical values for platform, but that is optional. Hence a 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'cook' and the resource 'content', and contrasts with 'no C++ build' to distinguish it from build operations. It also states the outcome: converting assets to platform-specific format. This distinguishes it from build_target and other build/cook siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says 'Cook content only (no C++ build)', implying when to use this instead of a full build. However, it does not explicitly mention when not to use it or suggest alternatives. It lacks context on when to choose this over build_cook_run or package_project.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_anim_blueprintB

Create an Animation Blueprint for a target skeleton.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesAnimBlueprint name
pathNoContent directory/Game/Animations
skeleton_pathYesTarget skeleton asset path

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the burden. It only says 'Create' without disclosing side effects, potential overwrites, required permissions, or return behavior. This leaves significant ambiguity.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that conveys the essential purpose without unnecessary detail. It is well-structured and easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is minimal but adequate for a simple creation tool given no output schema or annotations. However, it lacks any mention of success/error behavior or expected outcomes, so it's not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with each parameter having a description. The tool description itself adds no extra parameter semantics, but since coverage is high, the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: to create an Animation Blueprint for a target skeleton. It distinguishes itself from sibling creation tools like create_level_sequence and create_anim_montage.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It doesn't mention scenarios where this is preferred or any prerequisites (e.g., requiring a valid skeleton asset).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_anim_montageC

Create an animation montage from an animation sequence.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMontage name
pathNoContent directory/Game/Animations
sequence_pathYesSource AnimSequence asset path

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It only states the action without mentioning side effects (e.g., asset creation location, overwrites), permission requirements, or how the montage relates to the source sequence. This is a significant gap for a creation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, succinct sentence that conveys the core action without fluff. It is appropriately front-loaded and avoids redundancy with the schema. However, it is so brief that it borders on under-specification, though it remains clear and purposeful.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete. It does not explain what happens after creation (e.g., where the montage is saved, whether it is automatically opened, or how to verify success). For a creation tool, this missing context is a notable gap, especially since the tool has multiple parameters and siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has descriptions for all three parameters (100% coverage), so the baseline is 3. The description adds no additional meaning beyond the schema, simply restating the relationship between the source and the montage. It does not clarify parameter formats, defaults, or interdependencies beyond what the schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Create') and the resource ('animation montage') with a source ('from an animation sequence'). It is specific enough to distinguish from related tools like create_anim_blueprint, though it could be slightly more detailed about what a montage represents. Overall, it's a clear purpose statement.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool instead of alternatives. It does not mention prerequisites, typical use cases, or exclusions. With many sibling tools for animation and asset creation, this lack of context makes it hard for an agent to select this tool appropriately.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_blueprintC

Create a new Blueprint class.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesBlueprint asset name
pathNoContent directory to create in/Game/Blueprints
parent_classNoParent class (e.g., Actor, Character, Pawn, PlayerController)Actor

TDQS

C2.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully disclose behavior. It only says 'Create a new Blueprint class' without mentioning side effects (e.g., asset creation on disk, automatic compilation, or whether existing assets are overwritten), leaving the tool's behavioral footprint completely unspecified.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no wasted words. It is appropriately sized for a simple creation tool, though it is minimal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 3-parameter tool with no output schema and no annotations, the description is insufficient. It does not explain what a Blueprint class is, what the tool returns, or any prerequisites or side effects. Sibling creation tools like create_anim_blueprint appear similar, making additional context necessary.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema provides descriptions for all 3 parameters (name, path, parent_class) with 100% coverage, so the baseline is 3. The description adds no parameter-specific semantics, relying entirely on the schema for meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Create') and names the resource ('Blueprint class'), clearly stating the tool's action. It is distinguishable from sibling creation tools like create_anim_blueprint or create_material by explicitly naming 'Blueprint class,' though it does not elaborate on what a Blueprint class entails.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given for when to use this tool versus alternatives. The description simply states the action without mentioning exclusions, prerequisites, or related tools such as compile_blueprint or spawn_blueprint_actor, leaving the agent without selection criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_level_sequenceB

Create a new LevelSequence asset for cinematics.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesSequence name
pathNoContent directory/Game/Cinematics

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description only mentions the creation action without disclosing side effects, error conditions, or permissions. It does not state what happens if the asset already exists or any other behavioral aspects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that directly states the purpose. It is well-structured and front-loaded with the key information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple creation tool, the description is adequate but incomplete. It does not mention any return values or output, nor does it provide context on the asset's properties or interactions with other systems.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already covers all parameters with descriptions (name, path). The tool description adds no extra meaning beyond what the schema provides, so it meets the baseline but does not exceed it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (create) and the resource (LevelSequence asset) with a specific purpose (for cinematics). It is unambiguous and distinguishes it from other tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention any conditions, prerequisites, or comparison with sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_materialB

Create a new material asset.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name
pathNoContent directory/Game/Materials

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations available, the description carries the full burden of behavioral disclosure, but it only states the core action. It does not mention what happens if a material with the same name exists, whether a default path is used, or any side effects of asset creation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence with no redundancy or filler. It efficiently communicates the tool's purpose without unnecessary detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with only two parameters and a clear schema, and the description states the basic purpose. However, it lacks usage guidance and behavioral details that would make it fully self-sufficient, especially given the absence of annotations and output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already provides 100% coverage of the two parameters (name and path), including descriptions and defaults. The description adds no parameter-specific guidance, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Create') and identifies the resource type as 'material asset', which clearly distinguishes it from sibling tools like create_material_function and create_material_instance. It is concise and not tautological.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives such as create_material_instance or apply_material. There is no mention of prerequisites, exclusions, or context in which this tool is preferred.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_material_expressionA

Add an expression node to a material's graph (e.g., TextureSample, Multiply, Constant3Vector).

ParametersJSON Schema
NameRequiredDescriptionDefault
xNoX position in graph
yNoY position in graph
material_pathYesMaterial asset path
expression_classYesExpression class (e.g., MaterialExpressionTextureSample, MaterialExpressionMultiply, MaterialExpressionConstant3Vector, MaterialExpressionVectorParameter)

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It states the action but does not disclose side effects, whether a material must already exist, behavior on invalid paths, or any error conditions. For a mutating operation, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, clear sentence that front-loads the action and resource, followed by useful examples. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple node-adding tool, the description is minimally sufficient, but it lacks context about how this fits into a broader workflow (e.g., adding a node is separate from connecting it). No output schema or annotation support increases the burden, but the operation itself is straightforward.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already provides descriptions for all parameters (100% coverage), so the baseline is 3. The description adds value by giving concrete examples of valid expression_class values, but does not elaborate on x/y placement semantics beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Add') and resource ('expression node to a material's graph'), with concrete examples (TextureSample, Multiply, Constant3Vector). This clearly distinguishes it from sibling tools like create_material or connect_material_expressions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The purpose implies usage (add a node to a material graph), but no explicit guidance is given about when to use this tool versus alternatives like add_graph_node or connect_material_expressions. The description does not mention exclusions or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_material_functionC

Create a reusable material function.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial function name
pathNoContent directory/Game/Materials/Functions

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of disclosing behavioral details. It only says 'create', without mentioning side effects such as whether the function is saved immediately, if existing ones are overwritten, or any permissions needed. The word 'reusable' adds minimal context but is inherent to the asset type.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no unnecessary words, making it concise and front-loaded. It is efficient, though it could arguably provide more substance without losing brevity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple tool (2 parameters, full schema coverage) and no output schema, the description adequately states the core purpose. However, the absence of annotations and behavioral context means the agent must infer what 'create' entails, such as saving behavior or overwrite policies, which could be ambiguous.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with descriptions for both 'name' and 'path'. The description does not add any additional meaning beyond the schema, but the baseline is 3 because the schema already documents parameters well.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'create' and identifies the resource as a 'reusable material function', which clearly differentiates it from siblings like create_material or create_material_expression by the asset type. However, it doesn't explicitly contrast with these alternatives, so it lacks full sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus other creation tools. The description simply states the action without any context, prerequisites, or exclusions, leaving the agent to infer usage from the resource type.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_material_instanceB

Create a material instance from a parent material.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial instance name
pathNoContent directory/Game/Materials
parent_pathYesParent material asset path

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure, but it only states the core action. It does not mention prerequisites (e.g., parent material must exist), overwrite behavior, or what side effects occur, making it insufficient for understanding the tool's full behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single-sentence description is concise and front-loaded with the verb and object. Every word adds value, with no filler or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's moderate complexity and lack of annotations/output schema, the description is minimal but functional because the schema fully documents parameters. However, it lacks usage context and sibling differentiation, making it slightly below average for completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, with each parameter described (name, path, parent_path). The description adds no additional parameter semantics beyond saying 'from a parent material,' which mirrors the parent_path description. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Create a material instance from a parent material' clearly identifies the action (create), the resource (material instance), and the source (parent material). This distinguishes it from sibling tools like create_material or create_material_function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as create_material or apply_material. The description only states what it does, leaving the agent to infer usage context from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_actorB

Delete an actor from the current level by name or label.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesActor name or label to delete

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the full burden. While 'Delete' implies a destructive operation, it does not disclose whether the deletion is reversible, what happens to references, or any side effects. This leaves a significant transparency gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, tightly worded sentence communicates the core action, target, and selection criteria with no redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter and no output schema, the description covers the basic purpose and parameter. However, the lack of usage guidance and behavioral transparency for a destructive action makes it only minimally complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, and the parameter description already states 'Actor name or label to delete'. The tool description reinforces this but does not add new meaning beyond the schema, meriting the baseline score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Delete an actor from the current level by name or label' uses a specific verb with a clear resource (actor) and scope (current level). It distinguishes itself from sibling tools like delete_asset and duplicate_actors by targeting actors specifically.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as delete_asset for assets or select_actors for selection. The description lacks explicit context, exclusions, or alternative tool references.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_assetA

Delete an asset. Checks for references first.

ParametersJSON Schema
NameRequiredDescriptionDefault
forceNoDelete even if referenced by other assets
asset_pathYesAsset path to delete

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses the key safety behavior of checking references before deletion, but does not explain what happens when references exist (e.g., error unless force) nor mention other consequences like irreversibility or permission requirements. This is better than nothing but incomplete.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences with no fluff. It is front-loaded with the primary action and immediately provides a critical behavioral note. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple delete tool, the description covers the core purpose and a critical behavioral aspect. The schema documents all parameters, and since there is no output schema, return values are not necessary to explain. It could mention potential error conditions or confirmation prompts, but given the simplicity, it is fairly complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the parameters are fully described in the schema. The tool description adds value by explaining the rationale for the force parameter: it relates to the reference check. This connects the parameter to the real-world behavior, going beyond the schema's literal description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Delete') and the resource ('an asset'). It distinguishes itself from sibling tools like delete_actor (which targets actors) and provides a specific behavioral detail ('Checks for references first') that adds clarity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when an asset needs to be deleted, but it does not explicitly state when to use this tool versus alternatives like rename_asset or delete_actor. The reference-check behavior hints at a prerequisite but no exclusions or alternative suggestions are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_material_expressionA

Remove an expression node from a material graph.

ParametersJSON Schema
NameRequiredDescriptionDefault
material_pathYesMaterial asset path
expression_nameYesExpression name to delete

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description must carry the behavioral burden. It only says 'Remove an expression node' without disclosing side effects like breaking connections, irreversibility, or whether the material needs recompilation. This is a simple restatement of the tool's name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that is front-loaded with the verb and resource. No wasted words or unnecessary detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple delete tool with two well-documented parameters and no output schema, the description is adequate. It identifies the specific domain (material graph) and the operation, which is sufficient for an AI agent to select and invoke the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with both 'material_path' and 'expression_name' having clear descriptions. The tool description adds no additional parameter context, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Remove an expression node from a material graph' uses a specific verb ('Remove') and explicitly identifies the resource ('expression node from a material graph'). This clearly distinguishes it from sibling tools like 'delete_asset' and 'remove_graph_node'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not explicitly state when to use this tool versus alternatives such as 'remove_graph_node' or 'delete_asset'. Usage is implied through the material graph context, but no exclusions or alternative references are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

disable_pluginA

Disable a plugin in the .uproject file. Requires editor restart to take effect.

ParametersJSON Schema
NameRequiredDescriptionDefault
plugin_nameYesPlugin name to disable

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of disclosing behavior. It identifies the file being modified (.uproject) and the post-action requirement (editor restart), which are critical for safe use.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is highly concise: two short sentences with no redundant information. The action and consequence are front-loaded, making it easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter tool with no output schema, the description provides all essential context: what it does, where it acts, and what the user must do after. It is complete for the tool's simplicity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers the only parameter (plugin_name) with a clear description. The tool description does not add additional parameter-specific context, so the baseline score of 3 applies given 100% schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Disable a plugin') and the target resource ('.uproject file'). This specific verb+resource combination distinguishes it from sibling tools like enable_plugin and list_plugins.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description notes a practical consequence (requires editor restart) but does not explicitly discuss when to use this tool versus alternatives like enable_plugin. The intended use is implied rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

duplicate_actorsC

Duplicate actors by name.

ParametersJSON Schema
NameRequiredDescriptionDefault
namesYesActor names or labels to duplicate
offsetNoOffset for duplicated actors

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure and falls short. It doesn't explain what 'duplicate' entails (e.g., does it copy tags, transforms, bindings?), whether original actors are modified, or any side effects. The brief statement is minimally transparent for a tool that likely mutates the scene.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, short sentence that is immediately scannable. However, it may be too terse—while it earns points for front-loading, it sacrifices substance for brevity, as noted in other dimensions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with full schema coverage and no output schema, the description is minimally adequate but leaves gaps. It doesn't clarify return behavior or side effects, and the presence of a nested 'offset' object suggests some complexity that isn't addressed. Given the rich sibling context (Unreal engine automation), more context about what 'actors' are in this tool's domain would help.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both parameters ('names' and 'offset') have descriptions in the schema. The description adds 'by name' which clarifies that 'names' refers to actor names/labels, but the 'offset' parameter is already self-explanatory. No additional semantics are provided beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Duplicate actors by name' clearly states the action (duplicate) and target (actors), and the 'by name' qualifier adds some scope. It's clear and specific, though it doesn't explicitly distinguish from siblings that might also duplicate since some sibling names like 'add_actor_binding' suggest related but different operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given on when to use this tool versus alternatives. The description implies it duplicates actors, but there's no mention of prerequisites, position in a workflow, or why one might choose this over related operations like 'add_actor_binding' or 'spawn_niagara_attached'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

duplicate_assetB

Duplicate an asset to a new path.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_pathYesSource asset path
destination_pathYesDestination asset path

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden for behavioral disclosure. It does not mention what happens if the destination path already exists, whether references are updated, or any failure modes. The description only states the basic action without side effects or constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no redundant words. It is front-loaded with the core action and resource, making it easy to scan. It could be more detailed, but that is a completeness issue, not a conciseness issue.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is extremely sparse for a tool with no output schema and no annotations. It does not clarify key details such as whether destination_path must include a new asset name, how collisions are handled, or whether the operation is recursive. This leaves the agent with unanswered questions for a mutation operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both parameters (source_path and destination_path) are already documented in the schema. The description adds no additional meaning beyond the schema, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Duplicate' with a clear resource ('an asset') and outcome ('to a new path'). It clearly distinguishes from sibling operations like rename_asset or delete_asset, which have different intents.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives such as rename_asset, import_asset, or duplicate_actors. There are no exclusions, prerequisites, or example scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

enable_pluginA

Enable a plugin in the .uproject file. Requires editor restart to take effect.

ParametersJSON Schema
NameRequiredDescriptionDefault
plugin_nameYesPlugin name to enable

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It transparently states that the operation modifies the .uproject file and requires an editor restart to take effect, which is a key side-effect. It does not mention potential errors or permission requirements, but for a simple config-enabling tool this is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence of 14 words, front-loaded with the verb and resource. It contains no redundancy or extra fluff, earning its place entirely.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter tool with no output schema, the description adequately covers the purpose and the critical restart requirement. It is complete enough for an agent to invoke the tool correctly, though it omits minor details like error handling or whether the plugin must be installed first.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage for the sole parameter 'plugin_name', with its own description. The tool description adds no additional parameter semantics beyond what the schema already provides, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'Enable' and clearly identifies the resource as 'a plugin in the .uproject file'. This distinguishes it from sibling tools like disable_plugin and list_plugins, making the tool's purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies the tool is used when you want to activate a plugin, and the note about requiring an editor restart provides practical usage context. It does not explicitly name alternatives, but the purpose is clear enough that an agent can infer when to use it in the plugin management workflow.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

execute_console_commandA

Run a console command in the Unreal Editor (e.g., 'stat fps', 'stat unit', 'r.SetRes 1920x1080').

ParametersJSON Schema
NameRequiredDescriptionDefault
commandYesConsole command to execute

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must disclose behavioral traits. It only states 'Run a console command' without mentioning potential side effects, that arbitrary commands may modify editor state, or whether output is returned. This is insufficient for a mutating action, especially given no annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that gets straight to the point. Every word is necessary, with examples that are brief and illustrative. No fluff or redundant content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter and no output schema, the description is adequate but lacks details about return behavior, authentication, or potential limitations. Given the existence of a sibling run_stat_command, the description could clarify its scope further, but it is minimally complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema fully documents the 'command' parameter, and the description adds concrete example commands ('stat fps', 'stat unit', 'r.SetRes 1920x1080') that clarify the expected string format, providing value beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool runs console commands in the Unreal Editor, with specific verbs ('Run'), resource ('console command'), and concrete examples. It distinguishes from siblings like execute_python (Python execution) and run_stat_command (likely a subset) by being the generic console command tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for any console command via examples but does not explicitly state when to use this over the sibling run_stat_command, which might be more appropriate for stat commands. There are no explicit exclusions or mentions of alternatives, leaving the selection ambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

execute_pythonA

Execute arbitrary Python code in the Unreal Editor's Python environment. Has access to the full unreal module.

ParametersJSON Schema
NameRequiredDescriptionDefault
codeYesPython code to execute in the editor

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. While it mentions arbitrary code execution and access to the full `unreal` module, it does not disclose potential side effects (e.g., modifying assets, saving packages, or crashing the editor) or error handling behavior. This is a significant gap for a tool with such broad capabilities.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the core purpose, and contains no fluff. Every word earns its place, making it highly concise and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's relative simplicity (single parameter, no output schema, no annotations), the description is minimally adequate. It explains the purpose and scope but lacks details on return values, error behavior, or how to retrieve output (e.g., print statements). For a generic code execution tool, this is arguably sufficient, but it could be more informative for a broader audience.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of the parameter (code), including its description ('Python code to execute in the editor'). The tool description itself adds no additional meaning beyond what the schema already provides, so it stays at the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool executes arbitrary Python code in the Unreal Editor's Python environment, with access to the full `unreal` module. This specific verb+resource clearly distinguishes it from sibling tools that perform specific operations like applying materials or running tests.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies this tool is for custom logic not covered by other, more specific tools, but it does not explicitly say when to use it versus alternatives or when not to use it. No exclusions or alternative recommendations are provided, so the guidance is minimal but not misleading.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

export_assetC

Export an asset to an external file format.

ParametersJSON Schema
NameRequiredDescriptionDefault
asset_pathYesAsset to export
output_pathYesOutput file path on disk

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description bears the full burden of explaining behavioral traits. It fails to disclose whether the operation is read-only or potentially destructive (e.g., does it overwrite existing output files?). It doesn't explain what happens on failure, whether directories are created, or any side effects. For a tool that writes to disk, this is a significant transparency gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that is brief and folds into the JSON payload cleanly. It's not verbose and is easily scannable. However, its brevity comes at the cost of missing opportunities for elaboration on nuances like file extension handling, which could be covered in one or two more sentences without becoming bloated.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of the tool as an export operation, the description is underspecified. It lacks details on supported output formats, whether the output file's extension dictates the format, and how it differs from similar file operations. Since there's no output schema and no annotations, the description should carry more weight in explaining return behaviors, but it doesn't.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 100% parameter description coverage with both parameters described. However, the description itself adds nothing beyond the raw schema. The parameter descriptions are minimal: 'Asset to export' and 'Output file path on disk' provide the bare minimum. Since schema coverage is 100%, the baseline of 3 applies, but the thin descriptions like 'Asset to export' are terse.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Export an asset to an external file format' has a specific verb and resource, and the parameters clarify the user provides an asset path and output path. However, it doesn't distinguish itself from the sibling 'import_asset' beyond the direction of transfer, which is implied. It clearly states the verb 'export' and the resource 'asset,' which is adequate but not exceptional.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no context on when to use this tool versus alternatives. Given the broad set of sibling tools including 'import_asset', 'consolidate_assets', 'validate_assets', and 'run_gauntlet', explicit guidance on when to choose export_asset would be valuable. There's no mention of supported file formats, typical use cases, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

export_sequence_fbxB

Export a level sequence to FBX.

ParametersJSON Schema
NameRequiredDescriptionDefault
output_pathYesOutput FBX file path
sequence_pathYesLevelSequence asset path

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description is solely responsible for disclosing behavior. It only says 'export a level sequence to FBX' without mentioning side effects like overwriting the output file, whether it modifies the source sequence, error conditions, or any permissions required. This lack of disclosure is a notable gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with no extra words. It states the action directly and efficiently. The brevity is appropriate for what is otherwise a straightforward export operation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity (2 parameters, no nested objects, no output schema), a minimal description may suffice. However, the absence of annotations and any extension around usage or behavior leaves it just above minimal viability, but it is not exceptional.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema describes both parameters completely (100% coverage) with names and descriptions ('LevelSequence asset path' and 'Output FBX file path'). The description doesn't add any extra semantics, and since the schema already carries the load, a baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Export'), the resource ('level sequence'), and the output format ('FBX'). This specificity distinguishes it from generic tools like 'export_asset' or 'render_sequence', even though the description doesn't explicitly compare with them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, scenarios, or comparisons with siblings such as 'export_asset' or 'render_sequence'. This leaves the agent without context for selecting between related defaults.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

fix_redirectorsA

Clean up asset redirectors in the project (runs FixUpRedirects commandlet).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description bears full responsibility for behavioral transparency. It mentions 'clean up' and the commandlet, implying asset modification, but lacks detail on side effects, irreversibility, or whether saves are required.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that efficiently conveys the tool's purpose without extraneous information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with no inputs, the description is largely complete. It could mention potential effects like saving changes, but overall it sufficiently covers the tool's role in the pipeline.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has no parameters, so the schema provides no information. The description adds no parameter details, but since there are none, this is not a gap. The baseline for high schema coverage applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (clean up), the target (asset redirectors), and the context (in the project). It also references the underlying commandlet (FixUpRedirects), making the purpose unambiguous and distinct from other tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide any guidance on when to use this tool versus alternatives, nor does it mention prerequisites, side effects, or typical scenarios. Users must infer usage from the purpose alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_collisionC

Generate collision for a static mesh.

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNoCollision typeauto
mesh_pathYesStatic mesh asset path

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden for behavioral disclosure. It doesn't mention if the operation is destructive (replaces existing collision), requires specific permissions, or affects the asset's save state. It also doesn't clarify what the 'auto' type does or if it modifies the asset in place. This is insufficient for a tool that likely modifies assets.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, short sentence that directly states the purpose. It's appropriately concise and front-loaded, with no redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite full schema coverage and a clear verb, the description lacks crucial workflow context. For a tool that likely modifies assets, it doesn't mention if it's reversible, if it requires a loaded project, or if it's part of a larger pipeline. Sibling tools suggest this is an Unreal Editor automation tool, but without annotations or output schema, the description should explain more about what happens after generation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for both parameters. The description adds value by stating the action on 'mesh_path', but it doesn't add any additional meaning like format constraints or example paths. Since the schema is thorough, baseline 3 is appropriate; the description doesn't elevate it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the action (generate collision) and resource (static mesh) clearly, but it's brief and doesn't distinguish from sibling tools like validate_assets or import_asset, though it is unique among the listed siblings. It doesn't specify what type of collision or any further nuance, so it's clear but not detailed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. It doesn't mention prerequisites like the mesh being imported, or that this should be used before baking or cooking content. The description just says 'Generate collision' without context on scenarios or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_lightmap_uvsB

Generate lightmap UVs for a static mesh.

ParametersJSON Schema
NameRequiredDescriptionDefault
mesh_pathYesStatic mesh asset path

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations, so the description must disclose behavioral traits. It only states the action without mentioning side effects (e.g., modifying the mesh asset, overwriting existing UVs, need to save, or any destructive implications). This lack of transparency for a mutation-like tool is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that fully conveys the core purpose. No fluff or redundant information; every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema and no annotations, the description leaves critical gaps: it does not state whether the mesh asset is modified in-place, whether existing UVs are overwritten, any prerequisites (e.g., mesh must be static, accessible), or error conditions. Given the mutation-like nature, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description for mesh_path is 'Static mesh asset path', which is unambiguous. The tool description adds no further meaning beyond the schema, so baseline 3 is appropriate given 100% coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (generate lightmap UVs) and the target resource (static mesh). It is specific and distinguishes from sibling tools like generate_collision or apply_material, as no other tool mentions lightmap UV generation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, prerequisites, or conditions under which it should be invoked. The description is purely declarative without contextual usage instructions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_lodsB

Generate LODs for a static mesh.

ParametersJSON Schema
NameRequiredDescriptionDefault
lod_countNoNumber of LOD levels
mesh_pathYesStatic mesh asset path

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It only states 'Generate LODs' without disclosing whether existing LODs are overwritten, whether the mesh must be saved, or other side effects. This is insufficient for a mutation operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with no redundant information. It is well-structured and front-loaded, making it easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's mutation nature and lack of annotations or output schema, the description is too minimal. It doesn't explain the LOD generation process, requirements, or effects, leaving the agent without enough context for confident use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides complete descriptions for both parameters (lod_count and mesh_path). The description adds no additional parameter semantics beyond what the schema already includes, so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool generates LODs for static meshes, using a specific verb and resource. It distinguishes from sibling tools like set_skeletal_mesh_lod, which targets skeletal meshes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives. It doesn't mention prerequisites, differences from similar tools, or that it only applies to static meshes while set_skeletal_mesh_lod should be used for skeletal meshes.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generate_project_filesB

Regenerate IDE project files (Visual Studio, Xcode, Rider).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations (readOnly/destructive) are present, so the description carries full burden. It says 'Regenerate' which communicates a write operation, but does not disclose whether files are overwritten, if arbitrary settings/options are preserved, or if source paths are required. This is ambiguous for a regeneration action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One concise sentence, front-loaded with the core verb. No wasted words, no restating of schema because there is no schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description gives the tool's scope (IDE files for 3 named IDEs) and a rough action, but no output schema, no mention of file targets beyond IDE type, no prerequisites like opened project/solution, and no side-effects/consequences are explained. For a 0-param tool, it remains merely viable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema is empty with first-level schema coverage at 100%? Actually properties is empty (no params). Param info is irrelevant; the description adds parameter-specific operational details. Baseline 4 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description uses specific verb 'Regenerate' and resource 'IDE project files (Visual Studio, Xcode, Rider)', clearly distinguishing from sibling tools focused on execution or testing. However, it doesn't contrast with related project file tools like 'build_project' or 'package_project'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The usage context is implied: regenerate project files when needing to refresh IDE project structure. It lists target IDEs but gives no explicit when-to-use or when-not-to-use guidance, and doesn't name alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_actor_componentsA

List all components on an actor.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesActor name or label

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description bears full responsibility for disclosing behavior. It only states a read-only listing action, but does not mention what happens if the actor is not found, whether the list includes nested components, or any side effects. For a simple get operation, it adds minimal behavioral context beyond the name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no filler. It gets straight to the point, making it easy to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with one parameter and no output schema or annotations, the description gives the core purpose but omits return format (e.g., names, types), error behavior, and any filtering options. It is minimally viable but leaves gaps about what the returned list contains.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage for the single parameter 'name' is 100% (description: 'Actor name or label'), so the schema fully documents it. The tool description adds no extra meaning to the parameter, but since the schema already covers it, the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'List all components on an actor' clearly states the specific action (list) and the resource (components) with the target (actor). It effectively distinguishes itself from sibling tools like get_actor_properties (properties vs components) and list_actors (all actors vs components of one actor).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage: call this when you need to see components belonging to an actor. However, it provides no explicit guidance on when to use this versus alternatives, nor any exclusions or prerequisites. It doesn't mention whether the actor must exist or how it relates to tools like get_actor_properties.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_actor_propertiesA

Get all properties of an actor by name.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesActor name or label

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden. The verb 'Get' implies a read operation, but the description does not disclose behavior for edge cases (e.g., actor not found), return format, or whether the operation has side effects. For a simple getter, this is adequate but lacks explicit behavioral detail compared to more transparent descriptions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that immediately communicates the tool's purpose. It is appropriately sized for a simple getter operation, with no unnecessary words or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has one parameter, complete schema coverage, and no output schema or annotations. The description fully covers the purpose and input, making it self-contained for an agent. It could arguably mention return format, but given the simplicity and lack of output schema, the description is sufficiently complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100% (the parameter 'name' has a description 'Actor name or label'). The description of the tool itself adds no additional parameter semantics beyond this, so the baseline score of 3 per the rubric applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: 'Get all properties of an actor by name.' It uses a specific verb ('Get') and resource ('actor properties'), and distinguishes itself from sibling tools like get_actor_components and set_actor_property by focusing on properties rather than components or writes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage: it is for retrieving actor properties when needed. However, it provides no explicit guidance on when to prefer this tool over alternatives (e.g., get_actor_components) or when not to use it. The context of 'Get' suggests read-only retrieval, but no alternatives or exclusions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_anim_sequence_infoA

Get info about an animation sequence (length, frames, bone data).

ParametersJSON Schema
NameRequiredDescriptionDefault
sequence_pathYesAnimSequence asset path

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description clearly implies a read-only operation ('Get info') and gives some output categories, but it does not disclose error behavior, path validity requirements, or return format details. With no annotations, this is minimal but not misleading.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that conveys the tool's purpose and key output details with no filler or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter, no-output-schema tool, the description provides enough context: what it targets and what informational categories to expect. It could be stronger on error cases or path format, but the simplicity of the tool makes this adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter is fully described in the schema as an 'AnimSequence asset path', so the description adds no additional semantic value beyond the schema. This matches the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Get info') and resource ('animation sequence'), and enumerates the returned data categories (length, frames, bone data). The qualifier 'animation' helps distinguish it from the sibling get_sequence_info tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage context is implied: use this when you need metadata about an animation sequence. However, it does not explicitly state when not to use it, nor does it name alternatives such as get_sequence_info for non-animation sequences.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_asset_infoC

Get detailed metadata for an asset.

ParametersJSON Schema
NameRequiredDescriptionDefault
asset_pathYesAsset path (e.g., /Game/Meshes/MyMesh.MyMesh)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description says 'detailed metadata' but discloses no behavior beyond that. Since no annotations are provided, the description carries the full burden, and it fails to mention that this is a read-only operation, what specific metadata fields are returned, or how the tool behaves when the asset path is invalid. This leaves the agent guessing about the tool's actual behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is front-loaded and free of fluff. It earns high marks for conciseness, though the phrase 'detailed metadata' is vague and could be more informative without adding length.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that there is no output schema and no annotations, the description must compensate by explaining what 'detailed metadata' entails and what the return format is. It does neither. For a simple getter with one parameter, this is a significant gap: the agent cannot reliably know what information will be available after calling the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers the single parameter fully, including a clear description and example. The description adds no additional meaning beyond the schema, but per the rubric, high schema coverage (100%) yields a baseline of 3. There is no extra semantic value provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action ('Get') and target ('detailed metadata for an asset'), which is specific enough to distinguish it from sibling tools like list_assets. However, it doesn't explicitly contrast with similar asset-query tools such as search_assets or get_asset_references, so it falls short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description only states what the tool does, with no mention of use cases, prerequisites, or exclusions. Sibling tools like search_assets and get_asset_references occupy overlapping space, but no differentiation is given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_asset_referencesB

Get the dependency and referencer graph for an asset.

ParametersJSON Schema
NameRequiredDescriptionDefault
directionNoboth
asset_pathYesAsset package path (e.g., /Game/Meshes/MyMesh)

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It does not disclose whether the graph is direct or transitive, whether it includes both hard and soft references, or what the response structure looks like. The term 'graph' is vague without further context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that immediately states the action and subject, with no unnecessary words or filler. It is efficiently front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no output schema and no annotations, the description needs to convey more about the graph semantics (depth, format, inclusivity). A two-parameter tool still requires explanation of what 'dependency and referencer graph' entails to be fully usable.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds no parameter-level meaning. asset_path is minimally described in the schema, and direction is only self-evident through its enum values. With 50% schema coverage, the description should compensate but does not.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('Get') and resource ('dependency and referencer graph for an asset'). It distinguishes itself from siblings like get_asset_info and search_assets by focusing on graph relationships.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The intended usage is implied—when you need to know an asset's dependencies or referencers—but no explicit alternatives or when-not-to-use guidance is given. It does not contrast with similar content-auditing tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_blueprint_infoB

Get Blueprint info: class, variables, functions, components, and graphs.

ParametersJSON Schema
NameRequiredDescriptionDefault
blueprint_pathYesBlueprint asset path

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries the full burden. It states what info is retrieved but does not disclose that the operation is read-only, whether any errors are possible, or what happens if the blueprint_path is invalid. Even though 'Get' implies a query, the description lacks explicit behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that front-loads the core purpose and lists the included info categories. No redundant or filler content exists.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is no output schema, so the description must convey return value expectations. It lists five key categories (class, variables, functions, components, graphs), which gives a reasonable sense of the response content. However, it does not specify the format or nesting, which keeps it just short of complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema fully documents the only parameter, blueprint_path, with its description 'Blueprint asset path'. The description adds no additional meaning beyond the schema, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Get') and the resource ('Blueprint info'), and enumerates the specific categories of information included (class, variables, functions, components, graphs). This distinguishes it from sibling tools like get_asset_info or get_actor_properties, which target different resources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It does not mention contexts such as inspecting a Blueprint before editing, nor does it exclude cases like non-Blueprint assets. The agent must infer usage from the name and description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_build_statusB

Parse the last build output and return structured errors, warnings, and progress.

ParametersJSON Schema
NameRequiredDescriptionDefault
build_logYesRaw build log output to parse for errors and warnings

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It does not clarify whether this is a safe read operation, whether side effects occur, or what happens on malformed input. The phrase 'the last build output' is ambiguous — unclear if the tool maintains state or if 'last' refers to the provided log. The description presents the function as a pure parser, but this is implied rather than explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tightly written clauses pack in the verb, resource, and output type without waste. Every word earns its place; it is efficiently front-loaded and instantly scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given an extremely simple single-parameter tool with no output schema and no annotations, the description is mostly adequate but relies heavily on the agent assuming this is a pure function. It never explains the error format for unparseable input, or whether the original raw log is returned alongside structured errors. For a tool with this complexity, the description is acceptable but leaves edge-case behavior to the agent's imagination.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so a baseline of 3 applies. The description adds value by telling the agent that the `build_log` parameter is the raw input to be parsed for structured output, effectively linking the parameter to its purpose. While not drastically exceeding schema, it does reinforce the parsing semantics and the return shape, justifying a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Parse' with the resource 'the last build output' and what it returns: 'structured errors, warnings, and progress.' This distinguishes it from siblings. However, the tool name suggests 'get' (fetch status) while the description emphasizes parsing raw log input, creating a mild name/description mismatch that costs a point.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No usage guidance is provided. The description does not state when to use this tool instead of siblings like `get_test_results` or `build_target`, nor does it mention prerequisites (e.g., that a build must have been run first). Clear context is implied but not stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_connection_statusA

Check which Unreal Engine transports are currently connected (Remote Control, Python, Plugin Bridge).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full behavioral burden and does so well by specifying the exact transports interrogated (Remote Control, Python, Plugin Bridge), which adds concrete disclosure beyond a generic status check. However, it does not describe edge cases like the behavior when no transports are connected or the return value shape, which would round out transparency for this zero-annotation scenario.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single 14-word sentence that front-loads the action and resource, with the parenthetical efficiently enumerating the specific transports. Every word earns its place; no wasted verbiage or irrelevant details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given its low complexity (0 params, no schema, no annotations), the description covers the essential purpose fully, and the sibling list containing `sc_status` and `get_build_status` highlights how the explicit transport list helps disambiguate. However, it could note return value semantics (e.g., does it return a simple boolean, a list, etc.) since no output schema exists, which would make it fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the schema provides no room for ambiguity. Per the rubric, 0 parameters merits a baseline score of 4, and the description appropriately avoids inventing parameter details that don't exist.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Check') and resource ('Unreal Engine transports currently connected'), and lists the exact transports (Remote Control, Python, Plugin Bridge) that distinguish it from siblings like `get_build_status` and `sc_status`. The parenthetical adds precision without ambiguity, making its purpose immediately clear.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage through its imperative 'Check' but provides no explicit guidance on when to use this tool versus alternatives, nor does it name any sibling for comparison. For a simple status-check tool, the usage context is fairly self-evident from the name and description, but the rubric's requirement for explicit when/when-not/alternatives is not met.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_loaded_cellsA

Query currently loaded world partition cells.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description only states 'Query' without disclosing behavioral traits such as whether it is read-only, performance implications, or what constitutes 'currently loaded' cells. The agent gets no additional context beyond the tool name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, tightly worded sentence with no fluff. Every word contributes to stating the tool's purpose, making it highly concise and front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is minimal but sufficient for a simple query tool with no parameters and no output schema. However, it omits any detail about the return format or what constitutes 'currently loaded' cells, leaving some ambiguity for the agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, and the schema is empty with 100% coverage (vacuously). Per guidelines, a no-parameter tool receives a baseline score of 4, and the description adds no parameter details because none are needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (Query) and the resource (currently loaded world partition cells). It is specific and distinguishes itself from sibling tools, none of which appear to query loaded cells.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No indication of when to use this tool versus alternatives, no prerequisites, no exclusions, and no mention of alternative query methods. The user is left to infer usage context from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_preset_infoB

Get details of a Remote Control Preset (exposed properties and functions).

ParametersJSON Schema
NameRequiredDescriptionDefault
preset_nameYesPreset name

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It correctly implies a read-only operation and clarifies the semantic scope of 'details' with the parenthetical, but it doesn't address potential errors (e.g., nonexistent preset), behavior expectations, or any side effects. For a three-word schema ('Preset name'), the description does add resource-type context, but the behavioral disclosure is minimal—comparable to a middling description for an unannotated tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single 13-word sentence that front-loads the verb 'Get' and wastes zero words. The parenthetical efficiently disambiguates what kind of details are returned. Every word earns its place; this is a model of concise description writing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a low-complexity tool (1 param, simple read operation, no enums or nested objects), the combination of description and full schema coverage paints a complete enough picture. The description explains what's returned (exposed properties and functions) and the schema documents the parameter fully. The only gaps are edge behaviors like error handling for invalid preset names, but for a simple getter with no output schema required, this is appropriately complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% ('Preset name' for preset_name), so the baseline is 3 per the rubric. The tool description adds no parameter-level semantics beyond what the schema already provides, but it doesn't need to—the schema fully documents the only parameter. This is a case where the schema does the heavy lifting and a 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb+resource construction ('Get details of a Remote Control Preset') and the parenthetical ('exposed properties and functions') scopes what 'details' means. It implicitly differentiates from sibling tools like get_preset_property and call_preset_function by indicating the full set of exposed items is returned, though it never explicitly names or contrasts these alternatives. The differentiation is functional but implicit, keeping this just shy of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given about when to use this tool versus the many related siblings (get_preset_property, call_preset_function, list_presets). While one could infer a workflow of inspecting a preset's exposed members before acting on them, the description never states this. Sibling context suggests a natural 'get info before getting/setting properties' flow, but that connection is left entirely to the reader.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_preset_propertyB

Get a property value exposed via a Remote Control Preset.

ParametersJSON Schema
NameRequiredDescriptionDefault
preset_nameYesPreset name
property_nameYesExposed property name

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It states the action but does not disclose any behavioral traits such as whether the property is read-only, what happens if the property doesn't exist, or any side effects. For a getter, this is minimal but acceptable; however, it lacks detail on error behavior or return format.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that front-loads the purpose. No wasted words, and it is appropriately sized for a simple getter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (2 params, no output schema, no nested objects), the description is adequate but not rich. It doesn't mention what the return value looks like or any prerequisites, but for a basic getter with full schema coverage, it meets the minimum viable threshold.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters. The description adds no extra meaning beyond the schema, but the baseline is 3 given high coverage. It doesn't clarify the relationship between preset_name and property_name or any constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool gets a property value from a Remote Control Preset, using a specific verb and resource. It distinguishes from siblings like set_preset_property and call_preset_function, though it doesn't explicitly contrast them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for reading exposed properties from a preset, but provides no explicit guidance on when to use this vs. alternatives like get_preset_info or set_preset_property. Context is clear but exclusions are absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_sequence_infoA

Get full structure of a level sequence (bindings, tracks, sections).

ParametersJSON Schema
NameRequiredDescriptionDefault
sequence_pathYesLevelSequence asset path

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden of disclosing behavior. The verb 'Get' clearly implies a read-only, non-mutating operation, and it discloses what information will be returned. It does not explicitly state that no modifications occur, but for a simple getter this is reasonably transparent. It also does not discuss error conditions or permissions, but these are less critical for a read operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that is front-loaded with the action and resource. It includes useful clarifications (bindings, tracks, sections) without unnecessary verbiage. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one parameter and no output schema. The description explains what the tool returns at a high level and gives examples. It covers the essentials adequately for the tool's complexity. While it might mention potential errors or exact output format, these are not required for a straightforward getter, especially given the high schema coverage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage for the single parameter 'sequence_path', which already states it is a 'LevelSequence asset path'. The description adds 'level sequence' context but does not provide any additional meaning beyond the schema. Baseline 3 is appropriate when the schema already documents parameters fully.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Get') and clearly identifies the resource ('full structure of a level sequence') with concrete examples (bindings, tracks, sections). This clearly distinguishes it from sibling tools like create_level_sequence or add_track, and from the similar get_anim_sequence_info which targets animation sequences, not level sequences.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool (when you need the structure of a level sequence) but does not explicitly state exclusions or alternatives. Sibling tool get_anim_sequence_info exists, but the description does not mention that distinction. It provides clear context but lacks explicit when-not-to-use guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_test_resultsB

Get the results of the last automation test run.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. However, it only says 'get the results' with no mention of side effects, permissions, or what happens if no test has run. It implicitly implies read-only behavior but does not explicitly state any absence of side effects or error conditions. For a getter, this is thin.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence with no redundancy or fluff. It perfectly captures the tool's function without wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no parameters and no output schema, the description is minimally sufficient, but it lacks context such as what 'results' include (e.g., pass/fail counts, logs), whether the tool is read-only or triggers any side effects, and how it relates to the various automation test runner siblings. For a getter with zero params, this is acceptable but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parametersyears, so the input schema is complete with no undeclared parameters. Per the rubric, a zero-parameter tool gets a baseline score of 4 since there is no missing parameter documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly specifies the action (get) and the resource (results of the last automation test run). It distinguishes itself from siblings like 'run_automation_tests_by_category' or 'list_automation_tests' by focusing on retrieval rather than execution or listing. However, it could be slightly more specific about what constitutes a 'test run' (e.g., single test or suite), so not a perfect 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, no prerequisites, and no exclusions. It simply restates the tool's name. There is no mention of needing to run tests first or any context where this should be preferred over other getters.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_undo_historyA

Get the undo/redo transaction history.

ParametersJSON Schema
NameRequiredDescriptionDefault
countNoNumber of recent transactions to return

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description does not disclose any behavioral traits such as side effects, permissions, or error handling. It is a simple get operation, but the lack of any transparency lowers the score.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence with no unnecessary words. It is front-loaded with the verb and clearly conveys the purpose without fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is minimal and does not explain the output format, the range of the history, or any edge cases. Given the simple nature of the tool, it is adequate but leaves room for more context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already fully describes the 'count' parameter with a clear description. The tool description does not add additional meaning beyond what the schema provides, so the baseline for high schema coverage applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (get) and the resource (undo/redo transaction history), which distinguishes it from sibling tools like undo and redo that perform actions rather than retrieve history.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for retrieving undo/redo history but does not explicitly state when to use it over alternatives like undo or redo, nor does it mention any preconditions or context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_viewport_cameraA

Get the current editor viewport camera location and rotation.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries the full burden. It discloses the read-only nature via 'Get', but does not add context about coordinate systems, units, or edge cases such as when no viewport is open. For a simple getter, this is adequate but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that efficiently conveys the action and object. No redundant words or information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a parameterless getter with no output schema, the description adequately states what is returned (location and rotation). However, it lacks details on the return format (e.g., vectors, rotators) or coordinate space, which is a minor gap for an agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the baseline of 4 applies. The schema is trivially complete, and no additional parameter documentation is required.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool 'Get the current editor viewport camera location and rotation' with a specific verb and resource. It distinguishes from the sibling set_viewport_camera by clarifying it retrieves, not sets, the camera state.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The implied usage is to read current camera data, but there is no explicit guidance on when to use it, when not to, or alternatives like set_viewport_camera. The description provides contextual clarity but lacks exclusions or explicit recommendations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

import_assetB

Import an external file (FBX, PNG, WAV, etc.) into the project.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_fileYesPath to the file on disk to import
destination_pathYesContent directory to import into (e.g., /Game/Meshes)

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations, so the description carries the full burden. It only states the action without disclosing side effects (e.g., whether it overwrites existing assets), potential failures, or requirements. This leaves the agent blind to behavioral implications of invoking the import.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that front-loads the action and examples. There is no redundancy or unnecessary verbiage, making it appropriately concise for a simple import tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity and complete schema coverage, the description still lacks context about expected outcomes, supported file formats' constraints, or error handling. Without an output schema, the description should clarify what happens after import, but it does not, leaving a notable gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with each parameter already documented (source_file as a path and destination_path as a content directory). The description adds format examples but does not elaborate on parameter semantics or provide additional details beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool imports external files into the project, using a specific verb ('Import') and resource ('external file... into the project'). It lists example formats (FBX, PNG, WAV) and distinctly contrasts with sibling tools like export_asset (reverse direction) and reimport_skeletal_mesh (specific to skeletal meshes).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, scenarios, or exclusions. For example, it does not indicate whether this should be used for initial imports only, or how it relates to reimport tools. The agent must infer usage from context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_actorsB

List all actors in the current level, optionally filtered by class.

ParametersJSON Schema
NameRequiredDescriptionDefault
name_filterNoFilter by name substring
class_filterNoFilter by actor class (e.g., StaticMeshActor, PointLight)

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It implies a read-only operation but does not state side effects, return format, whether sublevel actors are included, or any other behavioral traits. More transparency is needed for a tool with no annotation support.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence with no filler. It front-loads the primary action and resource, making it easy to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite the tool's simplicity, the description lacks essential context for an agent: it does not mention the return format (e.g., actor paths, names), any caveats about what 'all actors' includes, or the existence of name_filter. Without an output schema or annotations, these gaps remain unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides full descriptions for both parameters (name_filter and class_filter), giving 100% coverage. The description adds little semantic value beyond mentioning class filtering, and it omits the name_filter parameter, but the schema itself compensates adequately.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'list' with a clear resource 'actors in the current level' and an optional filter. This clearly distinguishes it from sibling tools like spawn_actor, delete_actor, or get_actor_properties, and the scope is well-defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool by stating it lists actors in the current level, but it provides no explicit guidance on when to prefer it over alternatives or any exclusions. It does not mention when to use it vs. tools like select_actors or get_actor_properties.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_assetsA

List assets in a content directory with optional class filter.

ParametersJSON Schema
NameRequiredDescriptionDefault
directoryNoContent directory path (e.g., /Game, /Game/Meshes)/Game
recursiveNoInclude subdirectories
class_filterNoFilter by asset class (e.g., StaticMesh, Material, Blueprint)

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits, but it only says 'list assets,' providing no insight into return format, side effects (if any), or behavior beyond the obvious. It does not describe what the response looks like or any nuances.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence, front-loaded with the action and resource, and contains no filler. It is appropriately sized for a simple tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple, but with no output schema, the description should at least hint at the return format. It doesn't mention what the list contains (e.g., asset paths, names), nor does it note the recursive default. It is minimally adequate but has gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the parameters are already well-defined. The description adds minimal value by mentioning the optional class filter, but it doesn't elaborate on directory or recursive behavior beyond what the schema provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists assets in a content directory with an optional class filter. This distinguishes it from related tools like search_assets (which searches) and get_asset_info (which gets details).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies a straightforward listing operation but provides no explicit guidance on when to choose this over alternatives like search_assets. It does not state when not to use it or mention sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_automation_testsB

List available automation tests in the project.

ParametersJSON Schema
NameRequiredDescriptionDefault
filterNoFilter tests by name substring

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for disclosing behavior. It simply states the action but does not explicitly indicate that it is a read-only operation, mention potential output format, or note any side effects or performance considerations. The minimal wording provides minimal transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with zero fluff. It is front-loaded and perfectly sized for the tool's simplicity, earning a high score for conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with one optional parameter and no output schema. The description is minimal but adequate for the core action. However, it lacks any indication of the return structure (e.g., list of names) or whether the filter is case-sensitive, which would enhance completeness for a listing operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers the single optional parameter 'filter' with a description ('Filter tests by name substring'), so the description adds no further semantic value. Since schema coverage is 100%, the baseline of 3 is appropriate; the description does not need to elaborate beyond what the schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'List available automation tests in the project' uses a specific verb ('List') and a clear resource ('automation tests'), making the purpose unambiguous. It distinguishes itself from siblings like run_automation_test and run_all_automation_tests by focusing on listing rather than executing.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It does not mention complementary tools like run_automation_test or run_automation_tests_by_category, nor does it describe scenarios where listing would be appropriate (e.g., before executing tests).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_data_layersA

List all data layers in the current World Partition level.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description implies a read-only operation but does not explicitly state side effects, permissions, or limitations. Without annotations, it only partially covers transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no unnecessary words, perfectly concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple parameterless listing operation, the description is complete; it explains what it does, and since there is no output schema, return values need not be detailed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, and the schema coverage is 100% (empty), so the description adds nothing beyond the schema, meeting the baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (list), the resource (data layers), and the context (current World Partition level), effectively distinguishing it from sibling tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not explicitly mention when to use this tool over alternatives or any exclusions, though the simple nature of listing makes its purpose self-evident.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_graph_nodesA

List all nodes in a Blueprint's event graph.

ParametersJSON Schema
NameRequiredDescriptionDefault
blueprint_pathYesBlueprint asset path

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. The verb 'List' implies a read-only operation, and the scope ('all nodes in a Blueprint's event graph') adds context, but the description does not explicitly state non-mutating behavior, error handling, output format, or ordering. This is acceptable for a simple list but lacks depth.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is one concise sentence of eight words, directly stating the tool's function. It is front-loaded, contains no redundant information, and is appropriately sized for a straightforward listing operation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no output schema), the description covers the core purpose but omits information about the return value (e.g., what node data is included) and any prerequisites like requiring a valid Blueprint path. This could hinder an agent that needs to chain this with graph manipulation tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter blueprint_path is already fully described in the schema as 'Blueprint asset path' (100% coverage). The tool description adds no extra meaning about the parameter beyond what the schema provides, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists all nodes in a Blueprint's event graph. The verb 'List' and the resource 'nodes in a Blueprint's event graph' are specific and differentiate it from graph mutation tools like add_graph_node or remove_graph_node.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives such as get_blueprint_info or add_graph_node. It does not mention use cases, prerequisites, or exclusions, leaving the agent to infer its role solely from the name and one-sentence description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_material_expressionsB

List all expression nodes in a material.

ParametersJSON Schema
NameRequiredDescriptionDefault
material_pathYesMaterial asset path

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are supplied, so the description carries the full burden. It only states the action and does not disclose return format, read-only behavior, error conditions, or any side effects. The agent is left without clear behavioral expectations beyond a basic listing operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no filler, front-loading the verb and resource. Every word earns its place, making it highly concise and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple one-parameter schema and no output schema, the description is minimally viable but incomplete. It does not describe the return value structure or any operational details, which would be expected for a tool with no annotations or output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter material_path is already described in the schema ('Material asset path') with 100% coverage. The description adds no further semantic detail, but schema coverage is high, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description precisely states the action ('List all expression nodes in a material') with a clear verb and resource scope. It differentiates from sibling tools like create_material_expression or delete_material_expression by focusing solely on enumeration.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as list_graph_nodes or when not to use it. Prerequisites like a valid material asset are not mentioned, leaving the usage context implied rather than explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_pluginsA

List installed plugins and their enabled status.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for behavioral disclosure. It conveys the read-only nature and output concept (list with enabled status), but gives no details on return format, error conditions, or preconditions. For a zero-parameter list tool, this is minimally sufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence with no filler. It front-loads the action and scope, making it highly concise and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool (no parameters, no output schema, no annotations), the description is nearly complete. It could be slightly more explicit about what the output looks like, but it covers the essential purpose adequately.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, and the baseline for zero-parameter tools is 4. The description doesn't need to elaborate on parameter semantics since the schema is empty and coverage is effectively complete.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function with a specific verb ('List'), a resource ('installed plugins'), and an added detail ('their enabled status'). It naturally distinguishes itself from sibling tools like enable_plugin and disable_plugin.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when-to-use or alternatives are provided, but the purpose is straightforward enough that usage is implied. The description doesn't mislead, but it also doesn't offer any guidance beyond the basic function.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_presetsA

List all Remote Control Presets in the project.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. The description clearly states it lists all presets in the project, implying a read-only aggregation operationaine. It doesn't mention any side effects, performance implications, or output details, but for a list operation, that's acceptable. It doesn't contradict anything, and the name 'list' suggests non-destructive behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that clearly states the action and scope. Zero wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple with no parameters, so the description is sufficient. It could mention that it returns a list, but that's implied. No annotations to add more context, but the simplicity means completeness is high.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, and the schema covers 100% of parameters (none). So no extra explanation is needed. The description accurately reflects the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (list), the resource (Remote Control Presets), and the scope (all in the project). It is specific and distinguishes from sibling tools like get_preset_info which focuses on a single preset, and set/get preset properties which modify or query individual properties.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly tells when to use this tool: to list all presets in the project. It doesn't explicitly mention alternatives or exclusions, but the purpose is clear enough that an agent can infer it's for broad enumeration rather than targeting specific presets. Sibling tools like get_preset_info suggest differentiation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

package_projectA

Package the project for distribution. Runs build + cook + stage + package.

ParametersJSON Schema
NameRequiredDescriptionDefault
platformNoTarget platform
compressedNoCompress pak files
configurationNoBuild configuration (typically Shipping for distribution)Shipping

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does disclose the multi-step behavior by stating 'Runs build + cook + stage + package.' However, it omits side effects, prerequisites, output locations, or whether the process mutates the project, leaving meaningful behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences, front-loads the main purpose, and includes the essential pipeline detail without wasted words. Every sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers the core action and pipeline, which is adequate for basic selection, but there is no output schema, no annotations, and no mention of what the packaged output looks like or what side effects occur. For a multi-stage packaging tool, this leaves notable gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all three parameters clearly. The description itself adds no parameter-level meaning, so the schema-heavy baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb and resource, 'Package the project for distribution,' and clarifies the composite nature of the operation by listing the pipeline stages: build + cook + stage + package. This clearly distinguishes it from sibling tools like build_cook_run or cook_content.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'for distribution' provides a clear use case, and the stage list implies a full end-to-end pipeline rather than a single build or cook step. It does not explicitly name alternatives or state when not to use it, but the context is reasonably clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

recompile_materialA

Recompile a material after making changes to its graph.

ParametersJSON Schema
NameRequiredDescriptionDefault
material_pathYesMaterial asset path

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must disclose behavioral traits. It only states the action and trigger, without mentioning side effects, potential errors, prerequisites, or the outcome of the recompile. This is minimal disclosure for a mutation-like operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no redundant information. It efficiently conveys the tool's purpose and trigger without unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple one-parameter tool, the description covers the core purpose and usage context. However, it lacks behavioral details such as error handling, async behavior, or postconditions, which would be valuable given no annotations or output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema fully describes the single parameter (material_path) with 100% coverage. The description adds no additional parameter semantics, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (recompile), the resource (material), and the trigger condition (after making changes to its graph). This distinguishes it from sibling tools like compile_blueprint and material graph editing functions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear usage context by specifying 'after making changes to its graph', indicating when the tool is appropriate. It does not explicitly name alternatives or exclusions, but the context is sufficient for basic differentiation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

redoB

Redo the last undone editor action.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden, but 'Redo the last undone editor action' adds minimal insight beyond the tool's name. It doesn't disclose what happens when there's nothing to redo, whether the action clears the redo stack, or any side effects on the undo history.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with no wasted words - front-loaded and appropriately sized for a zero-parameter tool. A slight deduction for being at the edge of under-specification, though the simplicity of the tool mitigates this.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple zero-parameter redo tool, the description is minimally viable but leaves gaps. It doesn't mention the relationship to `undo`, behavior when the redo stack is empty, or what the return value indicates. Given the complexity is low, a 3 is fair.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so schema coverage is trivially 100% with nothing for the description to clarify. Per the rubric, 0 params earns a baseline of 4, and no deduction is warranted.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb+object construction ('Redo the last undone editor action') that clearly identifies the operation. However, it doesn't explicitly differentiate from sibling tools like `undo` or `get_undo_history`, though the redo/undo pairing is strongly implied.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool vs. alternatives like `undo` or `get_undo_history`. The tool could have mentioned that it follows an undo operation or that it only works after an undo has occurred, but no such context is given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

reimport_skeletal_meshB

Reimport a skeletal mesh from its source file.

ParametersJSON Schema
NameRequiredDescriptionDefault
mesh_pathYesSkeletal mesh asset path

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations to lean on, the description carries full responsibility for disclosing behavior. It fails to mention that reimporting will overwrite the existing mesh data, that the source file must be resolvable, or what happens if the source is missing or the asset is not a skeletal mesh. The description is largely a restatement of the tool name.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single, clear sentence that front-loads the action and object. No wasted words, and the parenthetical is unnecessary. Perfectly concise for the minimal information it provides.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter tool with no output schema, the description is minimally adequate. The agent can infer the primary use case. However, it doesn't clarify that reimport replaces existing mesh data (potential side effect), whether the source path is stored in the asset, or what the return value indicates. Could be improved with a note like 'Overwrites the existing asset's data from its source file'.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the only param 'mesh_path' documented as 'Skeletal mesh asset path'. The description adds no additional semantics beyond the schema, so the baseline of 3 is appropriate. There is no format, example, or path syntax guidance added.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('reimport') with a clear resource ('skeletal mesh') and the source of truth ('its source file'). It clearly distinguishes the intent from sibling 'import_asset' by using 're-' to imply updating an existing asset, though it doesn't explicitly name the alternative.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given on when to use this tool versus alternatives like 'import_asset' or when a reimport is preferred over a fresh import. There are no implied prerequisites, no mention of whether the asset must already exist or be selected, and no exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

reinit_niagara_systemC

Reinitialize a Niagara system on an actor.

ParametersJSON Schema
NameRequiredDescriptionDefault
actor_nameYesActor with Niagara component

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations to rely on, so the description must disclose behavioral traits itself. It only says what the tool does, not any side effects, prerequisites, or whether the operation is reversible. For a potentially mutating operation (reinitialize), it should at least mention that it resets to initial state or similar, but it does not.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, lean sentence that directly states the purpose with no fluff or redundancy. It is appropriately front-loaded and every word contributes to meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of annotations and output schema, the description must carry more weight. It is too brief to fully explain the tool's behavior, usage context, or relationship to similar tools. For a simple tool with one parameter, it might be minimally acceptable, but the presence of 'reset_niagara_system' as a sibling raises ambiguity. The description does not offer enough to resolve that, making it incomplete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers 100% of the parameter descriptions, including 'Actor with Niagara component', so the schema already explains the parameter. The tool description adds no new parameter information beyond implying the actor is the target. Per the rubric, baseline 3 is appropriate when schema coverage is high, and the description does not add value beyond that.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Reinitialize') and the resource ('a Niagara system on an actor'). It is specific enough to distinguish it from general tools like 'spawn_niagara_*' or 'set_niagara_*', but it does not explicitly differentiate from the sibling tool 'reset_niagara_system', which could be similar. Thus it is clear but lacks explicit differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention prerequisites, exclusions, or situations where a different tool would be more appropriate. The only context is implicit in the purpose, but there is no explicit usage guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

remove_graph_nodeA

Remove a node from a Blueprint graph. Requires the optional C++ plugin.

ParametersJSON Schema
NameRequiredDescriptionDefault
node_idYesNode ID to remove
blueprint_pathYesBlueprint asset path

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the burden of disclosing behavioral traits. It adds the prerequisite that the optional C++ plugin is required, which is useful. However, it does not disclose consequences like potential disconnection of edges, irreversibility, or error behavior, which would be relevant for a removal operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences, front-loaded with the main purpose and followed by an essential requirement. Every word earns its place with no redundancy or fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple two-parameter tool with full schema coverage and no output schema, the description adequately states the core action and a critical prerequisite (plugin). It might benefit from noting return behavior or failure modes, but given the simplicity, it is reasonably complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with both parameters described ('Node ID to remove' and 'Blueprint asset path'). The description itself adds no extra parameter semantics beyond what the schema already provides, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Remove') and resource ('node from a Blueprint graph'), clearly distinguishing it from sibling tools like add_graph_node, connect_graph_nodes, and list_graph_nodes. No ambiguity about what the tool does.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The purpose implies usage (when you need to remove a node), but there is no explicit when-to-use vs alternatives or any exclusions. The plugin requirement is a prerequisite, not a usage guideline. This is implied usage rather than explicit guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

rename_assetC

Rename or move an asset.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_pathYesCurrent asset path
destination_pathYesNew asset path

TDQS

C2.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

There are no annotations, so the description must fully disclose behavioral traits. 'Rename or move' implies mutation but provides no details about side effects, such as whether references are updated, whether paths must be within the same directory, or whether the operation is reversible. This is a significant gap for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single short sentence, which is efficient, but it is under-specified. It does not mention path handling, behavior on failure, or relationship to siblings. It is not as empty as a pure tautology, but it scores lower than a well-structured description that includes tradeoffs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that this is a mutation tool with no annotations and no output schema, the description must compensate. It does not explain what happens to the asset's references, whether both paths must exist, or the meaning of failure. The presence of many asset-related sibling tools increases the need for contextual differentiation, which is absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage for both parameters ('Current asset path' and 'New asset path'), so the schema already conveys the meaning. The description adds no additional semantic value beyond what the schema provides. The baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the verb and resource: 'Rename or move an asset.' This is clear but does not differentiate from sibling tools like duplicate_asset or delete_asset. It lacks any scoping details (e.g., what counts as a move vs. rename) that would help an agent choose this tool over others.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description does not mention exclusions, prerequisites, or compare with sibling tools like duplicate_asset or delete_asset. The agent is left to infer from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

render_sequenceB

Queue a Movie Render Queue job for a sequence.

ParametersJSON Schema
NameRequiredDescriptionDefault
sequence_pathYesLevelSequence asset path
output_directoryNoOutput directory for rendered frames

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of disclosing behavior, but it only says 'queue a job.' It does not indicate whether the operation is asynchronous, what happens on success or failure, or whether it returns any job identifier or status.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence with no filler or redundancy. It is appropriately concise for the simple tool it describes.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description is minimal. It does not explain whether the call blocks, returns a job ID, or how to check status. Lacks essential behavioral context for an agent to use effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Both parameters (sequence_path and output_directory) have descriptions in the schema, fulfilling the baseline. The tool description itself adds no additional meaning or usage details beyond what's in the schema, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (queue a render job) and the specific resource type (Movie Render Queue) for a given sequence. It distinguishes from sibling tools like export_sequence_fbx or set_playback_range by focusing on the rendering queue workflow.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, such as needing an open project or a valid sequence, nor does it contrast with other sequence-related tools that might be more appropriate for certain tasks.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

resave_packagesB

Bulk resave all packages in the project (runs ResavePackages commandlet).

ParametersJSON Schema
NameRequiredDescriptionDefault
directoryNoLimit to a specific content directory

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of disclosing side effects. It only states the action 'resave' without mentioning potential consequences like file overwrites, time consumption, or impact on the asset registry. This lack of transparency could surprise users.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that immediately conveys the tool's purpose. It is front-loaded and efficient, containing no redundant information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one optional parameter, the description adequately states the action. It does not explain return behavior, but no output schema exists, so that is not required. It could mention possible failures or limitations, but overall it is sufficiently complete given its simplicity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers the single optional parameter 'directory' with a clear description. The tool description adds no additional meaning or constraints, but since schema coverage is 100%, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: 'Bulk resave all packages in the project' and references the specific commandlet. It distinguishes itself from sibling tools by focusing on resaving, which is distinct from validation, fixing, or building operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It does not mention typical scenarios (e.g., after engine upgrades) or why one might prefer it over other asset management tools. The description is purely functional without contextual usage instructions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

reset_niagara_systemC

Reset a Niagara system on an actor.

ParametersJSON Schema
NameRequiredDescriptionDefault
actor_nameYesActor with Niagara component

TDQS

C2.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It doesn't disclose whether this is a safe idempotent operation, whether it affects ongoing simulations, or if it requires specific conditions. The difference between 'reset' and 'reinit' remains unclear to the agent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is one concise sentence that front-loads the purpose. It is efficient and free of fluff, though it could add a bit more context without being verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations and no output schema, the description is minimal. For a tool that likely performs a mutation (reset), the lack of behavioral context and disambiguation from reinit_niagara_system makes it incomplete. The tool is relatively simple, but the ambiguity is significant.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of parameters with a description for actor_name. The description adds nothing beyond that, but the schema is complete. According to guidelines, baseline 3 is appropriate when schema has full coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Reset a Niagara system on an actor' clearly states the action (reset) and target (Niagara system on an actor). It distinguishes from siblings like reinit_niagara_system and spawn_niagara_at_location, though it doesn't explicitly contrast them. It is a bit vague about what 'reset' entails compared to 'reinit'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this vs alternatives like reinit_niagara_system. The description provides no context, prerequisites, or exclusion criteria. The user is left guessing about the difference between reset and reinit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_all_automation_testsC

Run all automation tests.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

C2.5/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description gives no information about side effects, return values, or any observable behavior beyond stating that it runs tests. No annotations are present to indicate safety or impact.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise, consisting of a single short sentence that conveys the core purpose without any fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is too minimal; it lacks context about the scope of 'all tests', potential outcomes, or how it fits into the broader set of test tools. It does not provide enough information for a user to understand the tool's full behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has no parameters, so there is nothing to explain. The description adds no parameter-specific information, but since the schema has no parameters, this is acceptable.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool runs all automation tests, but it does not specify how this differs from running individual tests or other test-related tools, so it is slightly ambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No usage guidelines are provided; the description does not indicate when to use this tool instead of alternatives like run_automation_test or run_map_check, nor any prerequisites or caveats.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_automation_testC

Run a specific automation test by name.

ParametersJSON Schema
NameRequiredDescriptionDefault
test_nameYesTest name or pattern to run

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states that it runs a test, but does not explain any side effects, whether it returns results, or whether it is synchronous. This is minimal and insufficient for understanding the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no redundant words, effectively front-loading the core purpose. It is appropriately concise for a tool with one parameter.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool lacks an output schema and has no annotations, yet the description does not mention what the tool returns or how results are communicated. It also fails to position itself within the family of automation test tools, making it incomplete for an agent to use confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes the parameter 'test_name' with 100% coverage, so the baseline is 3. The description's 'by name' adds little beyond simply restating the schema, providing no additional semantic value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Run') and the resource ('specific automation test'), with the qualifier 'by name' distinguishing it from tools that run by category or all tests. However, it does not explicitly resolve the ambiguity between a single test name and a pattern as indicated in the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus similar sibling tools such as run_automation_tests_by_category or run_all_automation_tests. There is no mention of alternatives or exclusions, leaving the agent to infer usage from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_automation_tests_by_categoryB

Run automation tests matching a category pattern.

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryYesTest category pattern (e.g., 'Project.Functional', 'Engine.Rendering')

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It does not disclose whether this is a long-running operation, whether it blocks, what happens on failure, or any side effects. The description only states the action without behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, concise and front-loaded with the action. It is appropriately sized for a simple tool, though it could include a brief note on behavior without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no output schema), the description is adequate but lacks behavioral details like execution time, result reporting, or error handling. It is complete enough for basic selection but not for anticipating outcomes.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for the single parameter, and the description adds a concrete example of the pattern format. However, it doesn't explain how the pattern is matched (e.g., wildcard, regex) or what happens if no tests match, so it adds minimal value beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool runs automation tests matching a category pattern, with a specific verb and resource. It distinguishes from siblings like run_automation_test (singular) and run_all_automation_tests (all) by implying a filtered subset, though it doesn't explicitly name them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for running a subset of tests by category, but does not explicitly state when to use this over run_automation_test or run_all_automation_tests. No exclusions or alternatives are mentioned, leaving the agent to infer from the category pattern.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_editor_utility_blueprintB

Run an Editor Utility Blueprint's Run event.

ParametersJSON Schema
NameRequiredDescriptionDefault
blueprint_pathYesEditor Utility Blueprint asset path

TDQS

B3/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, but it reveals nothing about side effects, required permissions, or expected outcomes. The term 'run' implies an action but gives no detail on consequences or return values.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise, consisting of a single clear sentence with no redundancy or unnecessary detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The simplicity of the tool (one parameter, no output schema) reduces the need for extensive explanation, but the description still omits critical context such as what happens after running, potential errors, or any dependencies. Thus it is incomplete for a new user.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter has a description ('Editor Utility Blueprint asset path') that matches its name and adds minimal context. Since schema coverage is 100% and the description adds only a bit of clarity, the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: it runs an Editor Utility Blueprint's Run event. This is specific and distinguishes it from siblings like run_editor_utility_widget, which runs widgets instead.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It lacks any mention of conditions, prerequisites, or scenarios where this would be preferred over other tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_editor_utility_widgetB

Run an Editor Utility Widget by asset path.

ParametersJSON Schema
NameRequiredDescriptionDefault
widget_pathYesEditor Utility Widget asset path

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Since no annotations are provided, the description carries the full burden of disclosing side effects and execution context. It only says 'Run an Editor Utility Widget' without explaining what happens during execution, whether it mutates assets, or what errors might occur.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence of eight words, front-loaded and free of filler. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple one-parameter tool, the description provides the core action and input. However, it lacks usage differentiation and behavioral detail, making it minimally complete given the extensive sibling list.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes widget_path as 'Editor Utility Widget asset path' with 100% coverage. The description repeats this with 'by asset path' but adds no new meaning, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Run' plus the resource 'Editor Utility Widget' and the method 'by asset path'. This clearly differentiates it from the sibling run_editor_utility_blueprint, which targets a different asset type.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus run_editor_utility_blueprint or other related utilities. It does not mention alternatives, exclusions, or prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_gauntletC

Launch a Gauntlet test session via UAT. Runs tests in a full game instance.

ParametersJSON Schema
NameRequiredDescriptionDefault
platformNoTarget platform
test_nameYesGauntlet test name
configurationNoBuild configurationDevelopment

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavioral traits. It only states the high-level action and omits details like whether the session is blocking, requires a connected editor, produces logs, or has side effects on the game instance. It does not contradict annotations but leaves significant behavioral uncertainty.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences, directly front-loaded with the primary purpose. Every word adds value and there is no unnecessary verbosity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has no output schema and no annotations, so the description should compensate by explaining expected outcomes, side effects, or usage context. It does not address what the agent can expect after launching, how it relates to other test tools, or any operational requirements, making it incomplete for a tool with this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with descriptions for all three parameters, so the baseline is 3. The description adds no extra parameter context beyond what the schema already provides, failing to clarify parameter interactions or defaults beyond the schema's existing 'Development' default.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action: 'Launch a Gauntlet test session via UAT' and adds a key detail ('Runs tests in a full game instance') that differentiates it from simpler automation test tools. It uses a specific verb+resource structure, though it does not explicitly name alternative tools for disambiguation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus sibling tools like run_automation_tests_by_category or run_all_automation_tests. The description merely states what it does without specifying prerequisites, intended scenarios, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_map_checkB

Run Map Check validation on the current level.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure, but it only states the action without discussing side effects, whether the operation is safe/read-only, expected runtime, or where validation results are surfaced. The existence of a get_test_results sibling hints results are hosted elsewhere, but the description never mentions this.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single front-loaded sentence with no filler words; every token contributes meaning. It is appropriately sized for a zero-parameter tool, though it could still add value (e.g., result location) without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool (0 params, no output schema, no annotations), the description is minimally adequate in stating the action but fails to explain what a successful run produces, how to interpret results, whether the level is modified, or how this validation complements the get_test_results workflow. Given the absence of structured metadata, the description needed to compensate and did not.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so there is nothing for the description to document beyond the schema. Per the rubric, the 0-param case warrants a baseline score of 4, and the description correctly adds no redundant parameter information.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb+resource+scope ('Run Map Check validation on the current level'), clearly stating what it does and where it applies. It implicitly differentiates from siblings like validate_assets (asset-level) and run_gauntlet (automation suites) by naming a unique level-scoped validation, though it does not explicitly call out those distinctions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is given on when to use this tool versus alternatives. It does not mention prerequisites (e.g., having a level open), when not to use it, or how it relates to siblings such as validate_assets, get_test_results, or the run_automation_test tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

run_stat_commandB

Execute a stat console command (e.g., stat fps, stat unit, stat memory).

ParametersJSON Schema
NameRequiredDescriptionDefault
statYesStat command (e.g., 'fps', 'unit', 'memory', 'scenerendering', 'game', 'slow')

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only says 'execute', without explaining whether the command toggles a display, requires a running game session, or has any side effects. The lack of detail leaves the agent uncertain about consequences.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that communicates the essential action and examples without extraneous words. Every element contributes to understanding, achieving high efficiency.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one well-documented parameter and no output schema, the description is minimally viable but lacks contextual details such as what happens after execution (e.g., stats appear on HUD) or any prerequisites. It meets the basic requirement but leaves room for improvement.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, and the schema already provides the parameter 'stat' with examples ('fps', 'unit', 'memory'). The description merely repeats these examples, adding minimal value beyond the structured data, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool executes a 'stat console command' with concrete examples ('stat fps', 'stat unit', 'stat memory'), indicating a specific verb and resource. It is distinct from the broader 'execute_console_command' sibling by focusing on stat commands, though it does not explicitly name the alternative.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like 'execute_console_command', nor does it mention any prerequisites or exclusions. The user must infer that this is specialized for stat commands without explicit direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

save_allA

Save all dirty (modified) assets.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of behavioral disclosure, but it only states the basic action. It does not explain scope (all loaded assets vs. entire project), potential side effects, reversibility, or permission requirements, which is especially important for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence. It includes a useful clarification ('dirty' = modified) without waste, making every word earn its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with no parameters and no output schema, the description is minimally viable but leaves ambiguity about the exact scope of 'all' and any consequences or return values. It provides enough to operate, but lacks richer context that could be expected without annotations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the description need not explain parameter details. The baseline of 4 applies; the description correctly avoids inventing parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Save') and the specific resource ('all dirty (modified) assets'), which distinguishes it from siblings like save_asset (singular) and resave_packages (packages). The parenthetical clarifying 'dirty' adds precision.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as save_asset or resave_packages. There is no mention of contexts, exclusions, or prerequisites, leaving the agent to infer usage on its own.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

save_assetC

Force save a specific asset.

ParametersJSON Schema
NameRequiredDescriptionDefault
asset_pathYesAsset path to save

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. 'Force save' implies a mutation, but it doesn't explain side effects, permission requirements, or what 'force' actually does (e.g., overriding dirty flags or lock status). This is a significant gap for a potentially destructive operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, front-loaded with the key verb and resource, and contains zero unnecessary words. It is appropriately concise for a simple one-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite the tool's simplicity, the description lacks critical context. There is no output schema and no annotations, and the description does not mention return values, success/failure behavior, or what 'force' entails. An agent could not fully assess the tool's impact or prerequisites.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides full coverage for the single parameter asset_path, so the baseline is 3. The tool description adds no extra meaning beyond the schema, and neither explains the path format or whether it is project-relative or absolute.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Force save a specific asset' clearly states the action (force save) and the resource (a specific asset). It implicitly distinguishes from sibling tools like save_all or resave_packages, but it does not explicitly name alternatives or contrast them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention scenarios like 'use when an asset needs to be saved even if unchanged' or how it differs from save_all or resave_packages.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sc_checkinB

Check in file(s) to source control with a description.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesFile paths to check in
descriptionYesCheck-in description / commit message

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must carry the burden of behavioral disclosure. It only states the action without revealing side effects, preconditions, or what happens on failure. Since check-in is a mutating operation that likely requires prior checkout and may create a new revision, the lack of such context is a significant gap for an agent deciding whether and how to invoke this tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence with no filler. It directly states the action and requirement for a description, earning full marks for conciseness and structure.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is too terse. It lacks critical context such as prerequisites (e.g., files must be checked out first), potential impacts (e.g., locks or conflicts), or failure behavior. Given the sibling tools (sc_checkout, sc_revert), the agent needs guidance on the sequence of operations, which is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%: 'paths' is described as 'File paths to check in' and 'description' as 'Check-in description / commit message'. The tool description adds no extra parameter semantics beyond the schema, so the baseline of 3 applies since the schema already fully documents the parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Check in file(s) to source control with a description.' It specifies the verb (check in), the resource (file(s) to source control), and even notes the description requirement. While it doesn't explicitly contrast with siblings like sc_checkout or sc_revert, the specific 'check in' phrasing naturally distinguishes it from other source control operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies its use case (committing files) but provides no explicit guidance on when to use this tool versus alternatives like sc_checkout or sc_mark_for_add. An agent can infer that check-in is for committing changes, but there's no mention of prerequisites (e.g., must be checked out first) or exclusions. The context of sibling names provides some guidance, but the description itself gives no direct advice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sc_checkoutC

Check out file(s) from source control.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesFile paths to check out

TDQS

C2.5/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It does not state what happens during checkout (e.g., file locking, write permissions, side effects), nor does it mention any caveats or environmental requirements.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence with no fluff, making it easy to parse. However, its brevity borders on under-specification, though it satisfies the conciseness requirement by being front-loaded and direct.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool (one parameter, no annotations, no output schema), the description is minimally sufficient but lacks important context such as behavioral effects, workflow integration with sibling tools (e.g., sc_checkin), and any conditions that might prevent checkout. This is inadequate for an agent to use it confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter 'paths' is fully documented in the schema with the description 'File paths to check out', giving 100% coverage. The tool description adds no extra meaning beyond what the schema already provides, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool checks out file(s) from source control, using a specific verb and resource. It distinguishes from siblings like sc_checkin (the opposite operation) but does not explicitly contrast with other source control operations, leaving some ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives like sc_checkin or sc_revert. The description lacks any mention of prerequisites, typical scenarios, or exclusions, leaving the agent without decision-making support.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sc_diffA

Get the diff for a modified file in source control.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesFile path to diff

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are absent, so the description must convey side effects. The verb 'Get' implies a read-only operation with no mutations, which is clear. However, it does not explicitly state that it is non-destructive or that it does not modify the working copy, though this is strongly inferred.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no redundant information. It directly states the action and target without any fluff or unnecessary details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple read-only operation, the description is sufficient. It identifies the action and target, but it does not specify the output format (e.g., unified diff) or any additional context like branch or revision, which might be expected. However, the absence of an output schema reduces the need for such detail.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool description adds no meaning beyond the input schema. The schema already defines the 'path' parameter with a description 'File path to diff.' The description of the tool itself does not elaborate on the parameter's semantics, so it relies entirely on the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: 'Get the diff for a modified file in source control.' It uses a specific verb ('Get') and specifies the resource ('diff') and context ('modified file in source control'), distinguishing it from sibling tools like sc_checkout or sc_status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide any guidance on when to use this tool versus alternatives. It does not mention scenarios where a diff is needed or differentiate from other source control read operations. Usage context is entirely implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sc_mark_for_addB

Mark new file(s) for add in source control.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesFile paths to mark for add

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations available, the description must fully disclose behavior, but it only states the action without side effects, permissions, or effects on existing files. It does not clarify whether this stages files temporarily, requires prior creation, or how it interacts with other source control operations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence with no redundant words, which is efficient. However, it is almost too terse, lacking any elaboration that could aid the agent. Still, it scores high on conciseness because there is no fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations, the description must compensate, but it only states the basic action. It does not mention when to use it (e.g., for untracked files before commit), potential side effects (adds to index), or any behaviors like error handling. Given a one-parameter tool, this is minimal but insufficient for an agent to fully understand implications.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool description adds no detail beyond the schema's parameter description 'File paths to mark for add'. Since schema coverage is 100%, the baseline score of 3 applies, but the description does not enhance understanding of the paths parameter (e.g., format, relative vs absolute, directories).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'mark' with a clear object 'new file(s)' and specifies the resource 'source control'. It effectively distinguishes from sibling tools like sc_checkout or sc_revert, as it uniquely indicates staging new files for addition.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives like sc_checkout or sc_checkin. It does not mention explicit conditions or exclusions, leaving the agent without context for tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sc_revertB

Revert file(s) in source control.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesFile paths to revert

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavior. It only says 'Revert file(s)' without stating whether it discards local changes, whether it’s destructive, whether it requires checkout, or how it differs from 'undo'. The description doesn't compensate for the missing annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, extremely concise and front-loaded. It covers the essential action and resource. There is no wasted text, but it could add a bit more context (like 'discards local changes') without bloating, though conciseness is strong.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple: one parameter, no output schema, and the description gives the core purpose. However, given it's a mutation tool with no annotations, it would benefit from stating what 'revert' does (e.g., reverts to last checked-in version) and any destructive implications. The current description is minimal but adequate for a simple tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of the parameters with 'paths' having a description 'File paths to revert', so the schema itself provides the necessary semantics. The description adds no additional parameter meaning, but the schema suffices, leading to a baseline score of 3. However, since the tool is simple with one parameter and the description does not contradict, a 4 is warranted because the parameter is self-explanatory.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The purpose is clear: 'Revert file(s) in source control.' This identifies a clear verb and resource (sc_revert). However, it lacks any context on what 'revert' does or its scope, which is a genuine gap for a mutation operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on what sc_revert does in relation to sibling tools like sc_checkout, sc_checkin, sc_diff, which are likely to be used. purpose has a clear action but no context on when to use it versus the other sc_* operations, nor does it mention any preconditions like having the file checked out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sc_statusA

Query source control status of file(s).

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYesFile paths to query (content paths like /Game/... or absolute paths)

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of disclosing behavior. The verb "Query" strongly implies a read-only, non-mutating operation, which is useful transparency. However, it does not disclose return format, potential network dependencies, or behavior when files are not under source control, leaving some ambiguity.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. It conveys the essential purpose efficiently and is appropriately sized for the tool's simplicity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no output schema) and the surrounding sibling context, the description is adequately complete. It could benefit from mentioning what the response contains (e.g., a status per path), but this is minor and does not significantly impede understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage for the single parameter (paths), so the baseline is 3. The description adds no additional parameter semantics beyond what the schema already provides, which is acceptable given the clear schema description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function with a specific verb ("Query"), a clear resource ("source control status"), and a scope ("file(s)"). It distinguishes itself from sibling tools like sc_checkout and sc_checkin, which modify source control state.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when one needs to inspect source control status, but it does not explicitly state when to use it versus alternatives such as sc_diff or sc_checkout. There is no mention of preconditions or exclusions, leaving the agent to infer from the sibling tool names.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_assetsC

Search for assets by name, class, or tag.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesSearch query (asset name substring)
class_filterNoFilter by asset class

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, but it only states the search criteria. It fails to disclose return format, matching behavior, case sensitivity, or the meaning of 'tag' given the schema lacks a tag parameter. This leaves significant behavioral unknowns.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no redundant words. It is appropriately concise for a simple search operation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the absence of annotations and output schema, the description is insufficient. It does not explain what the search returns, whether it returns full asset info or just names, or how tags relate to the provided parameters. More context is needed for an agent to use this tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes both parameters with 100% coverage, so the baseline is 3. The description adds no meaningful parameter detail and actually introduces confusion by mentioning 'tag' search without a corresponding schema parameter, potentially misleading the agent about query capabilities.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Search for assets') and the criteria ('by name, class, or tag'), which distinguishes it from sibling list_assets and get_asset_info. However, 'tag' is not supported by the input schema (only query and class_filter exist), introducing slight ambiguity about the intended scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when-to-use or exclusion guidance is given. The description implies searching is the use case, but it does not differentiate when to use search_assets versus list_assets, get_asset_info, or other asset-related tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

select_actorsB

Set the editor's actor selection.

ParametersJSON Schema
NameRequiredDescriptionDefault
namesYesActor names or labels to select

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It does not explain what happens to the previous selection (replaced or appended), how invalid names are handled, or whether any confirmation or return value is expected. This leaves the agent guessing about side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no unnecessary words. It is appropriately concise for the simplicity of the tool, and every word contributes to stating the tool's core function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With only one parameter and no output schema, the description covers the core action but omits edge-case behavior (e.g., effect on current selection, handling of unknown actor names). For a simple tool this may be acceptable, but a bit more detail would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers the 'names' parameter with a description 'Actor names or labels to select', giving 100% coverage. The tool description adds no additional detail beyond that, so the parameter semantics are fully handled by the schema, meriting the baseline score of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Set the editor's actor selection' uses a specific verb ('set') and a clear resource ('actor selection'), distinctly differentiating it from sibling tools like list_actors, spawn_actor, and delete_actor. The purpose is immediately understandable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool vs alternatives, nor any mention of prerequisites or context. While it is the only selection-related tool among the siblings, the description does not explicitly state 'use this to select actors' or provide any situational cues.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_actor_propertyB

Set a property on an actor via the Remote Control API.

ParametersJSON Schema
NameRequiredDescriptionDefault
actor_pathYesFull object path of the actor (e.g., /Game/Level.Level:PersistentLevel.MyActor)
property_nameYesProperty name to set
property_valueNoValue to set

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It states the operation is a setter (implying mutation) but does not disclose possible failure modes, whether the property must already exist, how type coercion works, or whether the change is persistent or session-only. This is a significant gap for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that is immediately scannable and contains no filler or redundant content. It efficiently states the core functionality.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is a simple generic setter, but the description omits observable behavior such as expected return value, error handling on invalid property names, or interaction with the Remote Control API's restrictions. Given the absence of annotations and output schema, a bit more context would make this a more complete description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides descriptions for all three parameters, including a clear example for actor_path and a minimal 'Value to set' for property_value. The description adds no additional parameter-level meaning, so the schema carries the burden. Baseline 3 is appropriate because schema coverage is 100%, but property_value's semantics are thin.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Set') and resource ('property on an actor'), and specifies the API context ('Remote Control API'). It is sufficiently distinct from siblings like set_actor_transform and set_actor_tags because it targets an arbitrary named property, though it could more explicitly convey "arbitrary" or "generic."

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives such as set_actor_transform, set_actor_tags, or the Niagara-specific property setters. The description does not mention any prerequisites (e.g., actor must exist, property must be accessible) or when a more specialized setter would be preferable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_actor_tagsC

Set tags on an actor.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesActor name or label
tagsYesTags to set

TDQS

C2.8/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for disclosing behavior. It merely states the action without mentioning whether tags are replaced, appended, or removed, nor any side effects or requirements (e.g., whether the actor must exist). It provides zero behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with no redundancy, but it is so brief that it omits crucial details like behavior on existing tags, errors, or side effects. It is not verbose but under-specified, so a middle score is appropriate.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations and no output schema, the description provides minimal context. It does not explain effects on existing tags, failure modes, or when to use this over other tools, leaving the agent with little guidance for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides basic descriptions for both parameters ('Actor name or label' and 'Tags to set'), which is adequate for simple types. However, the description does not clarify semantics like whether tags replace existing ones or add to them, leaving the schema to carry the weight. With 100% schema coverage, the baseline is met but no extra detail is added.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Set tags on an actor.' It uses a specific verb (set) and resource (tags on an actor), and while there are other set_* tools, none target actor tags, so it effectively distinguishes itself from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, such as when to add vs. replace tags, or when to use other tag-related tools. It only implies usage through the action itself, with no exclusions or contextual clues.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_actor_transformB

Set the location, rotation, and/or scale of an actor.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesActor name or label
scaleNo
locationNo
rotationNo

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It implies mutation but does not disclose whether updates are partial or absolute, what coordinate space is used, units for rotation, error behavior, or return value. The 'and/or' hint is the only behavioral nuance.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with ten words, front-loaded and without filler. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given three nested object parameters, no annotations, no output schema, and minimal description, the tool is under-specified. The description does not clarify partial updates, required actor checks, or rotation format, making it insufficient for safe autonomous use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 25% (only 'name' has a description). The description lists the three transform properties but adds no semantic meaning beyond their names—e.g., units, coordinate system, or that each property is independently optional.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool sets the location, rotation, and/or scale of an actor, specifying both the verb and the resource. It distinguishes from generic sibling tools like set_actor_property by naming the specific transform components.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives such as set_actor_property or spawn_actor. There is no mention of prerequisites, use cases, or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_blueprint_propertyA

Set a default property value on a Blueprint's CDO (Class Default Object). For component properties, use a dot path like 'ComponentName.PropertyName'.

ParametersJSON Schema
NameRequiredDescriptionDefault
property_nameYesProperty name, or ComponentName.PropertyName for component sub-properties
blueprint_pathYesBlueprint asset path
property_valueYesProperty value — asset paths (/Game/...), Python expressions (True, 42.0), or plain strings

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the burden of disclosing behavior. It adds relevant context about CDO defaults and dot paths for components, but it does not mention persistence, compile requirements, or whether this is a destructive operation. For a mutation tool, this is a gap but not a contradiction.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the primary action and resource. Every word serves a purpose: the first sentence defines what the tool does, and the second provides a crucial usage hint. No redundant or vague wording.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description, combined with the rich schema (100% parameter coverage), is adequate for a simple setter. However, without annotations or an output schema, the description does not address potential side effects (e.g., whether the property change requires asset save or blueprint recompilation) or error handling. It is minimally complete but leaves some behavioral gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already describes all three parameters with 100% coverage. The description adds valuable semantic nuance beyond the schema by explaining the 'ComponentName.PropertyName' dot path format for property_name, which clarifies how to address component sub-properties. This extra meaning justifies above baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'Set' with a precise resource: 'default property value on a Blueprint's CDO'. It clearly distinguishes from instance-level setters like set_actor_property by specifying CDO (Class Default Object). The dot-path example for component properties further clarifies the tool's specific scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context that this tool operates on Blueprint defaults, implying it should be used instead of instance-level setters. It does not explicitly name alternatives or exclusions, but the mention of CDO and the dot-path convention offers situational guidance for component properties.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_data_layer_stateC

Set the state of a data layer (Loaded, Activated, Unloaded).

ParametersJSON Schema
NameRequiredDescriptionDefault
stateYesTarget state
layer_nameYesData layer name

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry behavioral disclosure. It only says 'Set the state' without mentioning side effects, prerequisites, whether the operation is synchronous, or what happens if the layer does not exist. This is insufficient for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence with no fluff or redundancy. It front-loads the action and immediately lists the valid states, exemplifying efficient structure.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a state-changing tool with no output schema and no annotations, the description is too bare. It lacks context about the data layer's lifecycle, potential side effects (e.g., unloading data), and any required preconditions. More explanation of the effect of each state would enhance completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both parameters are documented. The description repeats the state enum values that are already in the schema, adding no extra meaning beyond what the schema provides. Thus it meets the baseline but no more.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (set) and the target (data layer state), and explicitly lists the three valid states. It distinguishes itself from sibling read tools like list_data_layers by indicating a mutation operation, though it does not explicitly reference alternatives.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus other data layer tools (e.g., list_data_layers, get_loaded_cells). There are no stated prerequisites or exclusions, leaving the agent without context for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_material_instance_scalarA

Set a scalar parameter on a material instance.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueYesParameter value
instance_pathYesMaterial instance asset path
parameter_nameYesScalar parameter name

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It only restates the action and provides no information about side effects, persistence, or prerequisites (e.g., whether the material instance must be loaded or whether the parameter must already exist). It adds no transparency beyond the schema description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. It directly states the operation and is immediately scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is a simple setter, but with no annotations or output schema, the description should provide more context (e.g., whether it modifies the asset, persists, or requires a loaded material instance). The schema covers parameters, but the description alone is thin for guiding an agent safely, so it is minimally complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with each parameter having a clear description ('Material instance asset path', 'Scalar parameter name', 'Parameter value'). The tool description adds no extra meaning beyond the schema, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action: 'Set a scalar parameter on a material instance.' It uses a specific verb ('set') and a specific resource ('material instance') with a specific parameter type ('scalar'), which distinguishes it from sibling tools like set_material_instance_vector and set_material_instance_texture.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage (when you need to set a scalar parameter), but it does not explicitly state when to use this tool versus alternatives or mention any exclusions. Sibling tool names provide implicit context, but explicit guidance is absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_material_instance_textureA

Set a texture parameter on a material instance.

ParametersJSON Schema
NameRequiredDescriptionDefault
texture_pathYesTexture asset path
instance_pathYesMaterial instance asset path
parameter_nameYesTexture parameter name

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry full behavioral disclosure. It only states the action without mentioning side effects, persistence, mutation, required permissions, or return behavior. For a write operation, the lack of any disclosure beyond the verb is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, front-loaded with the action, and contains zero wasted words. It is appropriately sized for the tool's simplicity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple setter with fully documented params, the description conveys the essential purpose. However, the lack of behavioral transparency (side effects, success return, asset save behavior) leaves gaps for an agent trying to predict outcomes. It is adequate but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and each parameter has a description. The tool description adds no additional context about parameter formats, constraints, or relationships, so it neither compensates for gaps nor adds value beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Set') with a specific resource ('texture parameter') and object ('material instance'). It clearly distinguishes from sibling tools like set_material_instance_scalar and set_material_instance_vector, which set different parameter types.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The context is clear: use this tool when you need to set a texture parameter on a material instance. It doesn't explicitly contrast with alternatives, but the specificity of 'texture parameter' implicitly guides selection among sibling setter tools. No exclusions or when-not-to-use are stated, but the purpose itself provides adequate context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_material_instance_vectorB

Set a vector parameter on a material instance.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueYesRGBA values (0-1)
instance_pathYesMaterial instance asset path
parameter_nameYesVector parameter name

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavior. It states the action but does not mention whether changes are persistent, require an asset save, or what happens if the parameter does not exist. No return behavior is described.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no redundant words. It is appropriately concise for the tool's simple purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has no output schema and no annotations, so the description should cover return behavior and side effects. It does not, leaving the agent uncertain about success/failure signals. It is minimal for a simple setter but lacks contextual completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already provides complete descriptions for all parameters, including the RGBA value object with ranges and defaults. The description adds no additional meaning beyond the schema, so baseline score of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly indicates a specific action (set) on a specific resource (vector parameter of a material instance). It distinguishes itself from sibling tools like set_material_instance_scalar and set_material_instance_texture by specifying 'vector'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternative material setters or other vector setters. It does not state prerequisites such as the material instance being loaded or saved after modification.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_niagara_boolA

Set a bool parameter on a Niagara component.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueYesBool value
actor_nameYesActor with Niagara component
parameter_nameYesParameter name

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden for behavioral disclosure. It only states that it sets a value, without mentioning requirements such as a loaded actor or existing Niagara component, side effects, or whether a return value is produced. This is minimal beyond the operation itself.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no filler. Every word contributes to identifying the operation and resource.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a simple setter with fully documented parameters, so the description is adequate for basic invocation. However, because there are no annotations and no output schema, it would benefit from noting prerequisites, behavior, or expected results.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with parameter descriptions, so the baseline is 3. The description adds no additional parameter-level detail, but the schema already provides adequate semantics for actor_name, parameter_name, and value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific action ('Set') and resource ('bool parameter on a Niagara component'), making the tool's purpose unambiguous. It also distinguishes itself from sibling type-specific tools like set_niagara_float, set_niagara_vector, and set_niagara_color.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not explicitly explain when to use this tool versus alternatives, but the phrase 'bool parameter' and the sibling tool names imply type-based selection. There are no exclusions, prerequisites, or explicit alternative suggestions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_niagara_colorB

Set a linear color parameter on a Niagara component.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueYesRGBA color (0-1)
actor_nameYesActor with Niagara component
parameter_nameYesParameter name

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description does not disclose any side effects, permissions, or reversibility. As a setter, it implies modification but gives no detail on impact or potential errors.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that immediately conveys the core action without unnecessary words. It is concise and well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the description explains the basic operation, it lacks context on typical use cases, prerequisites, or relationship to sibling setters. The absence of an output schema is acceptable, but more contextual detail would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already provides descriptions for all parameters (actor_name, parameter_name, value). The description adds no additional meaning beyond the schema, so the baseline score of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the function: setting a linear color parameter on a Niagara component. It is specific and unambiguous, distinguishing it from other setters like float or vector.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternative setters (e.g., set_niagara_float, set_niagara_vector). It only states what the tool does without indicating usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_niagara_floatC

Set a float parameter on a Niagara component.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueYesFloat value
actor_nameYesActor with Niagara component
parameter_nameYesParameter name

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure, but it doesn't mention what happens if the parameter is not found, whether the component needs to be bound, or whether the change is immediate or on next spawn. This is a mutation operation with zero context provided, creating a 'black box' for side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One sentence, zero fluff, uses consistent nomenclature. It's appropriately sized for its minimal content, though it could have used the space to add behavioral context without risking verbosity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations, no output schema, and a bare-bones description, the agent has no way to know the return value, error semantics, or preconditions. The sibling tools for set_niagara_vector/bool/color exist, so this has no extra complexity, but for a mutation tool without annotations, it should have conveyed at least basic safety or scope information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 100% coverage—'value' is 'Float value', 'actor_name' is 'Actor with Niagara component', and 'parameter_name' is just 'Parameter name.' The description doesn't add meaningful depth to these. Baseline 3 is appropriate since the schema does the heavy lifting, though 'Parameter name' is somewhat tautological.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Set a float parameter on a Niagara component' uses a clear verb-object structure with specific vocabulary like 'float parameter' and 'Niagara component,' which orients the agent's tool selection. However, it does not reference subtle differences from sibling tools handling vector, color, or boolean types, though the type name is embedded in the tool name (set_niagara_float).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description lacks any guidance on when to use this tool versus alternatives like set_niagara_vector, set_niagara_bool, or set_niagara_color. There's no mention of when setting a float parameter is appropriate (e.g., before spawn vs. live update), no exclusions, and no prerequisite information about whether the Niagara component must be active or exist.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_niagara_vectorB

Set a vector parameter on a Niagara component.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueYesVector value
actor_nameYesActor with Niagara component
parameter_nameYesParameter name

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose side effects itself. It only states the operation without mentioning potential impacts, such as whether it overwrites existing values, triggers system updates, or performs any validation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no redundant phrases. It is immediately clear and contains only the essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity and lack of output schema, the description provides too little context. It does not mention return values, error conditions, or any side effects, leaving the agent without enough information to fully anticipate the tool's behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already provides clear descriptions for all three parameters (actor_name, parameter_name, value). The tool description adds no additional meaning beyond what the schema specifies, so it holds the baseline score for full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Set') and the resource ('a vector parameter on a Niagara component'). It distinguishes from sibling tools that handle other parameter types (float, color, bool) or spawn/reset operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives like set_niagara_float or set_niagara_color. The description does not mention prerequisites, contexts, or scenarios where this is preferred.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_playback_rangeA

Set the playback start and end frames of a sequence.

ParametersJSON Schema
NameRequiredDescriptionDefault
end_frameYesEnd frame
start_frameYesStart frame
sequence_pathYesLevelSequence asset path

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the full burden of behavioral disclosure. It only restates the action without mentioning side effects, validation behavior, whether the sequence must already exist, or whether changes are persisted. This is a meaningful transparency gap for a mutating tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no redundant words or filler. Every word contributes to the core purpose, making it highly concise and easily scannable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple and the schema covers parameter descriptions, but the description lacks important contextual details such as relationship to sequence creation/saving, validation rules, or expected sequence state. Given the missing annotations and no output schema, the description is minimally viable but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all three parameters with basic descriptions. The tool description adds no additional parameter semantics beyond what the schema provides, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Set') and identifies the exact resource and scope ('playback start and end frames of a sequence'). It clearly distinguishes from siblings like set_sequence_framerate, which targets framerate rather than frame range.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by stating what the tool does, but it gives no explicit guidance on when to use it versus alternatives, no prerequisites, and no exclusions. For a simple setter this is acceptable but still leaves the 'when' implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_preset_propertyB

Set a property value exposed via a Remote Control Preset.

ParametersJSON Schema
NameRequiredDescriptionDefault
valueNoProperty value to set
preset_nameYesPreset name
property_nameYesExposed property name

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It only says 'Set a property value' without explaining side effects, return behavior, error conditions, or whether the operation is reversible. This is inadequate for a mutation tool with zero annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no superfluous words. It is appropriately front-loaded and immediately communicates the core function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple setter, the description is minimally viable, but it lacks important context. It does not explain that 'value' is optional or what happens when setting a property without one. There is no mention of error handling, return values, or interaction with preset state, despite the lack of an output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers 100% of the parameter descriptions (preset_name, property_name, value), so the baseline is 3. The description does not add any additional meaning beyond the schema, nor does it compensate for the fact that the 'value' parameter is not required and has no type specified.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Set') and the resource ('a property value exposed via a Remote Control Preset'). It is specific enough to distinguish from sibling tools like get_preset_property and call_preset_function, which have different verbs and targets.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives. It does not mention exclusions, prerequisites, or contrast with other preset-related tools such as get_preset_property or call_preset_function. The usage context is only implied by the verb 'Set'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_sequence_framerateC

Set the display frame rate of a sequence.

ParametersJSON Schema
NameRequiredDescriptionDefault
fpsNoFrames per second
sequence_pathYesLevelSequence asset path

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure, but it only restates the basic action. It doesn't reveal whether the display rate change affects existing keyframes, whether the asset must be saved after, what valid fps ranges exist, or how 'display frame rate' relates to the sequence's time formatting. The term 'display' hints at a specific concept but is never explained.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One action-first sentence with zero wasted words, structured as verb-object. It reads cleanly and front-loads the intent. Slightly more detail could have been added without harming conciseness—the terms 'display' and 'sequence' were both primed—so it misses a 5 but is well-crafted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple 2-parameter setter with 100% param coverage, the description is 'adequate but bare.' It correctly identifies the behavior—changing display rate, not render rate—which matters in the Unreal context, but doesn't explain the practical impact (e.g., time-smoothing, sub-frame interpolation) or why an agent would pick this over a similar tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% (all parameters documented with meaningful descriptions), so the baseline of 3 applies. The description adds nothing beyond the schema: the tool text doesn't clarify valid fps ranges, the effect of changing the rate on existing animations, or how sequence_path is resolved.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Uses a specific verb+resource construction ('Set the ... frame rate of a sequence') that clearly identifies the action and target. The qualifier 'display' helpfully narrows the meaning from the render or playback rate. Slight ambiguity remains about what 'display' distinguishes against (render/playback), but the core purpose is clear.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides no guidance on when to use this tool versus closely related siblings like set_playback_range, render_sequence, or get_sequence_info. A single sentence with zero context about when to reach for this vs. alternatives means an agent gets no disambiguation help.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_skeletal_mesh_lodB

Configure LOD settings on a skeletal mesh.

ParametersJSON Schema
NameRequiredDescriptionDefault
lod_countYesNumber of LODs to generate
mesh_pathYesSkeletal mesh asset path

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the burden of behavioral disclosure. It mentions 'Configure LOD settings' but doesn't disclose side effects like whether existing LODs are destroyed/overwritten, whether source art is regenerated, or if this is purely metadata configuration. The briefness leaves questions about undo-ability and performance impact.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Efficient single sentence, minimal waste. Could be criticized for under-specification, but for the stated purpose it's appropriately sized. A slight improvement would be mentioning behavior or expectations.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with only 2 parameters and no output schema, the description is functional but thin. It doesn't explain the effect of 'configuring' LODs - does it regenerate them, adjust settings, or something else? The return value is unknown, but that's partially mitigated by no output schema. The sibling tools context (content management, source control, automation) suggests this is a UEFN/RPC automation, where concurrency considerations might be relevant but aren't mentioned.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema documents both parameters. The description references LOD settings generally but doesn't add meaning beyond the schema. The description 'Configure LOD settings' adds no parameter information beyond what schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Configure' and the resource 'LOD settings on a skeletal mesh'. It's specific enough to distinguish from sibling tools like apply_material or reimport_skeletal_mesh, though it could explicitly differentiate from other LOD-related tools (none currently exist among siblings).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage context (configuring LOD settings) but doesn't explicitly state when to use this tool vs alternatives. It doesn't mention prerequisites like mesh path validity or LOD generation pipeline requirements.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_streaming_sourceC

Configure a streaming source component on an actor for World Partition.

ParametersJSON Schema
NameRequiredDescriptionDefault
radiusNoStreaming radius in units
actor_nameYesActor name or label

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It implies a mutating action ('configure') but does not disclose any side effects, such as whether existing streaming sources are overwritten, whether it requires special permissions, or what happens to the actor's settings. There is no mention of reversibility or any constraints, leaving the agent without critical safety information.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is front-loaded with the core purpose. It is concise and avoids unnecessary words. While it could include more detail, the sentence is efficiently constructed and does not waste the reader's time. However, it omits any usage guidance, which is a structural gap, but the conciseness itself is good.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is minimal. It states only the purpose and lacks context about the operation's behavior, any prerequisites, or what the result will be. There is no output schema, so the description needs to explain what happens, but it does not. It also does not mention the radius or actor_name parameters, which are essential for the operation. For a tool that modifies a component on an actor, this is insufficiently complete for an agent to use safely and effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% — both 'radius' and 'actor_name' have descriptions in the schema. The tool description itself adds no additional meaning beyond the schema, but since the schema is complete, a baseline score of 3 is appropriate per the guidelines. The schema already explains that radius is a streaming radius in units and actor_name is the actor name or label.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Configure a streaming source component on an actor for World Partition' clearly states a specific verb (configure), a specific resource (streaming source component on an actor), and the context (World Partition). It distinguishes itself from sibling tools like set_data_layer_state or get_loaded_cells, which deal with different aspects of World Partition. The purpose is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not mention any preconditions, exclusions, or alternative tools. With siblings like list_data_layers and get_loaded_cells, an agent might not know when to select this tool. The description simply states what it does, leaving the decision entirely to the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

set_viewport_cameraA

Set the editor viewport camera location and/or rotation.

ParametersJSON Schema
NameRequiredDescriptionDefault
locationNoCamera location
rotationNoCamera rotation

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states that it sets the camera location and/or rotation, which is the core behavior, but it does not mention coordinate conventions, units, defaults when both fields are omitted, or any side effects on the editor state. For a simple setter, this is adequate but minimal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence that front-loads the action and target. It contains no filler or redundant information, and every word contributes meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool is simple, with a moderately detailed schema and no output schema. The description explains the essential purpose but leaves gaps such as coordinate system, rotation order, and behavior when no parameters are provided. It is minimally complete but not fully self-contained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% ('Camera location' and 'Camera rotation'), so the schema already documents the parameters. The description adds no additional semantics beyond what the schema provides, such as units or coordinate system, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Set' and identifies the resource as 'editor viewport camera location and/or rotation', clearly distinguishing from the sibling 'get_viewport_camera' which reads the camera state. It precisely communicates the action and scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage (when you need to adjust the camera position or orientation) but provides no explicit guidance about when to use this tool versus alternatives, nor any exclusions or prerequisites. It relies on the name and verb to imply context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spawn_actorC

Spawn a new actor in the current level.

ParametersJSON Schema
NameRequiredDescriptionDefault
labelNoActor label in the editor
scaleNoActor scale (default: 1,1,1)
locationNo
rotationNo
actor_classYesActor class to spawn (e.g., StaticMeshActor, PointLight, CameraActor)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fails to disclose whether the spawned actor becomes selected, what happens on invalid actor_class, or whether the level must be mutable; the single sentence 'Spawn a new actor in the current level' is the extent of behavioral information.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no redundant wording, but it is somewhat under-specified for the tool's complexity; still, it earns its place as a clear purpose statement.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 5 parameters including nested objects and no output schema, the description lacks context about coordinate systems, defaults, and return behavior; it also fails to differentiate from sibling spawn tools, making it incomplete for an agent to use confidently.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description does not describe any parameters; the schema provides descriptions only for actor_class and scale, leaving label, location, and rotation with only type/default information. The description adds no semantic value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'spawn' with resource 'actor' and scope 'current level', clearly conveying a creation operation distinct from siblings like list_actors or set_actor_transform.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool over alternatives such as spawn_blueprint_actor or spawn_niagara_*; it does not state prerequisites like having a level loaded.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spawn_blueprint_actorC

Spawn an instance of a Blueprint class in the level.

ParametersJSON Schema
NameRequiredDescriptionDefault
labelNoActor label
locationNo
rotationNo
blueprint_pathYesBlueprint asset path

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description alone carries the burden of behavioral disclosure. It only restates the action already implied by the tool name and offers no insight into side effects, persistence of changes, error handling, permissions, or return values. This is insufficient for an agent to understand the full impact of invoking the tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no unnecessary words. It is front-loaded and efficient, but its extreme brevity leaves out important details. Still, as a one-liner, it is well structured and easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's reliance on parameters (including nested default objects) and the absence of an output schema, the description is far too sparse. It does not explain how spawning behaves when the blueprint path is invalid, how location and rotation defaults work, or what happens after spawning. The description is not complete enough for reliable invocation in non-trivial scenarios.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description makes no mention of any of the four input parameters. Although the schema provides descriptions for 'label' and 'blueprint_path', the nested 'location' and 'rotation' objects lack explanations, and the description does nothing to clarify their meaning or defaults. With only 50% schema description coverage, the description fails to add semantics for the undocumented parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly specifies a concrete action ('spawn') and a specific resource ('an instance of a Blueprint class') with a location context ('in the level'). It distinguishes itself from the sibling 'spawn_actor' by explicitly limiting to Blueprint classes, making it unambiguous which tool to use for this purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no comparison to alternatives, no preconditions, and no advice on when to choose this tool over 'spawn_actor' or other actor-related tools. It simply states what the tool does without explaining the situations in which it is the best choice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spawn_niagara_at_locationB

Spawn a Niagara particle system at a world location.

ParametersJSON Schema
NameRequiredDescriptionDefault
locationYesWorld location
rotationNo
system_pathYesNiagara system asset path
auto_destroyNoAuto-destroy when finished

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the full burden of behavioral disclosure. It only states the action and location, but does not mention side effects like whether the system auto-destroys, how long it runs, or any performance implications. The schema mentions auto_destroy with a description, but the tool description itself adds no behavioral insight.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with zero wasted words. It immediately states the action and target, which is ideal for quick parsing by an agent.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the schema provides parameter details, the description lacks critical context such as the standalone nature of the spawn (vs. attached), the lifecycle of the system, and any potential impact. For a tool that spawns a particle system, agents would benefit from knowing whether it's a persistent or transient effect, but the description is minimal. It is adequate but not complete given no annotations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 75% (three of four parameters have descriptions), so the baseline is 3. The description adds no additional meaning about parameters beyond what the schema already provides. It does not clarify parameter formats, units, or relationships, but the schema covers most essential details, so the description is not required to compensate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (spawn) and the resource (Niagara particle system) plus a key differentiator (at a world location). It distinguishes from spawn_niagara_attached by implication but does not explicitly name the alternative. The verb and resource are specific enough for basic identification.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like spawn_niagara_attached. There is no mention of context, prerequisites, or exclusions. Users must infer from the name or sibling tools, which is not sufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

spawn_niagara_attachedA

Spawn a Niagara system attached to an actor.

ParametersJSON Schema
NameRequiredDescriptionDefault
actor_nameYesActor name or label to attach to
system_pathYesNiagara system asset path

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must disclose behavioral traits. It states 'attached to an actor' but omits crucial details like what happens if the actor is not found, whether the system auto-destroys with the actor, or if any specific transform behavior occurs. Minimal behavioral disclosure for a mutating spawn operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no redundant words. It immediately conveys the core purpose without any fluff or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with only 2 parameters and no output schema, the description is adequate but not rich. It could be more complete by explaining attachment semantics (e.g., location, socket, lifetime) or failure behavior, especially given the absence of annotations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already provides 100% coverage for both parameters (actor_name and system_path) with concise descriptions. The tool description adds no additional meaning beyond what the schema describes, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Spawn') and the resource ('Niagara system') along with the attachment context ('attached to an actor'). This distinctly differentiates it from the sibling tool spawn_niagara_at_location, which spawns at a location rather than attaching to an actor.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool (when attaching a Niagara system to an actor) but offers no explicit guidance or alternatives. It does not contrast with sibling tools like spawn_niagara_at_location or mention prerequisites such as a valid actor name or system asset path.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

start_csv_profilingC

Start CSV profiling capture for performance regression analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault
filenameNoOutput CSV filename (default: auto-generated)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It doesn't state what happens when profiling starts, whether it overwrites existing files, if it requires a specific environment state, or how long it runs. It also doesn't mention any side effects or prerequisites. The description adds minimal behavioral context beyond the name, which is insufficient given no annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, efficient and front-loaded. It conveys the essential action without fluff. However, it could be slightly more informative without being verbose, but it earns a high score for conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has only one optional parameter and no output schema, the description could be more complete regarding the profiling lifecycle. It doesn't mention the companion stop_csv_profiling tool or any related considerations like file location or data format. The description is adequate for a simple tool but lacks enough context for the agent to fully understand the operation's scope and consequences.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% because the only parameter (filename) has a description in the schema. The description adds no additional parameter semantics beyond the schema. Since coverage is high, baseline is 3. The description doesn't explain the format or constraints of the filename, but the schema already covers the basic meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool starts CSV profiling capture for performance regression analysis. It uses a specific verb ('Start') and resource ('CSV profiling capture'), but does not differentiate from the sibling tools like start_trace or stop_csv_profiling, though the purpose is evident.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. It doesn't mention that stop_csv_profiling is the counterpart to end the capture, nor does it explain when to use start_csv_profiling instead of start_trace or run_stat_command. The description implies usage for performance regression analysis but lacks explicit context or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

start_traceC

Start an Unreal Insights trace session with selected channels.

ParametersJSON Schema
NameRequiredDescriptionDefault
channelsNoTrace channels: cpu, gpu, frame, memory, counters, bookmark, file, net, loadtime

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behavior. It only states that it starts a trace session, but does not mention side effects, resets, or whether prior traces are stopped, or any performance impact. The description implies a state change (starting a session) but lacks detail on session lifecycle or resource usage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is a single concise sentence that is front-loaded with the action. No fluff, but could be slightly more informative with a hint about usage.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool that likely requires a running environment (e.g., Editor), the description lacks important context like whether it requires a connection, how to verify success, or what happens to existing traces. No output schema, so the description should explain return or failure modes, but it does not.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already has 100% coverage with a description of each channel and a default value. The description's mention of 'selected channels' adds minimal value, but the schema is sufficient. Baseline 3 is appropriate because the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Start' and the resource 'Unreal Insights trace session', specifying that channels are selected. It distinguishes from the sibling 'stop_trace' by implying a start action, though it does not explicitly differentiate from other tracing-related tools like 'start_csv_profiling'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, such as CSV profiling or other trace tools. The description does not mention prerequisites (e.g., connection status, running editor) or when not to use it, leaving the agent to infer usage from the name and siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

stop_csv_profilingC

Stop CSV profiling capture and save results.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries the burden. It mentions 'stop capture and save results,' indicating mutation, but doesn't specify if any state changes are persistent, if it requires an active profiling session, or what the output format is. The behavior is under-disclosed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with a clear verb and object. It is appropriately concise, though it could add a little more context without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no annotations and no output schema, the description is minimal. For a state-changing tool like stopping profiling, it lacks context about the workflow (e.g., that it complements start_csv_profiling) and any effects on the system. It is not complete for an effective selection.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters and the schema is empty with 100% coverage, so the description doesn't need to explain parameters. The description correctly implies no parameters are needed, and the baseline for no params is 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool stops CSV profiling and saves results, with a specific verb and resource. However, it lacks differentiation from its sibling 'start_csv_profiling' and other profiling tools, so it's not fully distinguished.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not mention when to use this tool or any context about prerequisites (e.g., it must be called after start_csv_profiling). There is no guidance on alternatives, as it's the only stop profiling tool, but usage context is minimal.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

stop_traceA

Stop the active Unreal Insights trace session.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for disclosing side effects. It only states the action without mentioning potential errors (e.g., no active session), data saving, or state changes, leaving the agent underinformed about consequences.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no redundancy. It is appropriately sized for the tool's simplicity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is sufficient for a basic stop operation, but it lacks information about return values, error handling, or what happens when no trace is active. Given no output schema, a bit more context would be beneficial, though not critical for a simple command.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the schema covers everything. The description does not need to explain parameters, and the baseline of 4 applies since there are no params.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (stop) and the resource (active Unreal Insights trace session). It is specific and unambiguous, and distinguishes well from sibling tools like start_trace and start_csv_profiling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage after starting a trace, but does not explicitly state when to use it or provide guidance on alternatives or preconditions. It is functional but minimal.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

take_screenshotB

Capture a screenshot of the active editor viewport. Returns the file path of the saved image.

ParametersJSON Schema
NameRequiredDescriptionDefault
filenameNoOutput filename (default: screenshot_<timestamp>.png)

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It mentions capturing the viewport and returning the file path, but omits details such as where the file is saved, whether it overwrites existing files, and any prerequisites (e.g., an active viewport). This is insufficient for a tool that creates a file.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise: two sentences with no filler. The first sentence states the core action, the second states the return value. It is appropriately sized for the tool's simplicity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the tool is simple and the schema covers the parameter, the description lacks critical contextual details such as where the screenshot is saved, error conditions (e.g., no active viewport), and file naming behavior beyond the schema default. Without annotations, the description should provide more context to ensure correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter (filename) is fully described in the schema with 100% coverage, including its default value. The description adds no further meaning about how the parameter behaves (e.g., whether it accepts a full path), so it provides no added value beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Capture a screenshot') and specifies the target ('active editor viewport'), uniquely distinguishing this tool from siblings. It also mentions the return value (file path), which further clarifies its purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives (e.g., render_sequence) or any conditions. It only states what it does, leaving the agent to infer usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

undoA

Undo the last editor action.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description must convey behavioral traits. It states 'Undo the last editor action' but does not disclose that it modifies state, whether it is reversible, or what happens if there is no prior action. It does not contradict annotations, but is too sparse to inform an agent about side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that is front-loaded with the essential information. Every word earns its place, and there is no redundancy or fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with no parameters and no output schema, the description is sufficient to convey the operation. However, it could optionally mention edge cases (e.g., no-op if nothing to undo), but given the simplicity, it is largely complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parametersches, and the schema description coverage is 100% (empty properties). The baseline for 0 params is 4, and the description adds nothing beyond the schema because there is nothing to explain. This is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Undo the last editor action' clearly specifies the operation (undo) and resource (editor action), distinguishing it from sibling tools like redo and get_undo_history. The verb and target are precise and unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like get_undo_history or redo. It does not mention prerequisites, conditions, or exclusions. While the function is obvious, explicit guidance is absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

validate_assetsC

Run data validation on assets in a directory.

ParametersJSON Schema
NameRequiredDescriptionDefault
directoryNoContent directory to validate/Game

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It only says 'Run data validation,' which is nearly identical to the tool's name. It does not disclose whether the operation is read-only, whether it modifies assets, what output it returns, or how errors are reported.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence ('Run data validation on assets in a directory.') that is concise, front-loaded, and free of unnecessary words. It communicates the core action efficiently.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no annotations and no output schema, the description is too sparse. It doesn't explain what validation entails, what results are produced, or how this tool relates to the sibling 'validate_data.' This is inadequate for an agent to select the correct tool among many similar asset and validation tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has one parameter 'directory' with a full description ('Content directory to validate'), achieving 100% schema coverage. The tool description merely references 'a directory,' adding little beyond what the schema already states. The baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'Run' and identifies the resource as 'data validation on assets' with a scope of 'in a directory.' It clearly states what the tool does, though it does not explicitly distinguish it from the sibling tool 'validate_data' or other asset-related tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives like 'validate_data' or 'content_audit.' No prerequisites, contexts, or exclusions are provided, leaving the agent to infer usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

validate_dataC

Trigger the Data Validation framework on assets.

ParametersJSON Schema
NameRequiredDescriptionDefault
directoryNoContent directory to validate/Game

TDQS

C2.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for disclosing behavioral traits. It only says 'Trigger the Data Validation framework' without describing what happens during validation, whether it is read-only or mutating, what output/return value to expect, or any side effects. This is a significant transparency gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. It is appropriately concise, though it could benefit from an additional sentence to differentiate from siblings, which would improve usability without becoming verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the existence of the closely named sibling 'validate_assets' and the absence of an output schema, the description is incomplete. It does not clarify what the Data Validation framework returns, how results are reported, or when this tool is preferred over similar validation/audit tools. The one-line description leaves the agent underinformed for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage with the parameter description 'Content directory to validate', so the baseline is 3. The tool description adds no extra meaning beyond the schema; it merely rephrases 'on assets' without providing context about the directory parameter's format, scope, or behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific action ('Trigger the Data Validation framework') and the resource ('assets'). However, it does not differentiate from the sibling tool 'validate_assets', which likely performs a similar validation role, so it lacks explicit distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus alternatives such as 'validate_assets' or 'run_map_check'. There are no use-case examples, exclusions, or conditions, leaving the agent without basis for selecting this tool over its siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 127 tool updatesv0.1.0
    • First observedadd_actor_binding
    • First observedadd_blueprint_component
    • First observedadd_blueprint_function
    • First observedadd_blueprint_variable
    • First observedadd_graph_node
    • First observedadd_track
    • First observedapply_anim_modifier
    • First observedapply_material
    • First observedbuild_cook_run
    • First observedbuild_graph
    • First observedbuild_plugin
    • First observedbuild_target
    • First observedcall_preset_function
    • First observedclean_project
    • First observedcompile_blueprint
    • First observedconnect_graph_nodes
    • First observedconnect_material_expressions
    • First observedconnect_material_property
    • First observedconsolidate_assets
    • First observedcontent_audit
    • First observedcook_content
    • First observedcreate_anim_blueprint
    • First observedcreate_anim_montage
    • First observedcreate_blueprint
    • First observedcreate_level_sequence
    • First observedcreate_material
    • First observedcreate_material_expression
    • First observedcreate_material_function
    • First observedcreate_material_instance
    • First observeddelete_actor
    • First observeddelete_asset
    • First observeddelete_material_expression
    • First observeddisable_plugin
    • First observedduplicate_actors
    • First observedduplicate_asset
    • First observedenable_plugin
    • First observedexecute_console_command
    • First observedexecute_python
    • First observedexport_asset
    • First observedexport_sequence_fbx
    • First observedfix_redirectors
    • First observedgenerate_collision
    • First observedgenerate_lightmap_uvs
    • First observedgenerate_lods
    • First observedgenerate_project_files
    • First observedget_actor_components
    • First observedget_actor_properties
    • First observedget_anim_sequence_info
    • First observedget_asset_info
    • First observedget_asset_references
    • First observedget_blueprint_info
    • First observedget_build_status
    • First observedget_connection_status
    • First observedget_loaded_cells
    • First observedget_preset_info
    • First observedget_preset_property
    • First observedget_sequence_info
    • First observedget_test_results
    • First observedget_undo_history
    • First observedget_viewport_camera
    • First observedimport_asset
    • First observedlist_actors
    • First observedlist_assets
    • First observedlist_automation_tests
    • First observedlist_data_layers
    • First observedlist_graph_nodes
    • First observedlist_material_expressions
    • First observedlist_plugins
    • First observedlist_presets
    • First observedpackage_project
    • First observedrecompile_material
    • First observedredo
    • First observedreimport_skeletal_mesh
    • First observedreinit_niagara_system
    • First observedremove_graph_node
    • First observedrename_asset
    • First observedrender_sequence
    • First observedresave_packages
    • First observedreset_niagara_system
    • First observedrun_all_automation_tests
    • First observedrun_automation_test
    • First observedrun_automation_tests_by_category
    • First observedrun_editor_utility_blueprint
    • First observedrun_editor_utility_widget
    • First observedrun_gauntlet
    • First observedrun_map_check
    • First observedrun_stat_command
    • First observedsave_all
    • First observedsave_asset
    • First observedsc_checkin
    • First observedsc_checkout
    • First observedsc_diff
    • First observedsc_mark_for_add
    • First observedsc_revert
    • First observedsc_status
    • First observedsearch_assets
    • First observedselect_actors
    • First observedset_actor_property
    • First observedset_actor_tags
    • First observedset_actor_transform
    • First observedset_blueprint_property
    • First observedset_data_layer_state
    • First observedset_material_instance_scalar
    • First observedset_material_instance_texture
    • First observedset_material_instance_vector
    • First observedset_niagara_bool
    • First observedset_niagara_color
    • First observedset_niagara_float
    • First observedset_niagara_vector
    • First observedset_playback_range
    • First observedset_preset_property
    • First observedset_sequence_framerate
    • First observedset_skeletal_mesh_lod
    • First observedset_streaming_source
    • First observedset_viewport_camera
    • First observedspawn_actor
    • First observedspawn_blueprint_actor
    • First observedspawn_niagara_at_location
    • First observedspawn_niagara_attached
    • First observedstart_csv_profiling
    • First observedstart_trace
    • First observedstop_csv_profiling
    • First observedstop_trace
    • First observedtake_screenshot
    • First observedundo
    • First observedvalidate_assets
    • First observedvalidate_data

TDQS

C2.9/5.0

Scored across 127 tools

Disambiguation3/5

Many tools are clearly distinct, but there are clusters that could cause misselection: run_stat_command overlaps with execute_console_command, build_cook_run and package_project both package the project, and reset_niagara_system vs reinit_niagara_system are similar. Descriptions help clarify, but the volume of tools increases ambiguity.

Naming Consistency3/5

Most tools follow a verb_noun pattern, but there are notable deviations: sc_ prefix for source control (sc_status vs source control), run_* vs execute_* for similar actions, and inconsistent granularity like build_target vs build_cook_run vs package_project. Still readable, but not a clean consistent scheme.

Tool Count1/5

127 tools is extremely excessive for any MCP server, even for a complex engine like Unreal. This volume overwhelms agents and makes tool selection costly. A more focused set of 30-40 tools would likely cover the same workflows.

Completeness4/5

The toolset covers an impressive breadth of Unreal workflows: asset management, actor manipulation, blueprints, materials, animation, Niagara, build automation, testing, source control, profiling, and world partition. Minor gaps exist (e.g., explicit level save/manage), but overall the surface is remarkably complete for its scope.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    Enables AI assistants to control Unreal Engine via Remote Control API for game development automation, including asset management, actor control, level editing, animation, physics, visual effects, and cinematics creation through natural language.
    1
    164 npm
    872
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Gives AI assistants deep read/write access to the Unreal Editor through 21 category tools covering 525+ actions, plus a YAML flow engine for multi-step workflows.
    5,017 npm
    331
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    Controls Unreal Engine 5 editor from AI coding assistants, enabling 280 commands across 13 categories for materials, blueprints, Niagara VFX, and more.
    100
    77 PyPI
    39
    Mozilla Public 2.0