Skip to main content
Glama

unreal_add_material_expression

Add material expressions to Unreal Engine material graphs, enabling AI clients to build or extend material logic via the local editor bridge.

Instructions

Add a material expression.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "params": "<params>"
    },
    "name": "unreal_add_material_expression"
  }
}

Input Schema

NameRequiredDescriptionDefault
paramsYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

C2/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 behavioral burden and discloses almost nothing. 'Add' implies a mutation, but the description is silent on whether the target material must already exist, whether the expression is persisted or requires a compile/save step, what permissions or editor state are needed, and whether the operation is reversible.

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 sentence is short and front-loaded, but its brevity comes from omission rather than economy. There is a single generic statement where the tool's opaque parameter and mutation semantics demand far more.

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 tool whose only parameter is an undescribed free-form object, with no annotations and no output schema detail in the description, this is inadequate. Even though an output schema exists and return values need not be spelled out, the input contract and behavior remain entirely unexplained.

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 single required parameter 'params' has 0% schema description coverage and no documented properties, and the description adds nothing about its contents. An agent cannot tell what must be supplied (expression class, position, owning material, pin links) from either source, so the meaning is effectively undisclosed.

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?

'Add a material expression' names a concrete verb and resource, so the basic operation is identifiable. But it does not say what a material expression is, which material or graph receives it, or how it differs from nearby tools like unreal_connect_material_nodes or unreal_create_material. It largely restates the tool name without added 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?

There is no guidance on when to use this tool versus alternatives such as unreal_create_material, unreal_connect_material_nodes, or unreal_delete_material_expression. The only implied usage comes from the verb 'add'; no prerequisites, no exclusions, no context are stated.

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

Deploy Server

Other Tools