Skip to main content
Glama
ismailakdag

cst-studio-mcp

by ismailakdag

cst-studio-mcp

Python-first MCP server for CST Studio Suite · version 1.1.0

Drive CST from an AI assistant: open projects, build geometry, set materials and ports, run solvers, read S-parameters and farfield metrics, and generate design reports — through structured MCP tools on your Windows machine.

Package

cst-studio-mcp · entry point cst-studio-mcp

Tools

184 (workflows, geometry, antennas, solvers, results, PCB, …)

Python

3.10+ (3.12 recommended)

OS

Windows 10/11 + licensed CST Studio Suite

Docs

Interactive EN/TR browser: docs/index.html

Project presentation: presentation/index.html, a self-contained Turkish architecture and validation overview. See the reliability review for historical checks. Current evidence and limits are in the 2026 API review.

Start with the agent installation and acceptance guide. Official Python results were verified against all 4 × 4,001 complex samples in a completed CST 2026 project; an isolated modeler fixture also passed. The 184-tool catalog is not a blanket certification of advanced CST features.

Agent (Cursor / Claude / …)
        │  MCP stdio
        ▼
   cst-studio-mcp server
        │
        ├─ Python API   connect · project · solve · results (cst.interface / cst.results)
        └─ History VBA  geometry · materials · ports · monitors (model3d.add_to_history)
                │
                ▼
        CST Studio Suite (local install + license)

Table of contents

  1. What you get

  2. Requirements

  3. Installation

  4. Environment variables

  5. MCP client setup

  6. Verify the install

  7. Quick start (agents)

  8. Farfield & results notes

  9. Architecture

  10. Documentation site

  11. Development & tests

  12. Troubleshooting

  13. License

  14. Full tool catalog


Related MCP server: ansys-aedt-mcp

What you get

  • Full tool surface — project control, geometry, booleans, transforms, materials, ports, boundaries, mesh, solvers, simulation control, results, import/export, parameters, optimization helpers, antenna templates, arrays, PCB/SI, matching networks, VBA escape hatch.

  • Workflow helpers — one-shot patch antenna, solve + S11, design report, structure views, farfield discovery/metrics.

  • Portable paths — auto-detects CST on any drive letter; prefers AMD64\python_cst_libraries (CST 2024–2026). No hard-coded E:\ in library code.

  • Bilingual docs — English / Türkçe tool browser with light/dark theme.

  • Offline fallback — if CST is unreachable, many tools still return VBA for manual paste.


Requirements

Component

Notes

Windows

10 or 11 (64-bit)

CST Studio Suite

Core paths tested on 2026; its Python result reader supports saved 2025/2026 files. Other versions need local acceptance

CST license

Valid license for the solver you use

Python

3.10 – 3.13 (3.12 works well with CST’s bundled cp312 libs)

Disk

CST install + project work directory (simulations can be large)

CST Python libraries ship with the product, typically:

<CST_ROOT>\AMD64\python_cst_libraries

Examples:

  • C:\Program Files\CST Studio Suite 2026\AMD64\python_cst_libraries

  • E:\CST Studio Suite 2026\AMD64\python_cst_libraries


Installation

1. Clone the repository

git clone https://github.com/ismailakdag/cst-studio-mcp.git
cd cst-studio-mcp

In PowerShell, from the repo root (the folder that contains pyproject.toml):

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -U pip
pip install -e ".[dev]"

This installs:

  • Runtime dependencies: mcp>=1.29,<3, anyio>=4.5, and jsonschema>=4.20

  • Console script: cst-studio-mcp (also at .\.venv\Scripts\cst-studio-mcp.exe)

  • Dev extras: pytest, pytest-asyncio, ruff

Tip: open docs/index.html — the Setup section has Copy buttons for every PowerShell block, and a form that fills CST_PATH / PYTHONPATH / MCP JSON from the path you type.

3. Point Python / MCP at your CST install

You must tell the process where CST lives. Typical roots:

  • C:\Program Files\CST Studio Suite 2026

  • E:\CST Studio Suite 2026

Not the AMD64 folder itself — one level above. PYTHONPATH then points at:

%CST_PATH%\AMD64\python_cst_libraries

Session-only (current PowerShell window)

Replace the path with yours, then paste:

$env:CST_PATH = "C:\Program Files\CST Studio Suite 2026"
$env:PYTHONPATH = "$env:CST_PATH\AMD64\python_cst_libraries"
$env:CST_WORK_DIR = "C:\cst_projects"
$env:CST_VERSION = "2026"
New-Item -ItemType Directory -Force -Path $env:CST_WORK_DIR | Out-Null

Permanent (optional, Windows user env)

[Environment]::SetEnvironmentVariable("CST_PATH", "C:\Program Files\CST Studio Suite 2026", "User")
[Environment]::SetEnvironmentVariable("PYTHONPATH", "C:\Program Files\CST Studio Suite 2026\AMD64\python_cst_libraries", "User")
[Environment]::SetEnvironmentVariable("CST_WORK_DIR", "C:\cst_projects", "User")

For Cursor / Claude / other MCP clients, prefer putting the same keys in the server env block (next section) — that is what the AI process actually sees.


Environment variables

Nothing in the library hard-codes a drive letter. Discovery order:

  1. If CST_PATH is set → use it

  2. Else scan all drive letters for CST Studio Suite {CST_VERSION}

  3. Resolve AMD64\python_cst_libraries (fallback LinuxAMD64\... on dual layouts)

Variable

Required

Meaning

Example

CST_PATH

Recommended

CST install root

C:\Program Files\CST Studio Suite 2026

PYTHONPATH

Strongly recommended

Official CST Python package path

…\AMD64\python_cst_libraries

CST_WORK_DIR

Optional

Projects, exports, reports

%USERPROFILE%\cst_projects

CST_VERSION

Optional

Year for auto-detect (default 2026)

2026

CST_QUIET

Legacy

Accepted for compatibility; connecting no longer changes the user's CST UI mode

1

CST_CONNECT_MODE

Optional

Startup behavior: auto, manual, or disabled (default manual)

manual

CST_LOG_LEVEL

Optional

Logging level

INFO

auto attaches to a running Design Environment or starts one when the MCP process starts. Use disabled for catalog inspection, client setup checks, and offline VBA generation: it does not import the CST Python package or connect to CST. manual skips the startup connection while leaving CST available to the explicit cst_connect tool and connection workflows. It is the default, so adding an MCP server never implicitly launches CST. cst_disconnect detaches the MCP session; it does not close the application or its projects.

Template file: .mcp.example.json
Local machine paths: .mcp.json (edit paths only; keep out of shared commits if needed).


MCP client setup

Claude Desktop / Cursor JSON config

{
  "mcpServers": {
    "cst-studio": {
      "command": "cst-studio-mcp",
      "args": [],
      "env": {
        "CST_PATH": "C:\\Program Files\\CST Studio Suite 2026",
        "CST_WORK_DIR": "C:\\cst_projects",
        "CST_VERSION": "2026",
        "CST_CONNECT_MODE": "manual",
        "PYTHONPATH": "C:\\Program Files\\CST Studio Suite 2026\\AMD64\\python_cst_libraries",
        "CST_LOG_LEVEL": "INFO"
      }
    }
  }
}

If cst-studio-mcp is not on PATH (for example a venv), use the full executable:

"command": "C:\\path\\to\\cst-studio-mcp\\.venv\\Scripts\\cst-studio-mcp.exe"

Or:

"command": "python",
"args": ["-m", "cst_mcp.server"]

(with PYTHONPATH including CST libs).

Codex

Add the server to your Codex config.toml. Literal single-quoted TOML strings keep Windows backslashes intact; replace the example paths with your local installation paths.

[mcp_servers.cst-studio]
command = 'C:\path\to\cst-studio-mcp\.venv\Scripts\cst-studio-mcp.exe'
args = []

[mcp_servers.cst-studio.env]
CST_PATH = 'C:\Program Files\CST Studio Suite 2026'
CST_WORK_DIR = 'C:\cst_projects'
CST_VERSION = '2026'
CST_CONNECT_MODE = 'manual'
PYTHONPATH = 'C:\Program Files\CST Studio Suite 2026\AMD64\python_cst_libraries'

Reload the MCP configuration, confirm the cst-studio tools are available, and call cst_connect only when you are ready to attach to CST. See the official Codex MCP documentation for current configuration locations and controls.

Cursor

  1. Open Cursor Settings → MCP (or project MCP JSON / root .mcp.json, depending on Cursor version).

  2. Add the cst server block with your CST_PATH and PYTHONPATH.

  3. Restart MCP / reload the window.

  4. Confirm ~170+ tools under server cst.

After code changes, restart the MCP server process so Python reloads the package.

Claude Desktop

Edit the Claude Desktop config JSON (Windows typically under %APPDATA%\Claude\) and add the same mcpServers.cst-studio block. Fully quit and restart Claude Desktop.

Claude Code / CLI

Add the server via your usual MCP config (project or user), same command + env. Restart the session after edits.

Other MCP hosts

Any client that supports MCP stdio servers can use cst-studio-mcp with the same environment variables.

The process uses newline-delimited JSON-RPC on stdout. Logs and diagnostics are written to stderr, so clients must keep stdout reserved for MCP messages. For a first client-side check, set CST_CONNECT_MODE to disabled, restart the MCP process, and verify that initialize, tools/list, and cst_connection_status succeed. Change it to auto only when the client configuration points to the intended CST installation.

MCP clients use two common configuration envelopes. Clients such as Claude Desktop and Cursor use the mcpServers object shown above. Clients whose schema uses a servers object generally need the same process definition in this shape:

{
  "servers": {
    "cst-studio": {
      "type": "stdio",
      "command": "C:\\path\\to\\.venv\\Scripts\\cst-studio-mcp.exe",
      "args": [],
      "env": {
        "CST_PATH": "C:\\Program Files\\CST Studio Suite 2026",
        "CST_WORK_DIR": "C:\\cst_projects",
        "CST_CONNECT_MODE": "manual"
      }
    }
  }
}

Use the field names required by the client, but keep command, args, and env unchanged. Prefer the absolute console-script path on Windows; it avoids differences in each client's PATH.


Verify the install

# 1) Package entry point exists
Get-Command cst-studio-mcp

# 2) CST Python libs importable
python -c "import cst.interface; print('CST interface OK')"

# 3) Config auto-detect
python -c "from cst_mcp.config import CSTConfig; c=CSTConfig.from_env(); print(c.cst_path); print(c.python_lib_path); print('available', c.cst_available)"

# 4) Offline unit tests (no live solve required)
$env:PYTEST_DISABLE_PLUGIN_AUTOLOAD = "1"
python -m pytest tests/ -q

From an MCP client, call:

  1. cst_connect — explicitly attach to CST when ready (or opt into CST_CONNECT_MODE=auto); then cst_connection_status reports the session. With disabled, the server remains offline.

  2. Prefer workflows for smoke tests (see below)


Quick start (agents)

Recommended order for a first successful run:

Step

Tool

Purpose

1

cst_connection_status

Confirm connected mode

2

cst_workflow_patch_antenna

Parametric microstrip patch (substrate, ground, feed, WG port, farfield monitor)

3

cst_workflow_simulate_and_report or cst_run_simulation

Solve

4

cst_get_s_parameters / cst_get_farfield_metrics

S11 + antenna metrics

5

cst_workflow_design_report

Package: params, S-params, farfield, views

Other useful entry points:

  • cst_antenna_patch — template builder (similar geometry stack)

  • cst_design_patch_only — offline dimension calculator (no CST)

  • cst_export_structure_views — multi-view structure images

  • cst_discover_farfield_monitors — find farfield results on disk

Parametric tip: dimensions should live in the CST Parameter List and geometry history should use expressions (for example patch_L/2). Then parameter change → delete results → rebuild → solve updates the model without rewriting history by hand.


Farfield & results notes

These details matter for reliable automation on CST 2026:

Topic

Guidance

Monitor VBA

Official Monitor API: .Frequency, FieldType "Farfield", frequency domain. Prefer EnableNearfieldCalculation "True".

Tree path

After TD solve: Farfields\farfield (f=2.4) [1] (port excitation suffix [1]).

Metrics API

Prefer FarfieldPlot.Plot then GetMax / GetRadiationEfficiency. Do not rely on ASCIIExportSummary (often fails with export/HEX mesh errors and Message spam).

MCP tool

cst_get_farfield_metrics — 1D Results (S11, efficiencies) + GetMax when the tree item is available.

1D Results

cst.results.ProjectFile is reliable for S-parameters and efficiencies when the .cst path is known.


Architecture

src/cst_mcp/
  server.py          MCP entry (stdio)
  config.py          Multi-drive CST discovery
  session.py         Design Environment / project / solve / export / farfield metrics
  cst_client.py      Public client façade used by tools
  tools/             One module per category (workflows, geometry, …)
  execution/         VBA helpers, port VBA, farfield, results_api, CSV readers
  domain/            Pure design math (e.g. patch sizing)
  data/              Material / template JSON

Layer

Role

MCP tools

Schemas + handlers; agent-facing

CSTClient / Session

Connection lifecycle, history VBA, Python solver/results

execution/

Portable VBA snippets (ports, farfield metrics dump)

CST product

Mesh, TD/FD solvers, result tree

Reference / upstream history (not required at runtime): _reference/.
Official VBA object dump for alignment: vba_cst/.


Documentation site

Path

Content

docs/index.html

Interactive EN/TR tool browser, light/dark, search, copy full tool text, install guide

docs/TOOLS.md

Markdown catalog

docs/tools.json

Machine-readable schemas

docs/VBA_ALIGNMENT.md

VBA fixes vs CST Online Help dump

docs/README.md

How to open/rebuild docs

# Open UI
start docs\index.html

# Or local server
python -m http.server 8080 --directory docs

# Rebuild HTML + JSON + Markdown + README catalog from live tools
python scripts/build_docs.py

Development & tests

pip install -e ".[dev]"
$env:PYTEST_DISABLE_PLUGIN_AUTOLOAD = "1"   # avoid broken global pytest plugins
python -m pytest tests/ -v
python scripts/build_docs.py
ruff check src tests

Optional live CST scripts under scripts/ (require license). Prefer unit tests for offline checks.


Troubleshooting

Symptom

What to try

import cst / cst.interface fails

Set PYTHONPATH to …\AMD64\python_cst_libraries (not only install root).

MCP shows few tools / old behavior

Restart the MCP server process after pip install -e . or code edits.

mode=offline

Set CST_PATH + PYTHONPATH. Confirm license. Start Design Environment once.

Port “floating” in air

Free port plane with PortOnBound False flush to feed edge (workflow port helper).

Farfield Message spam / “No HEX mesh”

Avoid ASCIIExportSummary spam. Use cst_get_farfield_metrics. Create monitor before solve.

SelectTreeItem fails for farfield

Full path Farfields\farfield (f=<freq>) [1].

Parameter List empty / rebuild no shape change

History must use parameter expressions, not only bare numbers.

Dialogs block automation

CST_QUIET=1; diagnostics / dismiss-dialog tools.

pytest plugin import errors

PYTEST_DISABLE_PLUGIN_AUTOLOAD=1.


License

MIT


Full tool catalog (184 tools)

Interactive bilingual docs: open docs/index.html (EN/TR toggle, search, full-width cards). Rebuild: python scripts/build_docs.py.

VBA for geometry/ports/transforms is cross-checked against the CST help dump in vba_cst/.

Official API and saved results (4)

Read local CST Python/VBA help and complex saved results without opening CST.

Tool

What it does

cst_search_help

Search the installed official CST Python/VBA help by topic filename. Does not start CST. Read the matching help before constructing API c…

cst_read_help

Read a paginated official local CST help topic returned by cst_search_help. No GUI or solver.

cst_list_saved_results

List exact result tree paths and run IDs from a saved, unpacked, completed .cst file using cst.results. No connection or CST GUI is requi…

cst_read_saved_result

Read a complete complex 1D curve by exact tree path and run_id from a completed saved .cst, without opening CST. Raw real/imag are preser…

Explicit connection (2)

Attach to CST explicitly; disconnect without closing user projects.

Tool

What it does

cst_connect

Explicitly attach to a running CST Design Environment or start one. Disabled mode never connects.

cst_disconnect

Detach this MCP session without closing CST, projects, or a running solver.

Workflows (start here) (8)

One-shot helpers for common tasks. New users should start here.

Tool

What it does

cst_workflow_patch_antenna

END-TO-END / Uçtan uca: size a rectangular microstrip patch, build substrate/ground/patch/feed, frequency, open BCs, waveguide port, farf…

cst_workflow_run_and_s11

Run solver and return structured S11/Sij with metrics (min dB, bandwidth). Solver çalıştırır ve S parametrelerini metriklerle döner.

cst_design_patch_only

Calculate microstrip patch dimensions only (offline, no CST). Sadece boyut hesabı — CST gerekmez.

cst_export_structure_views

Export structure screenshots (perspective/xy/xz/yz) via Plot.ExportImage. Yapı görünüm görsellerini dışa aktarır. Connected mode required.

cst_workflow_design_report

ONE-SHOT design package after modeling/simulation: project status, parameters/dimensions, S-parameters (+metrics), best-effort farfield e…

cst_workflow_simulate_and_report

Run the solver, then immediately build a design report (S-params + views + optional farfield). Simülasyonu çalıştırıp rapor paketini üretir.

cst_discover_farfield_monitors

Discover farfield monitors from the project Result folder and tree-path heuristics. Uzak alan monitörlerini disk + path sezgisiyle listeler.

cst_get_farfield_metrics

Read antenna metrics after a solve: S11 + radiation/total efficiency from 1D Results, plus max realized gain via official FarfieldPlot.Ge…

Project & connection (8)

Create, open, save projects and check CST connection.

Tool

What it does

cst_create_project

Create a new CST Studio Suite project file. In connected mode the project is created directly; in offline mode a VBA script is returned f…

cst_open_project

Open an existing CST Studio Suite project. In connected mode the project is opened in the running instance; in offline mode a reference i…

cst_save_project

Save the currently open CST project. Optionally provide a new path to 'Save As'.

cst_close_project

Close the currently open CST project and release its resources.

cst_project_info

Get information about the currently open CST project, including connection mode, project path, and status.

cst_project_tree

List items in the CST project navigation tree. Optionally specify a subtree path such as 'Components', 'Materials', 'Ports', 'Monitors', …

cst_export_project

Export the current CST project or its geometry to another format such as STL, STEP, IGES, SAT, OBJ, or NASTRAN.

cst_connection_status

Get the current CST Studio connection status, including mode (connected/offline), CST availability, version, and work directory.

Geometry (13)

3D shapes: bricks, cylinders, spheres, extrusions, wires…

Tool

What it does

cst_create_brick

Create a rectangular brick (box) in CST Studio.

cst_create_cylinder

Create a cylinder in CST Studio. Use inner_radius=0 for a solid cylinder.

cst_create_cone

Create a cone or truncated cone in CST Studio.

cst_create_sphere

Create a sphere in CST Studio.

cst_create_torus

Create a torus in CST Studio.

cst_create_extrude

Extrude a 2D polygon profile into a 3D solid in CST Studio.

cst_create_loft

Create a lofted solid between two or more 2D profiles in CST Studio.

cst_create_wire

Create a bondwire / wire between two points in CST Studio.

cst_create_polygon3d

Create a 3D polygon curve in CST Studio.

cst_create_analytical_curve

Create a parametric analytical curve in CST Studio using expressions of parameter t.

cst_create_face_from_curves

Create a planar face from one or more closed curves in CST Studio.

cst_create_ecylinder

Create an elliptical cylinder in CST Studio.

cst_create_polygon_extrude

Create a polygon and extrude it along an axis in CST Studio. Convenience tool combining polygon profile creation and extrusion.

Boolean operations (4)

Combine solids: add, subtract, intersect, insert.

Tool

What it does

cst_boolean_add

Unite/add two solids together. The result replaces solid1 with the combined volume of both shapes.

cst_boolean_subtract

Subtract solid2 from solid1. The overlapping volume of solid2 is removed from solid1. Solid2 is deleted.

cst_boolean_intersect

Intersect two solids. Only the overlapping volume is kept, replacing solid1. Solid2 is deleted.

cst_boolean_insert

Insert solid2 into solid1. Solid2 is embedded within solid1, maintaining both material regions at the overlap.

Transforms (4)

Move, rotate, mirror, and scale solids.

Tool

What it does

cst_transform_translate

Translate (move) a solid by a displacement vector (dx, dy, dz). Optionally create a translated copy.

cst_transform_rotate

Rotate a solid by a given angle around an axis (x, y, or z). An optional center point can be specified.

cst_transform_mirror

Mirror a solid across a plane (xy, xz, or yz). An optional center point can be specified.

cst_transform_scale

Scale a solid by independent factors along each axis. An optional center point can be specified.

Materials (15)

Metals, dielectrics, and advanced material models.

Tool

What it does

cst_create_material

Create a new material with electromagnetic properties in CST Studio. Specify relative permittivity (epsilon), relative permeability (mu),…

cst_create_lossy_metal

Create a lossy metal material in CST Studio. Lossy metals model finite conductivity skin-effect losses, essential for accurate loss calcu…

cst_create_anisotropic_material

Create an anisotropic material with per-axis permittivity, permeability, and loss tangent values. Used for crystals, metamaterials, and c…

cst_load_material

Load a material from the CST material library by its library name. The material is added to the project under the given name.

cst_list_materials

List available materials from the bundled material database. Optionally filter by category: 'metals', 'dielectrics', or 'substrates'. Ret…

cst_assign_material

Assign a material to an existing solid in CST Studio. The solid is specified as 'Component:SolidName'.

cst_get_material_info

Get electromagnetic properties of a material from the bundled database. Returns epsilon_r, mu_r, conductivity, loss tangent, and usage no…

cst_delete_material

Delete a material from the current CST project.

cst_create_debye_material

Create a frequency-dependent dielectric material using the Debye relaxation model. Models polar dielectrics where permittivity decreases …

cst_create_lorentz_material

Create a Lorentz oscillator dispersive material. Models resonant dielectric behaviour near absorption bands: eps(w) = eps_inf + delta_eps…

cst_create_drude_material

Create a Drude metal model material for plasmonic and metamaterial simulations. Models free-electron metals: eps(w) = 1 - wp^2 / (w^2 + j…

cst_create_ferrite_material

Create a ferrite material with gyrotropic permeability tensor (Polder model). Essential for circulators, isolators, and phase shifters. T…

cst_create_temperature_dependent_material

Create a material with temperature-dependent electromagnetic properties. Specify base properties and temperature coefficients for thermal…

cst_create_cole_cole_material

Create a Cole-Cole dispersive material. Generalisation of the Debye model with a distribution parameter alpha (0-1) that broadens the rel…

cst_list_ferrite_materials

List available ferrite materials from the bundled database. Returns name, permittivity, saturation magnetisation, linewidth, loss tangent…

Ports & excitations (8)

Waveguide, discrete, plane wave, Floquet…

Tool

What it does

cst_add_waveguide_port

Add a waveguide port for S-parameter excitation. Defines a port face on the boundary of the simulation domain for guided-wave excitation.…

cst_add_discrete_port

Add a discrete (lumped) port between two points. Used for circuit-level excitation with a defined impedance.

cst_add_lumped_element

Add a lumped R, L, C, or RLC element between two points. Value is in ohms for R, henries for L, farads for C.

cst_add_plane_wave

Add a plane wave excitation source. Defines an incident plane wave with given direction and polarization for scattering / RCS analysis.

cst_add_floquet_port

Add a Floquet port for periodic structures such as frequency selective surfaces, metamaterials, and phased arrays.

cst_list_ports

List all ports defined in the current CST project. Returns VBA to query port information, or a description in offline mode.

cst_delete_port

Delete a port by its port number.

cst_add_multipin_port

Add a waveguide port with multiple mode monitoring for higher-order mode analysis. Used for multimode waveguides, mode converters, and st…

Boundaries & setup (6)

Open/electric walls, background, symmetry, frequency range.

Tool

What it does

cst_set_boundary

Set boundary conditions for the simulation domain. Each face of the bounding box can be assigned an independent boundary type (open, elec…

cst_set_background

Set the background material properties of the simulation domain. The background fills all space not occupied by defined solids.

cst_set_symmetry

Set symmetry planes to reduce computation time. Each axis can be assigned electric or magnetic symmetry, or none. Requires the model geom…

cst_set_frequency_range

Set the simulation frequency range in GHz. This determines the bandwidth over which the solver computes results.

cst_set_periodic_boundary

Configure periodic boundary conditions with optional phase shift for unit cell simulation. Sets X and Y boundaries to periodic and config…

cst_set_floquet_port_advanced

Configure advanced Floquet port settings for periodic structures. Controls the number of Floquet modes and scan angle for phased array el…

Mesh (8)

Mesh type, density, refinement, adaptive meshing.

Tool

What it does

cst_set_mesh_type

Set the mesh type for the simulation. Hexahedral is used for time-domain, Tetrahedral for frequency-domain, Surface for integral-equation…

cst_set_mesh_density

Set global mesh density parameters controlling automatic mesh generation. Higher cells_per_wavelength gives finer mesh and better accurac…

cst_add_mesh_refinement

Add local mesh refinement to a specific solid. This creates finer mesh around critical geometry features like feed points, gaps, or thin …

cst_set_adaptive_mesh

Configure adaptive mesh refinement. When enabled, the solver runs multiple passes, refining the mesh in regions of high field gradient un…

cst_get_mesh_info

Get current mesh statistics and settings. In connected mode this queries the live mesh data; in offline mode it returns the VBA to retrie…

cst_get_mesh_quality

Extract mesh quality metrics including total cells, aspect ratios, and cells per wavelength. In connected mode this queries actual mesh s…

cst_set_pml_properties

Configure PML (Perfectly Matched Layer) absorbing boundary properties. Controls the number of absorbing layers and the target reflection …

cst_add_fixpoint_mesh

Add a fixed mesh point at specific coordinates for precise field sampling. Ensures the mesh contains a node exactly at the specified loca…

Solvers (8)

Time domain, frequency domain, eigenmode, IE…

Tool

What it does

cst_configure_time_domain_solver

Configure the time domain (transient) solver. This is CST's flagship solver for broadband simulations — it excites the structure with a p…

cst_configure_frequency_domain_solver

Configure the frequency domain solver. Best for narrowband problems, resonant structures, and when field distributions at specific freque…

cst_configure_eigenmode_solver

Configure the eigenmode solver. Computes resonant frequencies and field distributions of cavity structures. Used for filter design, reson…

cst_configure_integral_equation_solver

Configure the integral equation (IE) solver. Best for electrically large, open-boundary problems like antenna placement on vehicles, RCS …

cst_get_solver_info

Get current solver configuration and status. In connected mode this queries the active solver settings; in offline mode it describes expe…

cst_configure_eigenmode_advanced

Advanced eigenmode solver configuration for higher-order modes. Use this for waveguide mode analysis, cavity resonator design, and filter…

cst_configure_ie_solver_advanced

Advanced Integral Equation solver configuration for electrically large structures. Provides control over preconditioner, MLFMM accelerati…

cst_configure_multilayer_solver

Configure the solver for planar multilayer structures. Optimised for antenna-on-PCB, frequency selective surfaces (FSS), and radome analy…

Simulation control (6)

Run, pause, resume, stop simulations.

Tool

What it does

cst_run_simulation

Start a CST simulation with the current solver settings. This is a blocking call that waits for the simulation to complete. Use cst_run_s…

cst_run_simulation_async

Start a CST simulation asynchronously (non-blocking). The simulation launches and control returns immediately. Use cst_get_simulation_sta…

cst_get_simulation_status

Read whether a CST simulation is running and return any solver-run metadata exposed by the CST Python API. This does not show a dialog or…

cst_pause_simulation

Pause a currently running CST simulation. The simulation can be resumed later with cst_resume_simulation.

cst_resume_simulation

Resume a previously paused CST simulation. Use after cst_pause_simulation to continue from where it stopped.

cst_stop_simulation

Stop and abort a running CST simulation. Unlike pause, a stopped simulation cannot be resumed — it must be restarted from the beginning.

Results (22)

S-parameters, far-field, VSWR, gain, Smith, bandwidth…

Tool

What it does

cst_get_s_parameters

Extract S-parameter results from a completed CST simulation. Returns S-parameter data (magnitude, phase, real/imaginary) for the specifie…

cst_get_farfield

Get far-field radiation pattern results from a completed CST simulation at a specific frequency. Returns gain, directivity, radiation eff…

cst_add_field_monitor

Add a field monitor at a specific frequency to the CST project. Field monitors must be defined before running a simulation to capture fie…

cst_get_impedance

Get input impedance (Z-parameters) for a port from a completed CST simulation. Returns real and imaginary impedance vs frequency. Useful …

cst_get_vswr

Get Voltage Standing Wave Ratio (VSWR) for a port from a completed CST simulation. VSWR indicates impedance matching quality: 1.0 is perf…

cst_get_gain

Get antenna gain at a specific frequency from a completed CST simulation. Returns peak gain in dBi and the direction (theta, phi) of maxi…

cst_get_efficiency

Get antenna radiation efficiency from a completed CST simulation at a specific frequency. Returns total efficiency (including mismatch), …

cst_list_results

List all available results in the CST result tree. Optionally specify a subtree path to narrow the listing. Useful for discovering what s…

cst_export_result

Export a simulation result to a file (CSV, Touchstone, or text). Specify the result tree path and desired output format. Useful for post-…

cst_get_result_summary

Get a summary of all key simulation results from a completed CST simulation. Returns an overview of S-parameters, gain, efficiency, and i…

cst_get_s_parameter_phase

Extract S-parameter phase response from a completed CST simulation. Returns the phase of the specified S-parameter vs frequency. Optional…

cst_get_group_delay

Compute group delay from S-parameter phase for a port pair. Group delay is defined as tau = -d(phase)/d(2pif) and represents the signal…

cst_get_pattern_cut

Extract an E-plane, H-plane, or custom radiation pattern cut from a completed CST simulation at a specific frequency. Returns gain vs ang…

cst_get_cross_polarization

Extract cross-polarization level and cross-polarization discrimination (XPD) from a completed CST simulation. Supports Ludwig-3, Ludwig-2…

cst_get_axial_ratio

Extract axial ratio for circularly polarized antennas from a completed CST simulation. Axial ratio (AR) indicates the quality of circular…

cst_get_surface_current

Extract surface current density distribution from a completed CST simulation at a specific frequency. Useful for understanding current fl…

cst_get_efficiency_breakdown

Get a detailed efficiency breakdown with loss budget from a completed CST simulation. Returns radiation efficiency, total efficiency, and…

cst_get_time_domain_signal

Extract time-domain port signal waveforms from a completed CST time-domain simulation. Returns incident, reflected, or transmitted signal…

cst_get_smith_chart_data

Extract Smith chart formatted impedance data from a completed CST simulation. Computes normalized impedance from S11 reflection coefficie…

cst_get_bandwidth

Calculate impedance bandwidth from S-parameter results. Finds the frequency range where S11 (or VSWR) meets the specified threshold. Retu…

cst_get_radiation_pattern_3d

Export full 3D radiation pattern data from a completed CST simulation at a specific frequency. Returns gain values over the full sphere i…

cst_get_current_distribution

Extract volume current distribution from a completed CST simulation at a specific frequency. Complements surface current extraction by pr…

Import / export (5)

CAD and Touchstone import/export, far-field export.

Tool

What it does

cst_import_cad

Import a CAD file into CST Studio. Supports STEP (.stp/.step), IGES (.igs/.iges), STL (.stl), SAT/ACIS (.sat), DXF (.dxf), and OBJ (.obj)…

cst_export_cad

Export the current CST model (or a specific component) to a CAD format. Supports STL, SAT/ACIS, STEP, IGES, OBJ, and NASTRAN.

cst_import_touchstone

Import a Touchstone S-parameter file (.s1p, .s2p, .snp) into CST Studio for use as a reference or circuit element.

cst_export_touchstone

Export S-parameter simulation results to a Touchstone file. Requires a completed simulation with S-parameter data.

cst_export_farfield

Export far-field radiation pattern data to a file. Requires a completed simulation with far-field monitor results.

Parameters & optimizers (11)

Design parameters, sweeps, optimizers, sensitivity, yield.

Tool

What it does

cst_set_parameter

Set or create a design parameter in CST Studio. Parameters can hold numeric values or string expressions referencing other parameters.

cst_get_parameter

Get the current value of a design parameter. Returns both the stored expression and the evaluated numeric value.

cst_list_parameters

List all design parameters in the current CST project with their names, expressions, and evaluated numeric values.

cst_delete_parameter

Delete a design parameter from the CST project. The parameter must not be referenced by other parameters or geometry.

cst_parameter_sweep

Set up a parameter sweep in CST Studio. The sweep runs the simulation multiple times, varying the specified parameter across a range of v…

cst_optimizer

Set up an optimization in CST Studio. Define a goal (minimize, maximize, or target a specific value for a result), specify which paramete…

cst_multi_objective_optimizer

Set up a multi-objective optimization with weighted goals and optional constraints. Uses a weighted sum of goals with an evaluation cap; …

cst_sensitivity_analysis

Set up a one-at-a-time sensitivity analysis to rank parameters by their impact on a result. Varies each parameter individually while keep…

cst_yield_analysis

Set up a Monte Carlo yield analysis to estimate manufacturing yield. Randomly varies parameters according to their tolerances and evaluat…

cst_constrained_optimizer

Single-objective optimization with explicit inequality constraints. Example: minimize S11 subject to gain > 8 dBi and bandwidth > 100 MHz.

cst_parameter_interpolation

Interpolate results between parameter sweep data points to estimate performance at a specific parameter value without running a new simul…

Antenna evaluation (3)

Goal-driven evaluation and refinement helpers.

Tool

What it does

cst_evaluate_antenna

Evaluate current antenna simulation results against performance goals. Exports S-parameter data and checks VSWR (or return loss) against …

cst_analyze_impedance

Analyze antenna impedance match quality across frequency bands using S-parameter data. Exports S11 from a completed simulation, computes …

cst_refine_antenna

Run an automated Nelder-Mead optimization loop to tune CST design parameters toward VSWR goals across specified frequency bands. Each ite…

Diagnostics (5)

Logs, delete results, auto-dismiss blocking CST dialogs.

Tool

What it does

cst_delete_results

Delete simulation results from the current CST project. This prevents the 'Results May Get Incompatible With Model' dialog that blocks au…

cst_read_project_log

Read solver log files and project status information from the current CST project. Returns solver running state and the contents of the m…

cst_dismiss_dialogs

Find and dismiss any visible CST dialog windows (error popups, 'Results Incompatible' dialogs, solver warnings). Returns the title and te…

cst_start_dialog_watcher

Start a background thread that automatically detects and dismisses CST dialog windows as they appear. Essential for long-running operatio…

cst_stop_dialog_watcher

Stop the background dialog watcher and return its log of all dialogs that were auto-dismissed. Use after completing an operation that req…

Antenna templates (13)

Parametric antennas: patch, dipole, horn, Yagi, helix…

Tool

What it does

cst_antenna_patch

Create a rectangular microstrip patch antenna with calculated dimensions for a target frequency. Supports inset, microstrip, and probe fe…

cst_antenna_dipole

Create a half-wave dipole antenna at a target frequency. Generates two wire arms with a discrete port at the feed gap.

cst_antenna_monopole

Create a quarter-wave monopole antenna over a ground plane. Generates a vertical wire element, ground plane, and feed port.

cst_antenna_horn

Create a pyramidal horn antenna for a target frequency and gain. Generates the waveguide section, flared horn, and waveguide port.

cst_antenna_yagi

Create a Yagi-Uda antenna with a reflector, driven element, and configurable number of directors. Generates wire elements and a discrete …

cst_antenna_helix

Create an axial-mode helical antenna for circular polarization. Generates helix coil, ground plane, and feed.

cst_antenna_vivaldi

Create a Vivaldi (tapered slot) antenna on a dielectric substrate. Generates substrate, exponential taper metallisation, and feed.

cst_antenna_slot

Create a slot antenna in a ground plane. Generates the ground plane with a resonant slot and microstrip feed.

cst_antenna_ifa

Create an Inverted-F antenna (IFA) suitable for mobile devices. Generates ground plane, radiating arm, shorting pin, and feed.

cst_antenna_pifa

Create a Planar Inverted-F Antenna (PIFA) for compact wireless devices. Generates ground plane, top patch, shorting wall, and feed.

cst_antenna_spiral

Create a wideband Archimedean spiral antenna. Generates two spiral arms with a discrete port feed at the center.

cst_antenna_bowtie

Create a planar bowtie antenna. Generates two triangular arms with a discrete port at the feed gap.

cst_list_antenna_templates

List all available parametric antenna templates with descriptions and typical use cases. No arguments required.

Antenna arrays (8)

Linear/planar/circular arrays, beam steering, taper.

Tool

What it does

cst_array_linear

Create a linear antenna array by replicating an element along a chosen axis. Uses Transform.Translate to produce copies named Element_1 t…

cst_array_planar

Create a 2D planar antenna array with rectangular or triangular lattice. Replicates an element in X and Y using Transform.Translate.

cst_array_circular

Create a circular antenna array by placing elements at equal angular intervals around a circle of given radius.

cst_array_compute_factor

Compute the array factor analytically for a linear or planar array. Returns AF(theta) in dB, half-power beamwidth, first null beamwidth, …

cst_array_beam_steering

Calculate progressive phase weights to steer the main beam to a specified angle. Returns phase weights and VBA to set port phases in CST.

cst_array_taper_design

Design amplitude taper weights for sidelobe control. Supports uniform, cosine, Hamming, Hanning, Blackman, Taylor, and Chebyshev window f…

cst_array_grating_lobe_analysis

Analyse whether grating lobes exist for a given element spacing and maximum scan angle. Returns safe spacing and grating lobe angles.

cst_array_mutual_coupling

Set up a multi-port S-parameter simulation in CST for mutual coupling extraction between array elements.

PCB / SI (12)

Stackups, traces, vias, ground planes, Gerber import.

Tool

What it does

cst_pcb_create_stackup

Create a PCB layer stackup in CST Studio. Generates brick geometry for each layer (signal, ground, power, dielectric) positioned vertical…

cst_pcb_create_trace

Create a PCB trace (microstrip, stripline, coplanar waveguide, or grounded CPW) in CST Studio. Optionally calculates trace width from a t…

cst_pcb_create_via

Create a PCB via (through, blind, or buried) in CST Studio. Generates the cylindrical via barrel with specified drill and pad dimensions.…

cst_pcb_create_ground_plane

Create a ground or power plane with optional cutouts (split planes, isolation slots) in CST Studio. Generates a solid copper brick and su…

cst_pcb_import_gerber

Import a Gerber/ODB++/DXF file for PCB analysis in CST Studio. Generates VBA for the CST Gerber import wizard. In offline mode, explains …

cst_pcb_list_stackup_templates

List predefined PCB stackup templates with complete layer definitions. Includes standard 2/4/6-layer FR-4 and RF-grade Rogers stackups. U…

cst_pcb_differential_pair

Create a differential pair of PCB traces in CST Studio. Generates two parallel bricks separated by a gap and calculates the differential …

cst_pcb_via_model

Create a detailed PCB via model in CST Studio with parasitic inductance and capacitance estimates. Uses the Goldfarb model for via induct…

cst_pcb_via_fence

Create a row (or multiple rows) of vias along a path for isolation or Substrate Integrated Waveguide (SIW) construction. Generates an arr…

cst_pcb_cpw_transition

Create a coplanar waveguide (CPW) to microstrip transition in CST Studio. Generates a tapered geometry that linearly tapers the center co…

cst_pcb_calculate_coupling

Calculate electromagnetic coupling between parallel PCB traces. Computes even/odd mode impedances, coupling coefficient, and near-end/far…

cst_pcb_siw_waveguide

Create a Substrate Integrated Waveguide (SIW) in CST Studio. Generates top and bottom copper planes with two rows of via fences forming t…

Matching networks (8)

L / Pi / T networks, stubs, quarter-wave, Smith transforms.

Tool

What it does

cst_matching_l_network

Design an L-section impedance matching network. Computes inductor and capacitor values for matching a source impedance to a load impedanc…

cst_matching_pi_network

Design a Pi-section impedance matching network (C-L-C or L-C-L). Uses two back-to-back L-sections via a virtual resistance for controllab…

cst_matching_t_network

Design a T-section impedance matching network (L-C-L). Dual of Pi-network, uses two back-to-back L-sections. Pure Python computation.

cst_matching_stub

Design a single-stub impedance matching network. Computes the stub length and distance from the load using Smith chart transmission-line …

cst_matching_quarter_wave

Design a quarter-wave transformer matching network. Supports single and multi-section designs with maximally flat (binomial) or Chebyshev…

cst_matching_create_lumped

Generate CST VBA code to create a lumped-element matching network. Each component (inductor, capacitor, resistor) is placed as a CST Lump…

cst_impedance_smith_transform

Apply a reactive element transformation to an impedance on the Smith chart. Supports series L/C, shunt L/C, and transmission line operati…

cst_matching_microstrip_impedance

Calculate microstrip transmission line characteristic impedance from physical dimensions using the Hammerstad-Jensen model with optional …

VBA escape hatch (3)

Raw VBA execution and built-in VBA object reference.

Tool

What it does

cst_execute_vba

Execute raw VBA code in CST Studio Suite. The code is validated for safety (shell access, file I/O, and external process execution are bl…

cst_vba_help

Get VBA reference documentation for a CST Studio object. Returns the object description and a list of its common methods and properties.

cst_list_vba_objects

List available CST Studio VBA objects, optionally filtered by category. Returns object names with brief descriptions.

Available Tools

184 tools
cst_add_discrete_portA

Add a discrete (lumped) port between two points. Used for circuit-level excitation with a defined impedance.

ParametersJSON Schema
NameRequiredDescriptionDefault
x1YesX coordinate of the start point (mm)
x2YesX coordinate of the end point (mm)
y1YesY coordinate of the start point (mm)
y2YesY coordinate of the end point (mm)
z1YesZ coordinate of the start point (mm)
z2YesZ coordinate of the end point (mm)
impedanceNoPort impedance in ohms (default 50)
port_typeNoExcitation type (default SParameter)SParameter
port_numberYesPort number (1-999)

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 carry the full burden of behavioral transparency. It only states the basic action and purpose, omitting critical traits such as whether it overwrites existing ports, required prerequisites (e.g., open project, geometry existence), side effects, or return values. This is insufficient for safe invocation.

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?

Two sentences, front-loaded with the primary action and followed by usage context. It is concise and to the point, but could benefit from a slight expansion to include behavioral details without significant bloat.

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 9 parameters and no output schema, the description lacks essential context such as prerequisites (e.g., project must be open, points must be on a surface), the effect on the simulation model, error conditions, or that port numbers must be unique. The tool's complexity demands more complete 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 input schema has 100% coverage with descriptions for all 9 parameters. The description does not add any extra meaning beyond the schema, so 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 tool adds a discrete (lumped) port between two points for circuit-level excitation with defined impedance. It effectively distinguishes from waveguide, Floquet, and other port types by specifying 'lumped' and 'circuit-level', providing high clarity.

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 mentions the tool is 'Used for circuit-level excitation with a defined impedance,' giving context for when to use it. However, it does not explicitly state when not to use it or provide alternatives compared to sibling tools like cst_add_waveguide_port, reducing guidance somewhat.

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

cst_add_field_monitorA

Add a field monitor at a specific frequency to the CST project. Field monitors must be defined before running a simulation to capture field distributions, far-field patterns, surface currents, or power flow at the desired frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoCustom name for the monitor. If omitted, a name is auto-generated from the type and frequency, e.g. 'e-field (f=2.45)'.
frequencyYesMonitor frequency in GHz.
monitor_typeYesType of field monitor to add. Options: Efield (electric field), Hfield (magnetic field), Powerflow (Poynting vector), Current (volume current), Powerloss (loss density), Farfield (radiation pattern), Surfacecurrent (surface current density).

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 the burden. It explains what field monitors capture (field distributions, far-field patterns, etc.) but does not disclose side effects like project tree modifications or any requirements like needing an open project.

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 sentences, no unnecessary information. Front-loaded with the core purpose, maximizing information density.

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 no output schema and a simple 3-parameter tool, the description adequately covers purpose and usage context. It could mention what happens after addition (e.g., monitor appears in tree) but is sufficiently complete for agent 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?

The schema covers 100% of parameters with descriptions. The tool description adds minimal extra semantics (e.g., 'at a specific frequency' is already clear from schema). Baseline 3 is appropriate as the description does not significantly enhance parameter understanding.

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' and the resource 'field monitor', specifying it is at a specific frequency. It distinguishes itself from sibling tools which deal with ports, antennas, etc.

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?

It provides explicit context that monitors must be defined before running a simulation, implying when to use this tool. It does not, however, mention when not to use it or suggest alternative tools.

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

cst_add_fixpoint_meshA

Add a fixed mesh point at specific coordinates for precise field sampling. Ensures the mesh contains a node exactly at the specified location for accurate field probing.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYesX coordinate in mm
yYesY coordinate in mm
zYesZ coordinate in mm
nameNoOptional name for the fixed mesh point

TDQS

A3.5/5.0
Behavior2/5

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

No annotations provided; description only mentions adding a fixed point but lacks details on side effects, permissions, what happens if coordinates already exist, 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?

Two succinct sentences with no wasted words; purpose and benefit are 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?

Adequate for a simple creation tool, but lacks details on constraints (e.g., coordinate bounds, mesh requirements) and does not specify return behavior, which might be relevant.

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%; description adds no new meaning beyond 'at specific coordinates' and coordinate units (mm) which are already in schema. The 'name' parameter's description is minimal.

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 states the tool adds a fixed mesh point at coordinates, and distinguishes it from siblings like cst_add_mesh_refinement by specifying it ensures a node exactly at a location for precise field sampling.

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?

Implies usage for precise field sampling and accurate field probing, but does not explicitly state when to use versus alternatives like mesh refinement, nor when not to use.

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

cst_add_floquet_portB

Add a Floquet port for periodic structures such as frequency selective surfaces, metamaterials, and phased arrays.

ParametersJSON Schema
NameRequiredDescriptionDefault
modesNoNumber of Floquet modes to include (default 2)
orientationYesOrientation of the Floquet port (zmin or zmax)
port_numberYesPort number (1-999)

TDQS

B3.3/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. Only states 'Add a Floquet port' without disclosing side effects, prerequisites (e.g., periodic boundary needed), constraints (port number uniqueness), or return values. Minimal 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?

Single sentence, front-loaded with purpose. No wasted words, but could include more useful details without losing 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?

No output schema exists, yet description does not hint at return value or success indicators. Lacks prerequisites, post-conditions, and behavioral traits. Incomplete for a tool with 3 parameters and 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 coverage is 100% and already describes each parameter. Description adds no extra meaning beyond schema (e.g., does not explain the physical significance of 'modes' or 'orientation'). Baseline 3 is appropriate as description does not reduce ambiguity.

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 explicitly states 'Add a Floquet port' and lists example applications (FSS, metamaterials, phased arrays). This clearly distinguishes it from other port types like discrete, waveguide, or multipin ports, and from the advanced Floquet port settings tool (cst_set_floquet_port_advanced).

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?

Implied usage via 'for periodic structures...' but no explicit when-to-use or when-not-to-use. Does not mention alternatives or compare with sibling port tools. Guidance is present but not comprehensive.

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

cst_add_lumped_elementC

Add a lumped R, L, C, or RLC element between two points. Value is in ohms for R, henries for L, farads for C.

ParametersJSON Schema
NameRequiredDescriptionDefault
x1YesX coordinate of the first terminal (mm)
x2YesX coordinate of the second terminal (mm)
y1YesY coordinate of the first terminal (mm)
y2YesY coordinate of the second terminal (mm)
z1YesZ coordinate of the first terminal (mm)
z2YesZ coordinate of the second terminal (mm)
nameYesUnique name for the lumped element
valueYesElement value (ohms for R, henries for L, farads for C)
element_typeYesType of lumped element

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 bears the full burden of disclosing behavioral traits. It does not mention any side effects (e.g., modifying the project, creating an object in the 3D model), requirements (e.g., an open project), or limitations. The description is minimal and lacks 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 two sentences, succinct and to the point, with no redundant information. Every word serves a 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 absence of an output schema, the description does not explain what the tool returns (e.g., an object reference, success message). The behavioral context is lacking, especially for a creation tool that modifies the project state.

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, so the description adds limited value beyond schema descriptions. It clarifies the units for value (ohms, henries, farads), which is already present in the schema, but does not add new semantic meaning for other 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 ('Add') and the resource ('lumped R, L, C, or RLC element'), and specifies the connection between two points. However, it does not differentiate from the similar sibling tool 'cst_schematic_create_rlc', which may cause confusion about which tool to use.

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 'cst_schematic_create_rlc' or other creation tools. There are no prerequisites, context, or exclusions mentioned.

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

cst_add_mesh_refinementA

Add local mesh refinement to a specific solid. This creates finer mesh around critical geometry features like feed points, gaps, or thin layers.

ParametersJSON Schema
NameRequiredDescriptionDefault
solidYesSolid name to refine mesh around
componentYesComponent name containing the solid
refinement_factorNoRefinement factor — mesh cells are divided by this value (default 2.0)

TDQS

A3.7/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. It mentions creating finer mesh but lacks details on prerequisites, destructive behavior, or interaction with other mesh settings.

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 concise sentences with front-loaded action and no fluff. 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?

Moderate complexity with sibling mesh tools, but description does not explain interaction with other mesh settings or output. No output schema, but description suffices for basic 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 coverage is 100% with descriptions for all parameters. The description adds context ('around critical geometry features') but does not significantly enhance understanding 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?

Description clearly states the tool adds local mesh refinement to a specific solid, with examples of when it's used (feed points, gaps, thin layers). This distinguishes it from sibling tools like global mesh settings.

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?

Provides context for when to use (around critical geometry features) but does not explicitly state when not to use or mention alternatives among sibling mesh tools.

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

cst_add_multipin_portA

Add a waveguide port with multiple mode monitoring for higher-order mode analysis. Used for multimode waveguides, mode converters, and structures where higher-order propagating modes need to be captured.

ParametersJSON Schema
NameRequiredDescriptionDefault
x_maxYesX-axis maximum coordinate of the port aperture (mm)
x_minYesX-axis minimum coordinate of the port aperture (mm)
y_maxYesY-axis maximum coordinate of the port aperture (mm)
y_minYesY-axis minimum coordinate of the port aperture (mm)
z_maxYesZ-axis maximum coordinate of the port aperture (mm)
z_minYesZ-axis minimum coordinate of the port aperture (mm)
num_modesNoNumber of modes to monitor (1-10, default 1)
orientationYesFace of the bounding box where the port is placed
port_numberYesPort number (1-999)

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 carries full burden. It mentions the multimode monitoring feature but does not disclose side effects (e.g., modifies project tree), prerequisites (e.g., an open project), or any behavioral traits beyond the action 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 two sentences, directly to the point, with no extraneous information. Key purpose and usage are 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?

With 9 parameters, no output schema, and no annotations, the description explains purpose and use case but omits details about what happens after creation (e.g., port added to simulation), return value, or integration with solver. Adequate but not comprehensive.

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 baseline is 3. The description does not add parameter-level detail beyond the schema; it only provides high-level context about multimodal monitoring.

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 ('Add') and resource ('waveguide port with multiple mode monitoring'), and distinguishes from the sibling 'cst_add_waveguide_port' by explicitly mentioning multimode capability.

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 specifies typical use cases ('multimode waveguides, mode converters, and structures where higher-order propagating modes need to be captured'), providing clear context but lacking explicit when-not-to-use 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.

cst_add_plane_waveB

Add a plane wave excitation source. Defines an incident plane wave with given direction and polarization for scattering / RCS analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault
phiYesAzimuth angle of incidence in degrees (0-360)
e_phiNoPhi component of the polarization vector (default 0)
thetaYesElevation angle of incidence in degrees (0-180)
e_thetaNoTheta component of the polarization vector (default 1)
polarizationYesPolarization type

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 only states the basic action without detailing side effects, prerequisites (e.g., a project must exist), or whether it modifies existing sources. The description lacks behavioral depth.

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 two sentences covering purpose and context. It is front-loaded and efficient, though some additional structural details (e.g., parameter grouping) could be added without bloat.

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 no output schema and is a setup action. The description covers the basic purpose but lacks workflow context (e.g., how it interacts with other sources, solver requirements). 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% with all parameters having descriptions. The overall description adds little beyond summarizing the schema, but it does not introduce new meaning. Baseline 3 is appropriate for high coverage.

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 adds a plane wave excitation source for scattering/RCS analysis, which distinguishes it from other port/ excitation tools among siblings. The verb 'add' and resource 'plane wave' are specific. However, it could be slightly more explicit about distinguishing from other plane wave setups.

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 scattering/RCS analysis but does not provide explicit guidance on when to use this tool versus alternatives (e.g., discrete ports, waveguide ports). No when-not or alternative mentions.

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

cst_add_waveguide_portA

Add a waveguide port for S-parameter excitation. Defines a port face on the boundary of the simulation domain for guided-wave excitation. IMPORTANT: The port plane should be at or near the edge of the model geometry. Ground planes and substrates must NOT extend past the port plane in the port's orientation direction, or VBA execution may hang. For microstrip feeds: place the port at the end of the feed line where the ground/substrate terminates. Use Coordinates='Free' for ports not aligned to the bounding box. Valid orientations: xmin/xmax/ymin/ymax/zmin/zmax.

ParametersJSON Schema
NameRequiredDescriptionDefault
x_maxYesX-axis maximum coordinate of the port aperture (mm)
x_minYesX-axis minimum coordinate of the port aperture (mm)
y_maxYesY-axis maximum coordinate of the port aperture (mm)
y_minYesY-axis minimum coordinate of the port aperture (mm)
z_maxYesZ-axis maximum coordinate of the port aperture (mm)
z_minYesZ-axis minimum coordinate of the port aperture (mm)
coordinatesNoCoordinate mode. 'Free' allows arbitrary placement using the specified ranges (required for microstrip/coplanar ports). 'Full' maps the port to the full bounding-box face. 'Picks' uses previously picked geometry faces. Default: 'Free'.Free
mode_numberNoNumber of modes to consider (default 1)
orientationYesFace of the bounding box where the port is placed
port_numberYesPort number (1-999)

TDQS

A4.3/5.0
Behavior4/5

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

With no annotations, the description carries full burden. It discloses a critical behavioral trait: VBA execution may hang if geometry rules (ground/substrate extension) are violated. It also specifies valid orientations and coordinate modes. However, it does not mention side effects like port overwriting or limits.

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 well-structured with a clear purpose sentence, followed by important usage notes (IMPORTANT), specific feed advice, and parameter details. While concise, each sentence adds value. Slightly longer but justified by complexity.

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 10 parameters (8 required) and no output schema, the description covers the tool's purpose, key geometry constraints, coordinate modes, and orientation meanings. It does not specify return values (e.g., success confirmation), but this is acceptable without output schema. It adequately differentiates from sibling port tools.

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%, baseline 3. The description adds meaning beyond schema by explaining why 'Coordinates=Free' is essential for microstrip/coplanar ports and that orientation maps to bounding-box faces. It also relates parameters to geometry constraints, providing context not in 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 adds a waveguide port for S-parameter excitation, defining a port face. It distinguishes from sibling tools like discrete, lumped, and Floquet ports by specifying 'waveguide port' and detailing geometry considerations. The verb 'Add' and resource 'waveguide port' are specific 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 Guidelines4/5

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

The description provides explicit usage guidance: port plane at/near model edge, ground/substrate termination constraints, microstrip feed placement, and use of 'Coordinates=F ree' for non-aligned ports. It does not explicitly compare to alternative port types (e.g., discrete ports), but the context from sibling tools and the specific name imply when to use this tool.

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

cst_analyze_impedanceA

Analyze antenna impedance match quality across frequency bands using S-parameter data. Exports S11 from a completed simulation, computes VSWR and return loss per frequency point, detects resonances, and provides resonance-based design recommendations (e.g. shift resonance up/down, widen bandwidth). Returns per-band worst/best VSWR, match quality classification, nearest resonance info, and actionable design guidance. Read-only — does not modify the model.

ParametersJSON Schema
NameRequiredDescriptionDefault
z0NoReference impedance in ohms (default: 50).
portNoPort number (default: 1).
bandsYesFrequency bands to analyze impedance for.
sample_frequencies_ghzNoSpecific frequencies (GHz) to report detailed impedance. If omitted, band edges and center are used.

TDQS

A4/5.0
Behavior4/5

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

With no annotations provided, the description carries full responsibility for behavioral disclosure. It explicitly states the tool is read-only and does not modify the model. It details the analysis steps (export S11, compute VSWR, detect resonances) and lists return values. Minor omission: does not clarify what happens if no simulation data exists or if S-parameters are unavailable.

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 concise with four sentences that efficiently convey the tool's purpose, actions, and outputs. It front-loads the main purpose and follows with specific computations and return values. No redundant or irrelevant 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?

The tool has no output schema, so the description compensates by listing key return items (worst/best VSWR, match quality, resonance info, design guidance). It mentions the prerequisite of a completed simulation. However, it does not describe the exact output structure, error conditions, or behavior with missing data. Minor gaps but sufficient for typical 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 schema already documents all four parameters. The description does not add new semantic information beyond the schema; it only provides overall context. For example, sample_frequencies_ghz is described in the schema as 'Specific frequencies to report detailed impedance' and the description does not elaborate further.

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 analyzes antenna impedance match quality across frequency bands using S-parameter data. It lists specific computations (S11, VSWR, return loss, resonances) and outputs (per-band VSWR, match quality, resonance info, design recommendations). This distinguishes it from related sibling tools like cst_get_impedance or cst_get_vswr which only return raw values.

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 a completed simulation and states it is read-only. However, it does not explicitly differentiate this tool from alternatives like cst_get_impedance or cst_matching_* tools. There is no guidance on when not to use it or prerequisites beyond 'from a completed simulation'.

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

cst_antenna_bowtieB

Create a planar bowtie antenna. Generates two triangular arms with a discrete port at the feed gap.

ParametersJSON Schema
NameRequiredDescriptionDefault
flare_angleNoFlare half-angle of each arm in degrees (default 60)
arm_length_mmNoArm length in mm (auto-calculated from frequency if omitted)
frequency_ghzYesDesign center frequency in GHz

TDQS

B3.3/5.0
Behavior2/5

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

No annotations exist. The description discloses the creation action but omits side effects (e.g., whether it modifies existing geometry or requires subsequent simulation setup). It does not contradict any annotations since none are provided.

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 sentences, front-loaded with the core action. Every word is necessary and contributes to understanding. No superfluous 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 geometry-creation tool with three parameters and no output schema, the description covers the basic purpose but lacks information about what happens to the model state or return values. It is minimally complete but could mention that the discrete port is automatically created.

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 tool description adds context about the port and arms, but the parameter descriptions in the schema already explain flare angle, arm length, and frequency adequately. The description does not introduce new semantic 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 creates a planar bowtie antenna with two triangular arms and a discrete port. Among sibling antenna creation tools, it is distinguished by specifying 'planar bowtie' and the geometry details.

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 like dipole, patch, or horn antennas. No prerequisites or contextual hints provided.

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

cst_antenna_dipoleA

Create a half-wave dipole antenna at a target frequency. Generates two wire arms with a discrete port at the feed gap.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequency_ghzYesDesign center frequency in GHz
wire_radius_mmNoWire radius in mm (default 0.5)

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 full burden. It explains the basic creation but omits any side effects, prerequisites, or impact on existing geometry. It is minimally transparent.

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 concise sentences, no redundancy. Essential information is front-loaded. Every word serves a purpose.

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 creation tool with no output schema, the description is adequate. It could briefly mention the outcome (e.g., antenna object added to project), but the current content is sufficient given the sibling 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 coverage is 100%, so the description adds no extra meaning beyond what the schema already provides. 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 (Create), the specific resource (half-wave dipole antenna), and key details (two wire arms, discrete port). It distinguishes among sibling antenna types.

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 a dipole antenna is needed but provides no guidance on when to avoid this tool or which alternative to use in different scenarios.

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

cst_antenna_helixB

Create an axial-mode helical antenna for circular polarization. Generates helix coil, ground plane, and feed.

ParametersJSON Schema
NameRequiredDescriptionDefault
num_turnsNoNumber of helix turns (default 10)
ground_typeNoGround plane shape (default circular)circular
frequency_ghzYesDesign center frequency in GHz

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 full burden for behavioral disclosure. It mentions creating components but does not indicate whether it modifies existing geometry, requires an open project, automatically adds ports, or has any destructive side effects. Key behavioral context is missing.

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 concise sentences that are front-loaded with the purpose. No unnecessary words or repetition.

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 creation tool without an output schema, the description lacks important context: coordinate system, units, effect on existing geometry, port creation, or return value. Given the tool's complexity, more detail is needed for a complete 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?

All three parameters (num_turns, ground_type, frequency_ghz) are described in the schema (100% coverage). The description adds overall context but does not enhance understanding beyond the schema's own descriptions, 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?

The description clearly states it creates an axial-mode helical antenna for circular polarization and lists the generated components (helix coil, ground plane, feed). This distinguishes it from other antenna types like cst_antenna_dipole or cst_antenna_spiral.

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 circular polarization but does not explicitly state when to use a helix over alternatives like spiral antennas. No guidance on when not to use or which tool to choose instead is provided.

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

cst_antenna_hornA

Create a pyramidal horn antenna for a target frequency and gain. Generates the waveguide section, flared horn, and waveguide port.

ParametersJSON Schema
NameRequiredDescriptionDefault
aNoWaveguide broad-wall dimension in mm (auto-calculated if omitted)
bNoWaveguide narrow-wall dimension in mm (auto-calculated if omitted)
gain_dbiNoTarget gain in dBi (default 15)
frequency_ghzYesDesign center frequency in GHz

TDQS

A3.6/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 states what is created but does not disclose side effects, prerequisites (e.g., open project), or whether it overwrites existing objects. Some behavioral context is missing.

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 covers key aspects. It could be better structured with front-loaded information, but it is not 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 complexity of antenna creation, the description is brief. It lacks information on return values, prerequisites, and error conditions. For a tool with many siblings, more context 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 coverage is 100% with each parameter described. The description adds 'target frequency and gain' which maps to frequency_ghz and gain_dbi, but does not elaborate on a and b beyond what the schema already states. 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 identifies the tool as creating a pyramidal horn antenna for a target frequency and gain, listing the generated components (waveguide section, flared horn, waveguide port). This distinguishes it from other antenna types in the sibling list.

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 use when a pyramidal horn antenna is needed, but it does not provide explicit when-to-use or when-not-to-use guidance, nor does it mention alternatives among sibling antenna tools.

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

cst_antenna_ifaA

Create an Inverted-F antenna (IFA) suitable for mobile devices. Generates ground plane, radiating arm, shorting pin, and feed.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequency_ghzYesDesign center frequency in GHz
ground_width_mmNoGround plane width in mm (default 40)
ground_length_mmNoGround plane length in mm (default 100)

TDQS

A3.6/5.0
Behavior3/5

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

The description lists generated geometry components, but lacks details about port creation, excitation, material assignments, or side effects. Without annotations, the burden is higher; the description is adequate but not exhaustive.

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 sentences with no fluff: first states purpose and context, second clarifies generated components. Efficient 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?

For a creation tool with three parameters and no output schema or annotations, the description covers the essential behavior. It names generated components, which is sufficient for basic usage. Could mention relationship to simulation setup, but not critical.

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 description adds limited value. It mentions generated components but does not elaborate on parameter usage beyond schema defaults. Baseline of 3 is appropriate as description is not essential for parameter understanding.

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 creates an Inverted-F antenna (IFA) for mobile devices, listing generated components. It uses a specific verb and resource, distinguishing it from many sibling antenna tools like dipole, patch, etc.

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 IFA vs other antenna types. No prerequisites, context, or exclusions provided. Among many sibling tools, an agent would lack decision criteria.

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

cst_antenna_monopoleA

Create a quarter-wave monopole antenna over a ground plane. Generates a vertical wire element, ground plane, and feed port.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequency_ghzYesDesign center frequency in GHz
wire_radius_mmNoWire radius in mm (default 0.5)
ground_radius_mmNoGround plane radius in mm (auto-calculated if omitted)

TDQS

A3.6/5.0
Behavior3/5

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

The description explains what is generated (wire, ground plane, feed port) but does not disclose side effects, such as whether it modifies an existing project or requires a project to be open. With no annotations, more detail on behavior would be helpful.

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 concise sentences that convey the essential purpose and components. No filler words or 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 creation tool with no output schema, the description adequately covers what the tool does. However, it could mention that it adds objects to the current project or specify return values, but overall it's sufficient.

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 has 100% coverage, so parameters are already documented. The description mentions frequency, wire radius, and ground radius but adds no new information beyond the schema. It does not explain the auto-calculation for ground radius, which is implied.

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 states it creates a quarter-wave monopole antenna over a ground plane, specifying the vertical wire element, ground plane, and feed port. This differentiates it from other antenna tools like cst_antenna_dipole or cst_antenna_patch.

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 like other antenna templates. No prerequisites or context provided.

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

cst_antenna_patchA

Create a rectangular microstrip patch antenna with calculated dimensions for a target frequency. Supports inset, microstrip, and probe feed types. Generates substrate, ground plane, patch, feed structure, waveguide port, boundaries, and field monitors.

ParametersJSON Schema
NameRequiredDescriptionDefault
tan_dNoSubstrate loss tangent (default 0.02)
epsilon_rNoSubstrate relative permittivity (default 4.4 — FR-4)
feed_typeNoFeed method (default inset)inset
frequency_ghzYesDesign center frequency in GHz
ground_size_factorNoGround plane size = factor * patch size (default 2.0)
substrate_height_mmNoSubstrate thickness in mm (default 1.6)

TDQS

A4/5.0
Behavior4/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 lists generated components (substrate, ground plane, patch, feed structure, waveguide port, boundaries, field monitors), providing good context about what the tool creates. However, it does not mention potential destructive actions or permissions needed.

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 consists of two concise sentences, front-loading the main purpose and including a clear list of generated elements. No superfluous information is present.

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 absence of an output schema and annotations, the description adequately covers what the tool does and generates. It mentions all key aspects: frequency-based dimension calculation, feed types, and generated components. However, it could detail how the tool interacts with the CST environment (e.g., creating a new model or modifying an existing one).

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 parameter descriptions are already complete. The tool description adds minimal additional meaning beyond noting that patch dimensions are calculated and listing feed types. It does not enhance understanding beyond what the schema provides, resulting in a 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 clearly states it creates a rectangular microstrip patch antenna with calculated dimensions for a target frequency. It specifies supported feed types and lists what components are generated, distinguishing it from other antenna tools like cst_antenna_dipole or cst_antenna_horn.

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 mentions supported feed types but does not provide explicit guidance on when to use this tool versus alternatives or when not to use it. Sibling tools indicate many antenna types, but the description implies usage for rectangular patch antennas without detailing selection criteria.

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

cst_antenna_pifaB

Create a Planar Inverted-F Antenna (PIFA) for compact wireless devices. Generates ground plane, top patch, shorting wall, and feed.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequency_ghzYesDesign center frequency in GHz
patch_width_mmNoPatch width in mm (auto-calculated if omitted)
ground_width_mmNoGround plane width in mm (default 40)
ground_length_mmNoGround plane length in mm (default 100)

TDQS

B3.4/5.0
Behavior2/5

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

No annotations provided, so description must disclose behavior. It states it creates and generates components, but lacks details on side effects, permissions required, or whether it modifies existing geometry. For a creation tool, 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.

Conciseness5/5

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

Two efficient sentences, front-loaded with purpose and a clear list of generated components. No wasted words.

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?

No output schema, but description does not mention return value or post-creation state. Also no mention of prerequisites like open project. Incomplete for a tool with 4 parameters.

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 baseline is 3. Description does not add extra context about parameters beyond the schema's 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?

Clearly states it creates a PIFA antenna, specifying the type and its components (ground plane, patch, shorting wall, feed). Distinguishes from sibling antenna tools like dipole or patch.

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?

Implied use for compact wireless devices, but no explicit when to use vs alternatives. With many sibling antenna templates, more guidance would help.

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

cst_antenna_slotA

Create a slot antenna in a ground plane. Generates the ground plane with a resonant slot and microstrip feed.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequency_ghzYesDesign center frequency in GHz
slot_width_mmNoSlot width in mm (auto-calculated if omitted)

TDQS

A3.7/5.0
Behavior3/5

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

Describes the creation action but does not disclose potential side effects (e.g., if it modifies existing geometry, requires certain coordinate systems, or whether it can be called multiple times). No annotations provided, so the description carries full burden.

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 sentences, efficient and free of extraneous information. Front-loaded with purpose.

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?

Lacks mention of return value or success indication. For a creation tool with no output schema, description should briefly state what the tool returns (e.g., object handle). Otherwise adequate.

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 description coverage is 100%, so description adds limited value. However, it mentions 'auto-calculated if omitted' for slot_width_mm, which supplements the schema definition.

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 creating a slot antenna in a ground plane, with generation of ground plane, slot, and microstrip feed. It uses specific verbs and resource names, distinguishing it from other antenna types like bowtie or dipole.

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 vs. alternatives (e.g., when a slot antenna is preferred over a patch antenna). No prerequisites or context provided.

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

cst_antenna_spiralA

Create a wideband Archimedean spiral antenna. Generates two spiral arms with a discrete port feed at the center.

ParametersJSON Schema
NameRequiredDescriptionDefault
num_turnsNoNumber of spiral turns (default 5)
freq_low_ghzYesLow end of operating band in GHz
freq_high_ghzYesHigh end of operating band in GHz

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 full burden. It only states creation without disclosing side effects (e.g., whether it modifies existing geometry, requires a project, or what happens to unsaved changes). This lacks important 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?

Two concise sentences with no unnecessary words. The information is front-loaded and every part is relevant.

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?

Output schema is missing, so expected return is unclear. The description does not mention project context or post-creation state. However, for a simple antenna creation tool, it covers the essential purpose. Could benefit from noting the dependence on an existing project.

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 three parameters have descriptions in the schema (100% coverage). The tool description adds no extra detail beyond the schema; 'wideband' and 'discrete port feed' are general but not parameter-specific. 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 action ('Create a wideband Archimedean spiral antenna') and specifies key characteristics (two arms, discrete port feed at center). It distinguishes from other antenna templates in the sibling list.

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 guidance on when to choose this tool over others (e.g., dipole, patch). The description implies usage for wideband spiral antennas, but does not compare with alternatives or mention prerequisites like an active CST project.

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

cst_antenna_vivaldiA

Create a Vivaldi (tapered slot) antenna on a dielectric substrate. Generates substrate, exponential taper metallisation, and feed.

ParametersJSON Schema
NameRequiredDescriptionDefault
epsilon_rNoSubstrate relative permittivity (default 2.2 — Rogers)
frequency_ghzYesDesign center frequency in GHz
substrate_height_mmNoSubstrate thickness in mm (default 1.6)
taper_length_factorNoTaper length in wavelengths (default 3)

TDQS

A3.5/5.0
Behavior3/5

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

The description discloses that the tool generates substrate, taper, and feed, but does not specify side effects, required project state, or whether existing objects are overwritten. 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 consists of two concise sentences with no redundant information. It efficiently communicates the tool's purpose and key outputs.

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 creates a complex antenna structure with four parameters and no output schema, the description lacks details such as whether a port is automatically added, default material units, or return value behavior. It covers the basics but is 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 coverage is 100%, so the schema already documents each parameter's meaning. The description adds context about exponential taper and feed but does not enhance parameter understanding beyond the schema, justifying 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 clearly states it creates a Vivaldi antenna, specifying the key components (substrate, taper, feed). Among many sibling antenna tools, it uniquely identifies the antenna type, so the agent can distinguish it.

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 antenna tools (e.g., when to choose Vivaldi over patch or dipole). No prerequisites or context for selection are mentioned.

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

cst_antenna_yagiB

Create a Yagi-Uda antenna with a reflector, driven element, and configurable number of directors. Generates wire elements and a discrete port feed.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequency_ghzYesDesign center frequency in GHz
num_directorsNoNumber of director elements (default 3)

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 for behavioral disclosure. It notes that the tool 'generates wire elements and a discrete port feed,' but fails to mention prerequisites (e.g., an open project), side effects, or any constraints. The behavioral information is 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 extremely concise—only two sentences. The first sentence front-loads the main purpose, and the second adds essential detail. 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 creation tool with two parameters and no output schema, the description is nearly complete. It explains what the tool creates and its key elements. However, it omits any mention of return value or effect on the CST project (e.g., 'creates the antenna in the active project'), which would be helpful but is not critical.

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 the phrase 'configurable number of directors' which mirrors the num_directors parameter, but does not provide additional meaning beyond what the schema already states (e.g., frequency_ghz is described as 'Design center frequency in GHz'). No deeper semantics are 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 tool's function: 'Create a Yagi-Uda antenna with a reflector, driven element, and configurable number of directors.' It uses a specific verb and resource, and the detail about wire elements and discrete port feed distinguishes it from sibling antenna creation tools like dipole or patch.

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 other antenna types. The description does not include any 'when-to-use' or 'when-not-to-use' context, leaving the agent to rely solely on the tool name.

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

cst_array_beam_steeringA

Calculate progressive phase weights to steer the main beam to a specified angle. Returns phase weights and VBA to set port phases in CST.

ParametersJSON Schema
NameRequiredDescriptionDefault
spacing_mmYesInter-element spacing in mm
num_elementsYesNumber of elements
scan_phi_degNoDesired scan angle phi in degrees (default 0)
frequency_ghzYesOperating frequency in GHz
scan_theta_degYesDesired scan angle theta in degrees from broadside

TDQS

A3.6/5.0
Behavior3/5

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

The description indicates the tool returns phase weights and VBA, suggesting no destructive side effects, but does not explicitly state if it modifies the CST project. Without annotations, this is adequate but not fully transparent.

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 sentence with two clear clauses, front-loading the main action and output. No 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?

For a calculation tool, the description explains the purpose and output sufficiently. However, it lacks details like whether the VBA is returned as a string or applied directly, and no output schema is provided.

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 clear parameter descriptions. The description adds minimal value by mentioning output, but no additional parameter context 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 calculates progressive phase weights for beam steering to a specified angle, with explicit output of phase weights and VBA. This distinguishes it from sibling tools like array creation or analysis.

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 (e.g., other array tools). The description implies it is for setting phase weights after array creation but does not state prerequisites or exclusions.

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

cst_array_circularA

Create a circular antenna array by placing elements at equal angular intervals around a circle of given radius.

ParametersJSON Schema
NameRequiredDescriptionDefault
radius_mmYesArray circle radius in mm
num_elementsYesNumber of elements (2-64)
frequency_ghzYesDesign frequency in GHz (for wavelength reference)
element_componentNoComponent name of the element to replicate (default Antenna)Antenna

TDQS

A3.5/5.0
Behavior2/5

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

No annotations are provided. The description is minimal and does not disclose behavioral traits such as whether the tool modifies existing geometry, requires an open project, or has any side effects. It only states what it does, not how it behaves beyond the basic 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?

The description is a single, clear, front-loaded sentence. It contains no filler words and directly conveys the essential action. 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?

The tool is simple with 4 parameters and no output schema. The description adequately explains the array creation, but it could specify that the operation takes place in the current CST project and that the result is a new array object. It is minimally sufficient 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 coverage is 100%, with each parameter having a description. The tool description adds some context (e.g., 'replicate' for element_component, 'wavelength reference' for frequency_ghz), but it does not significantly enhance understanding 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 creates a circular antenna array, specifying the method 'by placing elements at equal angular intervals around a circle of given radius'. This uniquely identifies its purpose and distinguishes it from sibling tools like cst_array_linear and cst_array_planar.

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 provide explicit guidance on when to use this tool versus alternatives. It lacks prerequisites, constraints, or notes on when it's appropriate. Usage is implied by the tool name and description, but no comparative or contextual advice is given.

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

cst_array_compute_factorA

Compute the array factor analytically for a linear or planar array. Returns AF(theta) in dB, half-power beamwidth, first null beamwidth, peak sidelobe level, and directivity.

ParametersJSON Schema
NameRequiredDescriptionDefault
array_typeNoArray type (default linear)linear
num_elementsYesNumber of elements
scan_angle_degNoScan angle in degrees from broadside (default 0)
amplitude_weightsNoAmplitude weights per element (default uniform)
spacing_wavelengthsYesInter-element spacing in wavelengths (d/lambda)

TDQS

A3.8/5.0
Behavior3/5

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

No annotations provided, so description bears full burden. It transparently states returns (AF, beamwidths, SLL, directivity) but omits behavioral details like assumptions (isotropic elements, no coupling) and computational limits. Adequate but lacking full 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?

Two sentences: first states purpose, second lists outputs. Extremely concise with no filler. Information is front-loaded and each sentence is purposeful. Exceptional structure.

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 no output schema, description compensates by listing all return values. However, it lacks detail on output format (e.g., how AF(theta) is returned, units of beamwidths) and does not address edge cases. Still fairly complete for a simple analytic 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 coverage is 100%, so baseline is 3. Description adds context by mentioning linear/planar arrays (mapping to array_type) and returns, but does not deepen understanding of parameters beyond schema. No contradiction.

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 specific verb 'Compute' and resource 'array factor' for linear or planar arrays. It lists returns (AF in dB, beamwidths, SLL, directivity), clearly distinguishing from siblings like cst_array_linear (creates array) and cst_array_beam_steering (steers beam).

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?

Implies use for analytic computation ('analytically') but does not explicitly state when to prefer this over alternatives like full-wave simulation or other array analysis tools (e.g., cst_array_mutual_coupling). Missing guidance on limitations (e.g., assumes isotropic elements).

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

cst_array_grating_lobe_analysisB

Analyse whether grating lobes exist for a given element spacing and maximum scan angle. Returns safe spacing and grating lobe angles.

ParametersJSON Schema
NameRequiredDescriptionDefault
max_scan_angle_degNoMaximum scan angle from broadside in degrees (default 60)
spacing_wavelengthsYesInter-element spacing in wavelengths (d/lambda)

TDQS

B3.3/5.0
Behavior3/5

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

No annotations provided. Description states it 'analyzes' and 'returns' results, implying a read-only operation without side effects. However, it does not explicitly confirm non-destructive behavior or disclose any computational 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?

Two sentences, efficiently communicating the tool's function, inputs, and outputs without any extraneous information. Front-loaded with the core purpose.

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 two parameters and no output schema, the description provides sufficient context to understand the basic operation. However, it lacks details on the return format or assumptions, and could be more 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 covers both parameters with descriptions (100% coverage). The tool description adds no extra 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.

Purpose4/5

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

Description clearly identifies the tool's purpose: analyzing grating lobes given element spacing and scan angle. It distinguishes from sibling tools by specifying a unique function not covered by other array tools like beam steering or array factor calculation.

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. The description implies use for grating lobe analysis but lacks prerequisites, alternatives, or context where it should not be used.

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

cst_array_linearB

Create a linear antenna array by replicating an element along a chosen axis. Uses Transform.Translate to produce copies named Element_1 through Element_N.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisNoArray axis (default x)x
spacing_mmYesInter-element spacing in mm
num_elementsYesNumber of elements (2-64)
frequency_ghzYesDesign frequency in GHz (for wavelength reference)
element_componentNoComponent name of the element to replicate (default Antenna)Antenna

TDQS

B3.3/5.0
Behavior3/5

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

The description discloses the method (Transform.Translate) and naming convention, but does not reveal important behaviors: whether it modifies the original element, creates a new assembly, or requires pre-existing elements. Without annotations, more detail is needed for full 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?

Two sentences, front-loaded with purpose. No wasted words. Efficiently conveys the core action and a key implementation 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?

Covers the creation action but lacks context about prerequisites (e.g., element component must exist), output, and side effects. No output schema, but given complexity, more behavioral context is expected 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%, so the baseline is 3. The description adds minimal extra meaning beyond the schema; it mentions 'along a chosen axis' and naming convention, but does not elaborate on parameter formats or dependencies.

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 creates a linear antenna array by replicating an element along an axis, which distinguishes it from circular or planar array tools. However, it does not explicitly contrast with sibling tools like cst_array_circular or cst_array_planar.

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 vs alternatives like cst_array_circular or cst_array_planar. No prerequisites are mentioned (e.g., existence of an element component). The description only states what it does, not when to use it.

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

cst_array_mutual_couplingA

Set up a multi-port S-parameter simulation in CST for mutual coupling extraction between array elements.

ParametersJSON Schema
NameRequiredDescriptionDefault
num_portsYesTotal number of ports in the array
port_numbersNoExplicit port numbers to include (default 1..num_ports)

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 must disclose behavioral traits. It indicates a setup action, which is non-destructive, but does not mention side effects (e.g., whether it modifies existing ports or runs simulation). This is adequate but not fully transparent.

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 sentence that is front-loaded with the core action and purpose. No wasted words; efficient and clear.

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 simple two-parameter schema with good descriptions and no output schema, the description covers the tool's setup purpose well. However, it could mention that it does not run the simulation itself, but this is a minor 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 coverage is 100% with both parameters described. The description adds minimal extra meaning beyond the schema (e.g., 'multi-port' aligns with num_ports). Baseline 3 applies; no significant enrichment.

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 up a multi-port S-parameter simulation'), the object ('in CST'), and the specific purpose ('for mutual coupling extraction between array elements'). It distinguishes itself from sibling tools like cst_array_beam_steering or cst_array_compute_factor.

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. There are many array-related siblings (e.g., cst_array_beam_steering, cst_array_compute_factor), but the description does not provide any context for choosing this tool over them.

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

cst_array_planarB

Create a 2D planar antenna array with rectangular or triangular lattice. Replicates an element in X and Y using Transform.Translate.

ParametersJSON Schema
NameRequiredDescriptionDefault
num_xYesNumber of elements along X
num_yYesNumber of elements along Y
latticeNoLattice type (default rectangular)rectangular
spacing_x_mmYesInter-element spacing along X in mm
spacing_y_mmYesInter-element spacing along Y in mm
frequency_ghzYesDesign frequency in GHz (for wavelength reference)
element_componentNoComponent name of the element to replicate (default Antenna)Antenna

TDQS

B3.4/5.0
Behavior3/5

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

The description discloses that the tool replicates elements using Transform.Translate, which is a key behavioral trait. However, it does not elaborate on side effects (e.g., whether existing components are modified) or required permissions. Since no annotations are provided, the description partially fulfills the transparency burden.

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 very concise with two sentences, front-loading the key purpose and method. No unnecessary words or 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 tool with 7 parameters and no output schema, the description explains the core concept (2D planar array, lattice types, replication via transform). It could be more explicit about the resulting model structure (e.g., a component group), but it is mostly complete given the 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 schema already documents all parameters. The description adds no extra meaning beyond implying that num_x/num_y control replication and lattice selects type. This meets the baseline but does not enhance understanding.

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 creates a 2D planar antenna array with rectangular or triangular lattice and mentions using Transform.Translate. It distinguishes itself from linear or circular array siblings, but does not explicitly contrast with those 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 array creation tools like cst_array_linear or cst_array_circular. It does not mention prerequisites such as the existence of an element component or how to prepare the model.

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

cst_array_taper_designB

Design amplitude taper weights for sidelobe control. Supports uniform, cosine, Hamming, Hanning, Blackman, Taylor, and Chebyshev window functions.

ParametersJSON Schema
NameRequiredDescriptionDefault
taper_typeYesWindow/taper type
num_elementsYesNumber of elements
sidelobe_level_dbNoDesired peak sidelobe level in dB (negative, default -25). Used for Taylor and Chebyshev only.

TDQS

B3.4/5.0
Behavior2/5

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

No annotations provided; description only states purpose. Does not disclose behavioral traits such as side effects (e.g., modifying project state), return values, permissions, or integration steps. Significant gap for a design 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?

Two sentences, no fluff, efficiently communicates purpose and supported options. Front-loaded with verb and resource.

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 clear purpose, the description lacks details on output (no output schema), how the tool integrates into a workflow (e.g., does it modify the project or return weights?), and dependencies. Incomplete for practical agent 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 coverage is 100% with clear parameter descriptions. Description reiterates supported taper types, which are already in the enum, and notes that sidelobe_level_db is for Taylor/Chebyshev (also in schema). Adds minimal extra meaning.

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?

Explicitly states 'Design amplitude taper weights for sidelobe control', which is a specific verb-resource pair. Lists supported window types, distinguishing it from sibling array tools like beam steering or factor computation.

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?

Implies usage for designing tapers, but no explicit when-to-use or when-not-to-use guidance compared to siblings like cst_array_beam_steering. The list of supported types helps choose a taper, but lacks exclusionary context.

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

cst_assign_materialB

Assign a material to an existing solid in CST Studio. The solid is specified as 'Component:SolidName'.

ParametersJSON Schema
NameRequiredDescriptionDefault
solidYesSolid reference as 'Component:SolidName' (e.g. 'Antenna:Patch')
materialYesMaterial name to assign

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 behavioral disclosure. It only states the basic action without mentioning side effects, error conditions (e.g., non-existent solid), or whether the operation is reversible. This is insufficient for an agent to anticipate 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.

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 primary action. It contains no unnecessary words, but could be slightly expanded for clarity without harming 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 has low complexity (2 required parameters) and no output schema. The description covers the basic operation but lacks details on what happens if the material does not exist, if the solid is invalid, or any confirmation of success. It is adequate but not 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?

Both parameters have descriptions in the schema (100% coverage). The description does not add significant new meaning beyond the schema; it reiterates the solid format. The baseline is 3 since schema coverage is high and no additional semantics are provided.

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 (assign) and the resource (material to an existing solid in CST Studio). It also specifies the format for the solid reference as 'Component:SolidName', which distinguishes this tool from related tools like cst_create_material or cst_delete_material.

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 have an existing solid and want to assign a material. However, it does not explicitly state when to use this tool versus alternatives (e.g., creating a new material, modifying material properties), nor does it provide conditions for use or prerequisites.

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

cst_boolean_addC

Unite/add two solids together. The result replaces solid1 with the combined volume of both shapes.

ParametersJSON Schema
NameRequiredDescriptionDefault
solid1YesFirst solid (result kept here) in "Component:Solid" format
solid2YesSecond solid (merged into first) in "Component:Solid" format

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 states that the result replaces solid1, which is useful, but lacks details on side effects, permissions required, or whether the operation is destructive (e.g., original solids are modified). The description is minimal.

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 direct and concise. It contains no unnecessary words or 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?

Given the simplicity of the tool (two parameters, no output schema), the description is minimally adequate. It explains the core function and side effect (replaces solid1), but lacks information on return values, error conditions, or preconditions. For a straightforward operation, 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.

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 described in the schema. The description adds that 'solid1' is replaced, which is already implied by the schema description 'result kept here'. Thus, the description adds marginal extra value. Baseline 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 ('Unite/add') and the resource ('two solids'), and specifies the result ('replaces solid1'). It distinguishes from sibling boolean tools by using 'add', but could be more precise about the operation being a union.

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 like cst_boolean_intersect or cst_boolean_subtract. The description implies it performs a union but does not provide context for selection or exclusion.

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

cst_boolean_insertB

Insert solid2 into solid1. Solid2 is embedded within solid1, maintaining both material regions at the overlap.

ParametersJSON Schema
NameRequiredDescriptionDefault
solid1YesHost solid in "Component:Solid" format
solid2YesSolid to insert in "Component:Solid" format

TDQS

B3.1/5.0
Behavior2/5

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

Without annotations, the description carries full burden. It states 'maintaining both material regions' but does not clarify if the operation is destructive to solid1, whether solid2 remains independently selectable, or what happens to material assignments. The term 'embedded' is ambiguous.

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 short sentences convey the essential operation without extraneous information. 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?

The description is adequate for a simple two-parameter tool with no nested objects or output schema. However, it lacks details about return values, side effects on the scene, or error conditions, which would be helpful for a boolean 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 coverage is 100% with clear parameter descriptions ('Host solid', 'Solid to insert'). The description adds slight nuance ('Insert solid2 into solid1') but does not substantially improve understanding 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 action ('Insert solid2 into solid1') and the result (maintaining both material regions). It distinguishes from sibling boolean operations by implying a non-destructive insertion, though it could explicitly differentiate from cst_boolean_add or cst_boolean_intersect.

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 like cst_boolean_add, cst_boolean_intersect, or cst_boolean_subtract. The description lacks usage context, prerequisites, or scenarios.

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

cst_boolean_intersectA

Intersect two solids. Only the overlapping volume is kept, replacing solid1. Solid2 is deleted.

ParametersJSON Schema
NameRequiredDescriptionDefault
solid1YesFirst solid in "Component:Solid" format
solid2YesSecond solid in "Component:Solid" format

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description carries full burden. It explicitly states that solid1 is replaced and solid2 is deleted, which is good transparency for a boolean operation. Minor missing details like irreversibility or return value, but 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 two sentences, front-loaded with key actions, and contains zero wasted words. Highly efficient.

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 no output schema, the description explains the operation's effect on inputs. It might benefit from mentioning return value or logging, but overall complete for a simple boolean 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 coverage is 100%, with each parameter having descriptive format info. The description adds nothing beyond the schema, so baseline 3 is appropriate. No need for extra semantics.

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 intersects two solids, keeps the overlapping volume, and specifies the effects on solid1 and solid2. It distinctly differentiates from sibling boolean operations like add, insert, and subtract.

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 implicitly indicates usage for intersection operations, but no explicit guidance on when to use versus alternatives is provided. However, the sibling names are distinct enough to infer the differences.

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

cst_boolean_subtractB

Subtract solid2 from solid1. The overlapping volume of solid2 is removed from solid1. Solid2 is deleted.

ParametersJSON Schema
NameRequiredDescriptionDefault
solid1YesSolid to subtract from in "Component:Solid" format
solid2YesSolid to subtract (removed) in "Component:Solid" format

TDQS

B3.4/5.0
Behavior3/5

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

The description discloses that solid2 is deleted as a side effect, which is valuable. However, it does not mention whether solid1 is modified in place or if a new object is created, nor does it discuss error conditions or prerequisites. With no annotations, the burden is on the description, and it partially meets it.

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: three short sentences, each adding distinct information (operation, effect on solid1, side effect on solid2). No wasted words, and the most critical information is front-loaded.

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 subtract operation with a complete input schema, the description covers the core action and side effect. It could be slightly more explicit about whether the operation modifies solid1 in place, but overall it is sufficient for an agent to use the tool 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?

Schema coverage is 100%, and the parameter descriptions in the schema are clear. The tool description adds no additional semantic information beyond restating the roles (subtract from vs. subtract). Baseline 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 operation: subtract solid2 from solid1, and explains the effect. However, it does not explicitly differentiate from sibling boolean operations like add, insert, or intersect, leaving some ambiguity for an agent choosing between 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?

No guidance is provided on when to use this tool versus alternatives (e.g., cst_boolean_add, cst_boolean_intersect). The description only states what it does, not when it is appropriate.

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

cst_close_projectA

Close the currently open CST project and release its resources.

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?

No annotations provided, so the description must carry the full burden. It mentions 'release its resources' but does not specify side effects: e.g., whether unsaved changes are lost, behavior if no project is open, or if calling multiple times is safe. This lack of detail 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.

Conciseness4/5

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

The description is a single, efficient sentence that immediately conveys the action. It is front-loaded, but could briefly mention prerequisites or consequences without being 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 no output schema or annotations, the description is the sole source. It covers the basic action but misses edge cases (e.g., error handling, state expectations like 'project must be open'). This is adequate but not fully complete for an agent to use robustly.

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?

No parameters exist (schema coverage 100%), so the description does not need to add parameter info. Baseline for 0 params is 4, and the description appropriately omits 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 clearly states the tool's action ('Close the currently open CST project') and its effect ('release its resources'). It distinguishes from sibling tools like cst_open_project, cst_create_project, and cst_save_project by specifying the current project and resource release.

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 guidance on when to use this tool vs alternatives. Usage is implied from the purpose (close when done with project), but no exclusions or context such as 'call after saving' or 'do not call if no project is open'.

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

cst_configure_eigenmode_advancedA

Advanced eigenmode solver configuration for higher-order modes. Use this for waveguide mode analysis, cavity resonator design, and filter characterization where fine control over mode count, frequency targeting, and solver order is needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
accuracyNoSolver accuracy target (default 1e-6)
num_modesNoNumber of eigenmodes to compute (1-50, default 5)
solver_orderNoSolver order 1-3 for higher accuracy (default 1)
frequency_estimate_ghzNoFrequency estimate in GHz to target specific modes (optional)

TDQS

A3.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 full burden. It states it is a configuration tool and mentions parameters, but does not disclose any side effects, whether it modifies global state, or if it is destructive. For a 'configure' action, basic behavioral expectations are not communicated.

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 concise sentences: first defines the tool, second provides application context. No filler or redundancy. Front-loaded with purpose.

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 configuration tool with 4 parameters, the description covers the key differentiators (advanced, higher-order, fine control). It omits return values but no output schema exists. With sibling tools, the advanced focus is clear. Slightly lacking in behavioral context, but adequate overall.

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 baseline is 3. The description mentions 'mode count, frequency targeting, and solver order' which map to parameters, but adds minimal interpretive value beyond the schema descriptions.

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 this is for 'Advanced eigenmode solver configuration' and lists specific applications (waveguide, cavity, filter) that require 'fine control over mode count, frequency targeting, and solver order.' While it distinguishes from a basic solver, it does not explicitly name the sibling tool 'cst_configure_eigenmode_solver' for contrast.

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 explicit contexts for use: 'waveguide mode analysis, cavity resonator design, and filter characterization where fine control...needed.' This implies when to prefer this advanced version over a basic solver, but lacks explicit when-not-to-use or alternative tools.

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

cst_configure_eigenmode_solverA

Configure the eigenmode solver. Computes resonant frequencies and field distributions of cavity structures. Used for filter design, resonator characterization, and Q-factor extraction.

ParametersJSON Schema
NameRequiredDescriptionDefault
f_minNoLower frequency bound in GHz — modes below this are skipped (default 0)
accuracyNoSolver accuracy target (default 1e-6)
number_of_modesNoNumber of eigenmodes to compute (default 5)

TDQS

A3.6/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. It describes the tool as configuring the solver and computing results, which implies a non-destructive setup action. However, it does not disclose prerequisites, side effects (e.g., overwriting existing settings), or any additional behavioral traits beyond the primary purpose.

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?

Two sentences efficiently convey action and purpose. No wasted words, but could benefit from a slightly more structured format (e.g., bullet points or separate sections for parameters and usage). Still, it is 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?

For a simple configuration tool with 3 parameters and no output schema, the description is minimally adequate. It explains the general purpose but lacks details on return values, prerequisites, or interaction with other tools. Given the simplicity, a score of 3 is appropriate.

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 in the schema). The description adds no parameter-specific information beyond what the schema already provides. Per guidelines, baseline is 3 when coverage is high and description adds no extra meaning.

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 configures the eigenmode solver, computes resonant frequencies and field distributions, and lists specific use cases (filter design, resonator characterization, Q-factor extraction). This distinguishes it from other solver configuration tools like cst_configure_frequency_domain_solver.

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 examples (filter design, etc.) but does not explicitly state when to use this tool over alternatives or when not to use it. No exclusions or alternative tools are mentioned, which is a gap given the many sibling solver tools.

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

cst_configure_frequency_domain_solverA

Configure the frequency domain solver. Best for narrowband problems, resonant structures, and when field distributions at specific frequencies are needed. Supports interpolated, discrete, and general-purpose sweep types.

ParametersJSON Schema
NameRequiredDescriptionDefault
f_maxYesMaximum frequency in GHz
f_minYesMinimum frequency in GHz
samplesNoNumber of frequency samples (default 1001)
accuracyNoSolver accuracy / residual target (default 1e-6)
sweep_typeNoFrequency sweep type (default Interpolated)Interpolated

TDQS

A3.8/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 'Configure the frequency domain solver' without explaining side effects (e.g., whether it overwrites previous settings, requires a running project, or affects other solvers). The description adds limited behavioral context beyond what the input schema already conveys.

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 that front-load the core action ('Configure the frequency domain solver') and immediately provide usage context. No redundant or 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?

The description covers the tool's purpose, best use cases, and supported sweep types, which is sufficient for a configuration tool with self-describing parameters. However, it lacks details about the tool's effect (e.g., whether it validates inputs, fails silently, or requires a project to be open). Given the absence of annotations and output schema, a bit more context would be beneficial.

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 parameter descriptions in the schema are clear. The tool description does not add additional meaning to parameters beyond stating sweep types, which are already enumerated in the schema. For a tool with full schema coverage, 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 tool's purpose ('Configure the frequency domain solver') and distinguishes from sibling solvers by specifying typical use cases: 'Best for narrowband problems, resonant structures, and when field distributions at specific frequencies are needed.' This directly differentiates it from time domain solver and other solver 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 description explicitly provides guidance on when to use the tool ('Best for narrowband problems, resonant structures...') and mentions supported sweep types, giving context for selection. However, it does not explicitly state when not to use it or list alternatives, though the 'best for' phrasing implicitly excludes broadband or transient problems.

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

cst_configure_ie_solver_advancedA

Advanced Integral Equation solver configuration for electrically large structures. Provides control over preconditioner, MLFMM acceleration, and low-frequency stabilization for installed antenna performance and large-platform RCS analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault
mlfmmNoEnable Multi-Level Fast Multipole Method for large problems (default true)
accuracyNoIterative solver residual target (default 1e-3)
max_iterationsNoMaximum number of solver iterations (default 1000)
preconditionerNoPreconditioner type (default ILU)ILU
low_frequency_stabilizationNoEnable low-frequency stabilization for broadband problems (default false)

TDQS

A3.7/5.0
Behavior3/5

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

No annotations are provided, so the description must convey behavioral traits. It describes the tool as a configuration interface for solver settings, which suggests it modifies solver parameters rather than performing destructive actions. However, it does not explicitly state that it modifies project state or describe side effects. The description is adequate but lacks explicit behavioral 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 extremely concise—two sentences that cover purpose, target domain, and key features. Every word serves a purpose; no unnecessary repetition. It is front-loaded with the main action and quickly provides differentiating 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 the rich schema and no output schema, the description effectively explains the tool's role among many solver config tools. It could be improved by explicitly contrasting with the basic integral equation solver or mentioning that it sets advanced options. Overall, it is complete enough for an AI to understand the tool's purpose and scope.

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?

All 5 parameters are fully described in the schema (100% coverage). The description adds value by grouping parameters (preconditioner, MLFMM, low-frequency stabilization) and linking them to the target use case (electrically large structures), enhancing the semantic context beyond schema defaults.

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 is an advanced configuration for the Integral Equation solver, targeting electrically large structures. It mentions specific features (preconditioner, MLFMM, low-frequency stabilization) and use cases (installed antenna, large-platform RCS). However, it does not explicitly differentiate from the sibling tool cst_configure_integral_equation_solver, which likely serves as the basic version.

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 provides context (electrically large structures, specific applications) but does not offer explicit guidance on when to use this tool versus alternatives. There is no mention of when not to use it or comparison to other solver configurations like cst_configure_frequency_domain_solver. Usage is implied rather than direct.

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

cst_configure_integral_equation_solverA

Configure the integral equation (IE) solver. Best for electrically large, open-boundary problems like antenna placement on vehicles, RCS computation, and EMC/EMI analysis where volume meshing would be impractical.

ParametersJSON Schema
NameRequiredDescriptionDefault
accuracyNoIterative solver residual target (default 1e-3)
max_iterationsNoMaximum number of solver iterations (default 1000)

TDQS

A3.8/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 merely states to configure the solver, but does not mention whether this modifies the project state, requires prior setup, or has any side effects. The agent is left uninformed about the tool's 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: two sentences that front-load the purpose and then provide usage guidance. Every word serves a purpose with no 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 simple configuration tool with two optional parameters and no output schema, the description covers purpose and usage context adequately. It could mention that the tool modifies the current project's solver settings, but overall it is sufficiently complete given 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?

Schema coverage is 100% with explicit descriptions for both parameters (accuracy, max_iterations) including defaults. The tool description adds no additional parameter context beyond the schema, so 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 configures the integral equation (IE) solver and provides specific use cases (antenna placement, RCS, EMC/EMI) that distinguish it from other solver configuration tools 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 Guidelines4/5

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

The description gives clear context on when to use this solver ('electrically large, open-boundary problems where volume meshing would be impractical'), implicitly advising against use for small or enclosed problems. However, it does not explicitly mention alternative solvers.

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

cst_configure_multilayer_solverB

Configure the solver for planar multilayer structures. Optimised for antenna-on-PCB, frequency selective surfaces (FSS), and radome analysis using the frequency domain solver with multilayer-specific settings.

ParametersJSON Schema
NameRequiredDescriptionDefault
f_maxYesMaximum frequency in GHz
f_minYesMinimum frequency in GHz
sweep_typeNoFrequency sweep type (default Interpolated)Interpolated
num_samplesNoNumber of frequency samples (default 501)

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. It states the tool 'configures' settings but does not disclose behavioral traits such as side effects, prerequisites (e.g., open project, existing multilayer structure), or whether the configuration is persistent. This is insufficient for a configuration 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 concise at 25 words and efficiently communicates the core purpose. It is front-loaded with key info. However, a bit more structure (e.g., separated usage context) could improve clarity 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 the tool's complexity (multilayer solver configuration) and no output schema or annotations, the description is incomplete. It does not explain prerequisites, what configuration is applied, or how to verify the setup. For a configuration tool, 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 input schema already provides descriptions for all 4 parameters (100% coverage), including defaults and enumerations. The description adds no additional parameter semantics beyond listing use cases. Baseline 3 is appropriate as schema does the heavy lifting.

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 explicitly states the tool configures the solver for planar multilayer structures, listing specific applications (antenna-on-PCB, FSS, radome) and specifying the frequency domain solver. This clearly differentiates it from sibling tools like cst_configure_frequency_domain_solver, which is more general.

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 planar multilayer structures but does not provide explicit guidance on when to use this tool vs alternatives (e.g., cst_configure_eigenmode_solver, cst_configure_time_domain_solver). No when-not-to-use 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.

cst_configure_time_domain_solverA

Configure the time domain (transient) solver. This is CST's flagship solver for broadband simulations — it excites the structure with a pulse and computes S-parameters, fields, and farfield across the entire frequency range in a single run.

ParametersJSON Schema
NameRequiredDescriptionDefault
accuracyNoAccuracy level in dB — solver stops when energy has decayed to this level (default -40)
max_time_stepsNoMaximum number of time steps; 0 means automatic (default 0)
excitation_typeNoExcitation signal shape (default Gaussian)Gaussian
fixed_impedanceNoReference impedance in ohms when normalization is enabled (default 50)
stimulation_portNoPort number used for excitation (default 1)
normalize_to_fixed_impedanceNoNormalize S-parameters to a fixed reference impedance (default true)

TDQS

A4/5.0
Behavior3/5

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

No annotations provided, so description carries burden. It discloses excitation method and outputs (S-params, fields, farfield) but does not mention prerequisites, potential issues, or 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?

Two concise sentences, front-loaded with purpose, no wasteful words. Second sentence adds valuable behavioral context.

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?

No output schema, but description covers main outputs. Lacks information on prerequisites (e.g., open project, defined ports) and typical usage flow. Adequate for a configure 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?

All 6 parameters have descriptions in the input schema (100% coverage). The description does not add any additional meaning or usage context 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?

Clearly states it configures the time domain solver and distinguishes it from frequency domain by describing broadband pulse excitation and single-run computation of S-parameters, fields, and farfield across the entire frequency range.

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?

Implies use for broadband simulations needing S-params/fields/farfield but does not explicitly state when to use over frequency domain or list prerequisites. Context is clear but lacks exclusions or alternatives.

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

cst_connectA

Explicitly attach to a running CST Design Environment or start one. Disabled mode never connects.

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?

No annotations are provided, so the description carries the full burden. It discloses the main behavior (attach/start) and the 'Disabled mode never connects' trait, but this trait is vague and unexplained. It does not say what happens in disabled mode (silent no-op, error, etc.), nor does it mention license requirements, blocking behavior, or side effects. For a tool that could silently fail, 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.

Conciseness5/5

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

The description is two short sentences with no redundancy. It front-loads the primary action ('Explicitly attach... or start one') and then adds the important 'Disabled mode' caveat. Every sentence contributes essential information, and 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?

For a simple connection tool, the description covers the core function and one edge case, but it lacks guidance on when this tool should be called relative to other CST operations (e.g., is it typically required before other tools?) and what happens in disabled mode. Given the large sibling list and the absence of an output schema, the description could provide more context about the tool's role in the workflow.

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 (100% coverage). The description mentions 'Disabled mode,' which might be confused with a parameter but is not part of the schema. Since no parameters exist, the description adds little beyond the schema, but the baseline for 0 params is 4, and it does not mislead about parameter inputs.

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: 'Explicitly attach to a running CST Design Environment or start one.' This uses a specific verb (attach/start) and resource (CST Design Environment), and the word 'Explicitly' differentiates it from any implicit connection mechanism. It is distinct from siblings like cst_connection_status (which reports status) and cst_disconnect (which ends a connection).

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: to establish a connection to CST, use this tool. However, it does not explicitly mention alternatives such as cst_connection_status for checking connection state or cst_disconnect for ending it, nor does it provide when-not-to-use guidance. The 'Disabled mode' hint suggests a condition, but it does not explain when an agent should call this versus other tools.

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

cst_connection_statusA

Get the current CST Studio connection status, including mode (connected/offline), CST availability, version, and work directory.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior4/5

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

The description clearly states the return content (mode, availability, version, work directory). Since no annotations are provided, the description carries full burden. It discloses that it is a read-only operation (get status), which is sufficient. Could add that it does not modify any state.

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 sentence that is front-loaded with the core action ('Get the current CST Studio connection status') and then details what is included. No wasted words.

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 simple getter with no parameters and no output schema, the description is complete. It explains the purpose and the output fields. Nothing missing.

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?

No parameters defined, so baseline 4 applies. The description does not need to add parameter information. Schema coverage is 100% (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?

Describes exactly what the tool does: get CST Studio connection status. Lists specific information included (mode, availability, version, work directory). Clearly distinct from sibling tools which are about modifying or analyzing CST projects.

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 guidance on when to use this tool vs alternatives. However, as a status checker, it's implicitly used to verify connection before performing other CST operations. Could be improved by stating that it should be called before any CST operations that require an active connection.

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

cst_constrained_optimizerB

Single-objective optimization with explicit inequality constraints. Example: minimize S11 subject to gain > 8 dBi and bandwidth > 100 MHz.

ParametersJSON Schema
NameRequiredDescriptionDefault
methodNoTrust Region
objectiveYes
parametersYes
constraintsYes
max_evaluationsNo

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 fully disclose behavioral traits. It only says 'optimization' without mentioning potential side effects, simulation requirements, time cost, or result handling. The example gives some idea of inputs but not 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 concise and front-loaded with the core purpose, and the example adds clarity without waste. It could be more informative, but it is not verbose.

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?

Given the tool has 5 parameters, nested objects, no output schema, and no annotations, the description is far from complete. It lacks any explanation of how to specify objective, constraints, or parameters, and does not describe expected results or side effects. The example is illustrative but insufficient for correct invocation.

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?

Schema coverage is 0%, so the description must compensate by explaining parameters. It does not describe the structure of objective, constraints, parameters, or method. The example mentions 'S11', 'gain', 'bandwidth' but does not clarify they are result_path fields, and no parameter names or semantics are given.

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 the tool performs 'Single-objective optimization with explicit inequality constraints,' which is a specific verb (optimize) and resource (a single objective with constraints). The example clarifies the domain. This distinguishes it from siblings like cst_multi_objective_optimizer and cst_parameter_sweep.

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 usage for single-objective problems with constraints, but does not explicitly state when not to use it or mention alternatives like cst_multi_objective_optimizer. The example provides context, but no direct comparison or exclusions are given.

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

cst_create_analytical_curveB

Create a parametric analytical curve in CST Studio using expressions of parameter t.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesCurve name
t_maxYesParameter t maximum value
t_minYesParameter t minimum value
x_exprYesX expression as function of t (e.g. 'cos(t)')
y_exprYesY expression as function of t (e.g. 'sin(t)')
z_exprYesZ expression as function of t (e.g. 't')

TDQS

B3.1/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. The description only states the action; it does not disclose side effects, prerequisites (e.g., open project), or behavior like overwriting or creating a curve object.

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?

A single sentence that is concise and front-loaded. It is efficient for a simple tool, though it lacks structure or sections.

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 6 parameters and no output schema, the description is minimal. It does not explain return behavior, provide examples, or give context about the CST environment. The schema covers parameter meanings but not usage 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 coverage is 100%, so baseline is 3. Description adds 'using expressions of parameter t' which reinforces schema but does not provide new meaning beyond what the parameter descriptions already state.

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 'Create', the resource 'parametric analytical curve', and the method 'using expressions of parameter t'. It is specific and distinguishes from sibling creation 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?

No guidance on when to use this tool versus alternatives (e.g., cst_create_face_from_curves). No exclusions or prerequisites mentioned.

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

cst_create_anisotropic_materialA

Create an anisotropic material with per-axis permittivity, permeability, and loss tangent values. Used for crystals, metamaterials, and composite substrates.

ParametersJSON Schema
NameRequiredDescriptionDefault
mu_xYesRelative permeability along X
mu_yYesRelative permeability along Y
mu_zYesRelative permeability along Z
nameYesMaterial name
tan_d_xNoElectric loss tangent along X
tan_d_yNoElectric loss tangent along Y
tan_d_zNoElectric loss tangent along Z
epsilon_xYesRelative permittivity along X
epsilon_yYesRelative permittivity along Y
epsilon_zYesRelative permittivity along Z

TDQS

A3.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 must disclose all behavioral traits. It only says 'create' but does not specify if the material is stored in a project, requires an open project, or has any side effects. The burden is not fully met.

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 sentences that are concise and front-loaded: first sentence states the action and parameters, second sentence provides use cases. No 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?

Given no output schema and no annotations, the description is fairly complete for a creation tool. It covers what the tool does and the key parameters. However, it lacks context about project dependencies (e.g., whether a project must be open) or return values.

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 a summary of parameter types (permittivity, permeability, loss tangent) but does not provide additional constraints, relationships, or examples beyond what the schema already contains.

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 creates an anisotropic material with per-axis properties, and mentions specific use cases (crystals, metamaterials, composite substrates). This distinguishes it from other material creation tools like isotropic materials (cst_create_material) or special materials.

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 lists typical applications but does not explicitly state when to use this tool versus alternatives (e.g., isotropic materials, ferrites). No 'when not to use' or exclusion criteria are provided, leaving the agent to infer from the name and parameters.

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

cst_create_brickC

Create a rectangular brick (box) in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesSolid name (e.g. 'Substrate')
x_maxYesX range maximum
x_minYesX range minimum
y_maxYesY range maximum
y_minYesY range minimum
z_maxYesZ range maximum
z_minYesZ range minimum
materialNoMaterial namePEC
componentYesComponent name (e.g. 'Antenna')

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 fully disclose behavior. It only states the action without mentioning side effects, permissions, or whether the component must already exist. For a creation tool, this is insufficient transparency.

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 unnecessary words. It is front-loaded and efficient, though slightly under-specified for completeness.

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 an output schema and annotations, the description falls short. It does not mention the active project requirement, material defaults, or that the brick is a solid shape. The completeness is adequate for a trivial tool but could provide 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?

All 9 parameters have descriptions in the input schema (100% coverage), so the description adds no additional meaning beyond the schema. Baseline of 3 is appropriate as the schema already documents the parameters adequately.

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 ('Create') and the object ('rectangular brick (box)'), and the tool name includes 'brick', distinguishing it from sibling tools like 'create_cylinder' or 'create_sphere'. It effectively communicates its purpose, though it could add more context about the environment.

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 (e.g., extrusions, other primitives) or any prerequisites (e.g., active project, existing component). The description lacks contextual clues for appropriate usage.

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

cst_create_cole_cole_materialA

Create a Cole-Cole dispersive material. Generalisation of the Debye model with a distribution parameter alpha (0-1) that broadens the relaxation spectrum. Used for biological tissues, soil, and broadband absorbers.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'Muscle Tissue')
alphaYesDistribution parameter (0 = Debye, 1 = max broadening)
epsilon_infYesHigh-frequency (optical) permittivity limit
delta_epsilonYesStatic permittivity increment (eps_s - eps_inf)
relaxation_time_psYesRelaxation time in picoseconds

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description explains the physical behavior (broadening of relaxation spectrum via alpha) and model generalization, providing good transparency about what the tool does without mentioning side effects or destructive actions, which is adequate 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.

Conciseness5/5

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

The description is very concise: three sentences covering purpose, model generalization, and typical use cases. Every sentence adds value with no 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?

Given 5 required parameters, no output schema, and no annotations, the description adequately explains the tool's purpose and parameter significance. It does not specify return values or side effects, but for a creation tool, the context is largely sufficient.

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 100% coverage with descriptions for each parameter. The description adds physical context (e.g., alpha range 0-1, relaxation time in ps) that enhances understanding beyond the schema alone.

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 'Create a Cole-Cole dispersive material' and explains it's a generalization of the Debye model with alpha parameter. It also lists specific use cases (biological tissues, soil, broadband absorbers), distinguishing it from other material creation tools like Debye or Drude.

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 materials with broadened relaxation spectra and lists example applications, but it does not explicitly state when to use this vs. other dispersive material models (e.g., Debye, Lorentz) or provide any 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.

cst_create_coneB

Create a cone or truncated cone in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisYesCone axis
nameYesSolid name
center_xNoCenter X coordinate
center_yNoCenter Y coordinate
center_zNoCenter Z coordinate
materialNoMaterial namePEC
componentYesComponent name
range_maxYesAxis range maximum
range_minYesAxis range minimum
top_radiusYesTop radius (0 for pointed cone)
bottom_radiusYesBottom radius

TDQS

B3/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 for behavioral disclosure. It fails to mention any constraints, edge cases (e.g., top_radius > bottom_radius), or what happens with invalid inputs, making it severely lacking.

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 communicates the core function without extraneous words.

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 (11 parameters, 7 required) and no output schema, the description is far too brief. It does not explain parameter roles, coordinate system, material handling, or provide any usage context beyond the basic shape.

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 each parameter has a clear description. The tool description adds nothing beyond the schema, but the baseline is 3 since the schema already provides adequate documentation.

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 explicitly states 'Create a cone or truncated cone in CST Studio,' which clearly identifies the tool's purpose and distinguishes it from sibling shape creation tools like cylinders or bricks.

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., cylinder, extruded polygon). There is no mention of context or exclusions.

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

cst_create_cylinderB

Create a cylinder in CST Studio. Use inner_radius=0 for a solid cylinder.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisYesCylinder axis
nameYesSolid name
center_xNoCenter X coordinate
center_yNoCenter Y coordinate
center_zNoCenter Z coordinate
materialNoMaterial namePEC
componentYesComponent name
range_maxYesAxis range maximum
range_minYesAxis range minimum
inner_radiusNoInner radius (0 for solid)
outer_radiusYesOuter radius

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. It only states 'Create a cylinder' which implies object creation, but does not disclose any behavioral traits such as whether it modifies existing components, requires a specific project state, or has any side effects. The inner_radius tip is minimal. For a tool with no annotations, more transparency is expected.

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 short sentences. The first states the purpose, the second adds a crucial usage tip. No fluff or redundancy. 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?

Given the tool has 11 parameters (6 required) and no output schema or annotations, the description is sparse. It does not explain coordinate context, typical component setup, or how parameters interact. However, schema descriptions cover all parameters, so the essential details are present. The description could be more helpful for a complex tool but meets minimum viability.

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?

With 100% schema description coverage, the baseline is 3. The description adds the tip 'Use inner_radius=0 for a solid cylinder,' which repeats the existing parameter description. It does not add new semantic meaning beyond the schema definitions.

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 creates a cylinder in CST Studio, which is a specific verb-resource pair. However, it does not differentiate from sibling creation tools like cst_create_brick or cst_create_cone, relying solely on the name for distinction. A clearer purpose with differentiation would merit 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?

The description provides no guidance on when to use this tool versus alternatives. It only includes a note about using inner_radius=0 for a solid cylinder, which is a parameter hint rather than usage context. No when/when-not or alternative tools are mentioned.

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

cst_create_debye_materialA

Create a frequency-dependent dielectric material using the Debye relaxation model. Models polar dielectrics where permittivity decreases with frequency: eps(w) = eps_inf + delta_eps/(1 + jw*tau). Used for biological tissues, water, polymers, and soil.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'Wet Soil')
orderNoDebye model order (1 or 2)
tan_dNoOptional static loss tangent
epsilon_infYesHigh-frequency (optical) permittivity limit
delta_epsilonYesStatic permittivity increment (eps_s - eps_inf)
relaxation_time_psYesRelaxation time in picoseconds

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 fully disclose behavioral traits. It explains the physical model but omits operational details such as whether the material is added to the project's material library, if it requires an open project, or any side effects. The description is scientifically informative but lacks operational 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 two sentences long, front-loaded with the purpose and model. It includes the formula efficiently without any extraneous information. Every sentence 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?

Given the complexity (6 parameters, no output schema), the description provides the scientific model and typical uses but does not specify the return value or operational context (e.g., does it return a material handle?). It is complete in the domain sense but lacks practical context for an AI agent to anticipate side effects or prerequisites.

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% with descriptions for all parameters. The description adds significant value by providing the Debye model equation, which clarifies the physical meaning of epsilon_inf, delta_epsilon, and relaxation_time_ps. This goes beyond the schema's basic descriptions, aiding parameter understanding.

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 specifies the verb 'Create', the resource 'frequency-dependent dielectric material', and the model 'Debye relaxation model'. The inclusion of the mathematical formula and application examples (biological tissues, water, polymers, soil) clearly distinguishes this tool from sibling material creation tools like Cole-Cole or Drude.

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 mentions typical applications (biological tissues, water, polymers, soil) but does not explicitly state when to use this tool versus alternatives like cst_create_cole_cole_material or cst_create_drude_material. It lacks exclusions or comparative guidance, which is needed given the number of sibling material creation tools.

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

cst_create_drude_materialA

Create a Drude metal model material for plasmonic and metamaterial simulations. Models free-electron metals: eps(w) = 1 - wp^2 / (w^2 + jgammaw). Used for gold, silver, aluminium in optical/THz frequency ranges.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'Drude Gold')
plasma_freq_ghzYesPlasma frequency in GHz
collision_freq_ghzYesCollision (damping) frequency in GHz

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 bears full responsibility for behavioral disclosure. It only states that it creates a Drude material; it does not mention side effects (e.g., whether it overwrites existing materials, permissions required, or how the material is stored). The formula is informative but insufficient for agent understanding of the operation's impacts.

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 concise with two sentences: purpose followed by formula. It is front-loaded with the core action and resource. Every sentence adds meaningful information without redundancy or 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?

Given the lack of output schema and annotations, the description adequately explains the creation purpose and model. However, it does not cover post-creation behavior (e.g., return value, whether the material can be assigned) or prerequisites. For a simple creation tool, this is minimally viable but could be more 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 covers all three parameters with clear descriptions. The description adds value by providing the Drude model formula, which connects the parameters (plasma_freq_ghz, collision_freq_ghz) to their physical roles (wp, gamma). This context goes beyond the schema's basic naming, earning a score 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 clearly states the tool creates a Drude metal model material for plasmonic and metamaterial simulations. It specifies the verb 'Create' and the resource 'Drude metal model material'. The formula and typical usage (gold, silver, aluminium) distinguish it from other material creation tools like Debye or Lorentz models, which have different mathematical forms.

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 free-electron metals in optical/THz ranges by providing the Drude model formula and examples. However, it does not explicitly state when not to use this tool or name alternative tools (e.g., cst_create_debye_material) for different material behaviors. The guidance is adequate but indirect.

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

cst_create_ecylinderC

Create an elliptical cylinder in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisYesCylinder axis
nameYesSolid name
center_xNoCenter X coordinate
center_yNoCenter Y coordinate
center_zNoCenter Z coordinate
materialNoMaterial namePEC
x_radiusYesRadius in local X direction
y_radiusYesRadius in local Y direction
componentYesComponent name
range_maxYesAxis range maximum
range_minYesAxis range minimum

TDQS

C2.9/5.0
Behavior2/5

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

The description lacks behavioral details beyond creation. It does not mention whether the tool requires an open project, creates a solid, or any side effects. With no annotations, the description should provide more 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 very concise with one sentence, no redundant information, and gets straight to the point.

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 with 11 parameters and no output schema or annotations, the description is too minimal. It does not explain how the elliptical cylinder is defined or the role of key parameters like x_radius and y_radius.

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 clear parameter descriptions. The tool description adds no additional meaning beyond the schema, remaining at the baseline of 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 'Create' and resource 'elliptical cylinder', distinguishing it from the sibling tool cst_create_cylinder which creates circular cylinders. However, it does not explicitly call out this 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?

No guidance is provided on when to use this tool versus other shape creation tools (e.g., cst_create_cylinder, cst_create_brick). Context signals such as prerequisites or typical workflow steps are absent.

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

cst_create_extrudeB

Extrude a 2D polygon profile into a 3D solid in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesSolid name
heightYesExtrusion height
pointsYesList of [x, y] coordinate pairs forming the profile polygon
materialNoMaterial namePEC
componentYesComponent name

TDQS

B3.2/5.0
Behavior2/5

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

No annotations are present, and the description does not disclose behavioral aspects such as whether the operation is destructive, requires existing geometry, or what side effects occur. It only states the basic 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?

The description is a single, direct sentence with no superfluous words. It is front-loaded and efficient.

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 having 5 parameters and no output schema, the description lacks critical context such as extrusion direction, axis, or any special behaviors. It is insufficient for a complete understanding of tool 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?

The input schema covers 100% of parameters with descriptions, so the tool description does not need to add much. However, it adds no extra meaning beyond the schema (e.g., extrusion direction, polygon closure requirements), warranting a 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 clearly states the verb 'Extrude' and the resource '2D polygon profile into a 3D solid', and specifies the domain 'in CST Studio'. It effectively distinguishes from sibling creation tools like cst_create_brick or cst_create_cylinder.

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, nor any prerequisites or conditions. The description lacks context for appropriate usage.

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

cst_create_face_from_curvesB

Create a planar face from one or more closed curves in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesFace/solid name
componentYesComponent name
curve_namesYesList of curve names to form the face boundary

TDQS

B3/5.0
Behavior2/5

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

With no annotations, the description must fully disclose behavior. It only says 'create a planar face' without explaining prerequisites (curves must exist and be closed), outcome, or side effects on the model.

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 extremely concise (one sentence) but lacks important details for a geometry creation tool. It earns points for front-loading but loses for being under-specified.

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 with 3 required parameters and no output schema or annotations, the description fails to explain prerequisites, the resulting face's properties, or how it integrates into the model workflow.

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 baseline is 3. The description adds no extra semantic meaning beyond the parameter names and descriptions already present in 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 creates a planar face from closed curves, using a specific verb and resource. It distinguishes from sibling geometry creation tools like cst_create_brick or cst_create_cylinder.

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 vs alternatives like cst_create_brick or cst_create_extrude. Lacks when-not and alternative suggestions.

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

cst_create_ferrite_materialA

Create a ferrite material with gyrotropic permeability tensor (Polder model). Essential for circulators, isolators, and phase shifters. The Polder tensor describes the anisotropic magnetic response of a magnetised ferrite (Pozar Ch. 9.1).

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'YIG Ferrite')
epsilon_rYesRelative permittivity of the ferrite
linewidth_oeYesFerromagnetic resonance linewidth in Oersted
field_directionNoDirection of the applied bias fieldz
applied_field_ka_mNoApplied DC bias magnetic field in kA/m
saturation_magnetization_ka_mYesSaturation magnetisation in kA/m (4piMs)

TDQS

A4/5.0
Behavior3/5

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

The description explains the physical model used (Polder tensor) but does not disclose side effects or operational behaviors such as requiring an open project, whether it overwrites existing materials, or any destructive actions. With no annotations, the description carries full burden and provides moderate 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 concise with three sentences. Each sentence serves a purpose: stating the action and model, listing typical applications, and providing a reference. No unnecessary words 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?

Given the tool has 6 parameters, no output schema, and no annotations, the description adequately explains what the tool does and the underlying physics. It provides sufficient context for selection. However, it could mention prerequisites (e.g., project must exist) or post-creation steps, but overall it is relatively complete for a material creation 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?

Schema coverage is 100% with good parameter descriptions. The description adds value by providing the physical context of the parameters (gyrotropic permeability, Polder model), helping the agent understand the significance of parameters like saturation magnetization and linewidth beyond their syntax.

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 creates a ferrite material with a specific gyrotropic permeability tensor (Polder model). It distinguishes from other material creation tools by naming the physical model and providing context with typical applications and a reference.

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 use for ferrite materials requiring anisotropic magnetic response and mentions applications (circulators, isolators, phase shifters). However, it does not explicitly state when to use this tool over alternatives like other material creation tools, nor does it provide conditions or exclusions.

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

cst_create_loftB

Create a lofted solid between two or more 2D profiles in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesSolid name
materialNoMaterial namePEC
profilesYesList of profiles, each a list of [x, y] coordinate pairs
componentYesComponent 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 states the basic operation without mentioning side effects (e.g., whether it overwrites existing solids), prerequisites (e.g., profiles must be planar), or constraints. This is insufficient 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, concise sentence that efficiently conveys the core purpose. It is front-loaded and contains no fluff. However, it could be slightly improved by incorporating key parameter hints without losing 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 complexity of the operation (lofting between multiple 2D profiles) and the lack of output schema and annotations, the description is incomplete. It does not explain profile requirements (closed?, 2D?), behavior on invalid input, or return value. More details are needed for confident 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 4 parameters, so the baseline is 3. The tool description adds no additional meaning beyond the schema, neither clarifying parameter relationships nor providing example values or formatting 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 'Create a lofted solid between two or more 2D profiles', specifying the verb (create), resource (lofted solid), and distinguishing details (between two or more 2D profiles). This differentiates it from sibling tools like cst_create_extrude (single profile along path) or cst_create_brick (box).

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 use when a lofted solid is needed, but does not provide explicit guidance on when to use it over alternatives like extrusion or other solid creation tools. No when-not or alternative recommendations are given, which is a gap given the many sibling create tools.

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

cst_create_lorentz_materialA

Create a Lorentz oscillator dispersive material. Models resonant dielectric behaviour near absorption bands: eps(w) = eps_inf + delta_eps * w0^2 / (w0^2 - w^2 + jgammaw). Used for glass, crystals, and optical materials.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'Optical Glass')
epsilon_infYesHigh-frequency permittivity limit
delta_epsilonYesOscillator strength (permittivity increment)
damping_freq_ghzYesDamping (collision) frequency in GHz
resonant_freq_ghzYesResonant frequency in GHz

TDQS

A3.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 full burden. It describes the mathematical model but does not disclose behavioral aspects such as whether it modifies existing materials, requires permissions, or has 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?

The description is concise with two sentences, includes the formula, and is front-loaded with the primary purpose. Minor improvement could be simplifying the formula presentation.

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 sibling material creation tools, the description does not provide enough guidance on when to use Lorentz vs. other models. It mentions use cases but lacks comparative context for an AI agent to decide.

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 already covers all parameters with descriptions (100% coverage), but the description adds value by providing the equation that contextualizes the parameters (e.g., resonant frequency, damping).

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: 'Create a Lorentz oscillator dispersive material' and provides the mathematical formula, distinguishing it from sibling material creation tools like Debye or Drude models.

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 mentions use cases ('glass, crystals, and optical materials') but does not explicitly compare to alternatives or state when not to use it, leaving the agent to infer appropriate contexts.

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

cst_create_lossy_metalA

Create a lossy metal material in CST Studio. Lossy metals model finite conductivity skin-effect losses, essential for accurate loss calculations in connectors, waveguides, and PCB traces.

ParametersJSON Schema
NameRequiredDescriptionDefault
muNoRelative permeability (mu_r)
nameYesMaterial name (e.g. 'Lossy Copper')
conductivityYesElectric conductivity in S/m (e.g. 5.8e7 for copper)

TDQS

A3.6/5.0
Behavior2/5

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

With no annotations, the description must convey behavioral traits. It explains the physics ('finite conductivity skin-effect losses') but does not disclose side effects, whether it overwrites existing materials, prerequisites, or potential errors. Key behavioral aspects are missing.

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 long, no wasted words. Front-loaded with the action, then adds contextual value. Every sentence 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?

Given the tool's simplicity (3 params, no output schema), the description adequately explains what it creates and why. It is nearly complete, though it could mention the result (e.g., material added to the project). Still, it meets the needs for this level of 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 baseline is 3. The description adds general context but does not elaborate on parameter usage (e.g., how to choose mu or conductivity). It does not add significant meaning beyond the schema's own parameter 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 clearly states 'Create a lossy metal material' with a specific verb and resource. It distinguishes from sibling material creation tools by specifying 'lossy metal' and provides typical application contexts (connectors, waveguides, PCB traces).

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 use cases for loss calculations but does not explicitly state when to use this tool versus alternatives like cst_create_material or cst_create_drude_material. No when-not-to-use or exclusionary guidance is provided.

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

cst_create_materialB

Create a new material with electromagnetic properties in CST Studio. Specify relative permittivity (epsilon), relative permeability (mu), electric and magnetic loss tangents, and conductivity.

ParametersJSON Schema
NameRequiredDescriptionDefault
muNoRelative permeability (mu_r)
nameYesMaterial name (e.g. 'MySubstrate')
color_bNoBlue colour component (0-1)
color_gNoGreen colour component (0-1)
color_rNoRed colour component (0-1)
epsilonNoRelative permittivity (epsilon_r)
tan_d_eNoElectric loss tangent (tan delta_e)
tan_d_mNoMagnetic loss tangent (tan delta_m)
conductivityNoElectric conductivity in S/m
transparencyNoTransparency (0 = opaque, 1 = fully transparent)

TDQS

B3.1/5.0
Behavior2/5

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

The description lacks details on side effects or prerequisites (e.g., whether a project must be open, if it overwrites existing materials, or what the return value is). Given no annotations, the description should disclose more behavioral traits.

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, direct, and to the point. No unnecessary 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?

While the description covers core functionality, it lacks context about the type of material (isotropic, frequency-independent) and potential implications. With 10 parameters and no output schema, more context would be beneficial.

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 parameters. The description merely lists the parameter types but does not add significant meaning 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.

Purpose4/5

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

The description clearly states the tool creates a new material with electromagnetic properties and lists the key properties (epsilon, mu, loss tangents, conductivity). However, it does not explicitly differentiate this from sibling tools like cst_create_anisotropic_material or cst_create_debye_material, which might create materials with different behavior.

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. For example, it does not state that this is for simple isotropic materials, nor does it suggest using other tools for frequency-dependent or anisotropic materials.

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

cst_create_polygon3dC

Create a 3D polygon curve in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesCurve name
pointsYesList of [x, y, z] coordinate triples

TDQS

C2.7/5.0
Behavior2/5

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

Without annotations, the description carries the full burden of behavioral disclosure. It only says 'Create', implying a write operation, but does not mention side effects, requirements (e.g., open project), or any constraints. The agent cannot infer 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.

Conciseness4/5

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

The description is a single, front-loaded sentence with no fluff. It is concise, but the brevity sacrifices completeness.

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 creation tool with no output schema and no annotations, the description is insufficient. It does not explain what a 'polygon curve' is (open/closed), coordinate system units, or whether the tool requires an active project. The agent lacks key context for correct invocation.

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 coverage is 100%, so the schema fully documents the parameters. The description adds no additional meaning beyond the schema, missing an opportunity to explain format, units, or constraints like coordinate system.

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 creates a 3D polygon curve in CST Studio, specifying the verb and resource. However, it does not distinguish this tool from siblings like cst_create_polygon_extrude or cst_create_analytical_curve, missing an opportunity to clarify when to use this specific tool.

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. The description lacks context about prerequisites, typical use cases, or exclusions, leaving the agent without decision support.

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

cst_create_polygon_extrudeB

Create a polygon and extrude it along an axis in CST Studio. Convenience tool combining polygon profile creation and extrusion.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisNoExtrusion axisz
nameYesSolid name
heightYesExtrusion height
pointsYesList of [x, y] coordinate pairs forming the polygon
materialNoMaterial namePEC
componentYesComponent 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 fully convey behavior. It only states the tool creates and extrudes a polygon, but does not disclose whether it modifies existing geometry, whether extrusion is additive or subtractive, how components are managed, or units/coordinate system assumptions.

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 efficient sentences that convey the core purpose without any redundant or vague wording. Every sentence adds value.

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 is a combination of two operations, the description could explain how the extrusion relates to the polygon (e.g., is height applied along axis after creation?). No output schema exists, but the schema covers inputs sufficiently. Some missing context about material default (PEC) and typical use in antenna design could 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 coverage is 100%, so baseline is 3. The description adds no additional meaning beyond the schema parameter descriptions (e.g., points, height, axis). It does not provide examples or clarify relationships between 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 'Create a polygon and extrude it along an axis in CST Studio' as a 'convenience tool combining polygon profile creation and extrusion.' It distinguishes this from siblings like cst_create_polygon3d (polygon only) and cst_create_extrude (generic extrusion) by explicitly combining both 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?

The description mentions it is a 'convenience tool' but provides no guidance on when to use this vs. the separate polygon and extrusion tools, nor any prerequisites or constraints. No when-not-to-use or alternative recommendations are given.

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

cst_create_projectA

Create a new CST Studio Suite project file. In connected mode the project is created directly; in offline mode a VBA script is returned for manual execution.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesFull file path for the new project, e.g. 'C:/cst_projects/MyAntenna.cst'.
project_typeNoCST project type. One of: MWS (Microwave Studio), EMS (EM Studio), PS (Particle Studio), MPS (Mphysics Studio), CS (Cable Studio), DS (Design Studio), PCB (PCB Studio).MWS

TDQS

A4/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 full burden. It discloses the dual-mode behavior (direct creation vs VBA script return), which is key. However, it omits important behavioral details: what happens if the path already exists (overwrite? error?), required user permissions, or any side effects. These gaps reduce transparency 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?

Two sentences, each serving a distinct purpose: first states the primary action, second explains mode-dependent behavior. No repetition, no filler words. The most important info ('Create project') is front-loaded.

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 two-parameter tool with no output schema, the description covers the essential: what it does, parameters (via schema), and mode behavior. However, it lacks specifics about return values (beyond VBA script), error handling, or path constraints. Given the context, it is largely complete but could address a few edge cases.

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 describes both parameters with examples and default values (100% coverage). The description adds little beyond the schema, merely restating the path example and project types. With high schema coverage, the baseline is 3; the description does not provide additional semantic value (e.g., constraints on path, format rules).

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 states the tool creates a CST project file with specific verb 'Create' and resource 'CST Studio Suite project file'. It distinguishes between connected and offline modes, providing clear scope. No sibling tool has a similar purpose (e.g., cst_open_project opens existing projects), ensuring uniqueness.

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?

Description explains the main use case (creating a project) and provides context about the two operational modes (connected vs offline). However, it does not explicitly state when not to use (e.g., if a project already exists, might need to overwrite) or point to an alternative (cst_open_project for existing projects). Still, the mode distinction offers useful guidance.

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

cst_create_sphereB

Create a sphere in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesSolid name
radiusYesSphere radius
center_xNoCenter X coordinate
center_yNoCenter Y coordinate
center_zNoCenter Z coordinate
materialNoMaterial namePEC
segmentsNoNumber of segments (0=auto)
componentYesComponent name

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 full burden but only states the basic action. It does not disclose important behavioral details such as default material, coordinate system, or interaction with existing geometry.

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 very concise—one sentence—and front-loaded. However, it could be slightly 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?

For an 8-parameter tool with no output schema and no annotations, the description is too sparse. It lacks details about shape behavior, constraints (e.g., radius must be positive), and integration with other CST operations.

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 baseline is 3. The description adds no additional meaning beyond what is already in the schema parameters (e.g., radius, center coordinates, material).

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 sphere in CST Studio' clearly states the action (create) and resource (sphere). Among sibling tools, it uniquely identifies the shape, distinguishing it from other creation tools like cst_create_brick or cst_create_cylinder.

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 (e.g., other shape creation tools like cst_create_cylinder for cylindrical objects). There is no mention of prerequisites or context.

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

cst_create_temperature_dependent_materialA

Create a material with temperature-dependent electromagnetic properties. Specify base properties and temperature coefficients for thermal-electromagnetic co-simulation.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'Thermal FR-4')
epsilon_rYesRelative permittivity at reference temperature
conductivityYesElectric conductivity in S/m at reference temperature
reference_temp_cNoReference temperature in degrees Celsius
temp_coeff_conductivityNoTemperature coefficient of conductivity (fractional per K)
temp_coeff_epsilon_ppm_kNoTemperature coefficient of permittivity in ppm/K

TDQS

A4/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. It states the tool creates a material but does not disclose details about validation, side effects, or default behaviors beyond what the parameters imply. It adds moderate 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?

Two concise sentences. The first sentence states the primary purpose, and the second tells what to specify. No extraneous information, well-front-loaded.

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 detailed input schema and no output schema, the description adequately covers the tool's purpose and key usage. It could mention that it creates a new material object or the reference temperature, but overall it is complete for its 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 baseline is 3. The description only says 'Specify base properties and temperature coefficients', which adds little beyond the parameter descriptions in the schema. 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?

The description clearly states the tool creates a material with temperature-dependent electromagnetic properties, specifying base properties and temperature coefficients. It distinguishes this from sibling material creation tools by focusing on temperature dependence and thermal-electromagnetic co-simulation.

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 indicates usage for thermal-electromagnetic co-simulation and specifying base properties and coefficients. It implies when to use this tool versus generic material creation tools but does not explicitly list alternatives or when not to use it.

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

cst_create_torusB

Create a torus in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisYesTorus axis
nameYesSolid name
center_xNoCenter X coordinate
center_yNoCenter Y coordinate
center_zNoCenter Z coordinate
materialNoMaterial namePEC
componentYesComponent name
inner_radiusYesMinor radius (tube radius)
outer_radiusYesMajor radius (center to tube center)

TDQS

B3.1/5.0
Behavior2/5

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

Without annotations, the description must disclose behavioral traits, but it only states the action. It does not mention side effects, prerequisites (e.g., component existence), or error conditions.

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 single sentence is concise and front-loaded with the action. However, it lacks structure like a secondary sentence for context, but it is not 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 tool with 9 parameters and no output schema, the description is too minimal. It does not explain dependencies (e.g., component must exist), geometry constraints, or typical usage patterns.

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 (e.g., 'Minor radius (tube radius)'). The tool description adds no extra semantic value beyond the schema, earning 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 explicitly states it creates a torus, a specific geometric shape, distinguishing it from other creation tools like brick or cylinder. The verb-resource combination is clear 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?

No guidance is provided on when to use this tool versus alternatives (e.g., other shape creation tools). The description gives no context for appropriate 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.

cst_create_wireB

Create a bondwire / wire between two points in CST Studio.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesSolid name
end_xYesEnd point X
end_yYesEnd point Y
end_zYesEnd point Z
radiusYesWire radius
start_xYesStart point X
start_yYesStart point Y
start_zYesStart point Z
componentYesComponent name

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 for behavioral disclosure. It only says 'create', implying mutation, but lacks details on whether it modifies existing geometry, coordinate system units, error conditions, or side effects. This is insufficient 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 clear sentence, concise and front-loaded. However, it could include slightly more context (e.g., coordinate system) 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 schema covers all parameters and no output schema exists, the description should ideally mention what the tool returns (if anything) and when to use it among many sibling creation tools. It is minimally adequate but lacks these completions.

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 briefly described in the schema. The description adds no additional meaning beyond the schema, so 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 creates a 'bondwire / wire between two points' in CST Studio, using a specific verb and resource. It distinguishes from sibling tools that create other shapes (e.g., brick, cylinder).

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 cst_create_brick or cst_create_extrude. There is no discussion of prerequisites, coordinate systems, or when not to use it.

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

cst_delete_materialB

Delete a material from the current CST project.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName of the material to delete

TDQS

B3/5.0
Behavior2/5

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

The description states deletion but does not disclose side effects (e.g., impact on objects using the material, irreversibility). With no annotations, the description carries full burden but 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.

Conciseness3/5

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

Extremely short at one sentence, which is concise but lacks necessary details for a destructive tool. Could be considered under-specified.

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?

Simple tool with one parameter and no output schema, but description omits prerequisites, error conditions, and consequences, 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?

Schema coverage is 100% with parameter description 'Name of the material to delete'. The description adds no additional meaning beyond the schema, earning baseline 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 explicitly states the action (delete) and resource (material), with scope (current CST project). It clearly distinguishes from sibling tools like cst_create_material (create), cst_list_materials (list), etc.

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 delete, prerequisites (e.g., material must exist), or alternatives. Among many material-related siblings, no context is provided 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.

cst_delete_parameterA

Delete a design parameter from the CST project. The parameter must not be referenced by other parameters or geometry.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName of the parameter to delete.

TDQS

A4.3/5.0
Behavior4/5

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

No annotations provided, so the description carries full burden. It discloses the destructive action and the precondition about references, which is essential 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.

Conciseness5/5

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

Two concise sentences, no waste, purpose stated first. Efficient and clear.

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 simple delete operation with one parameter and no output schema, the description provides all necessary context: what it does and a critical precondition.

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 the parameter description in schema ('Name of the parameter to delete') is identical to what the tool description implies. No additional semantic value 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 'Delete' and the resource 'design parameter from the CST project'. It is specific and distinct from sibling tools like cst_delete_material or cst_delete_port.

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 includes a crucial usage condition: parameter must not be referenced by others. This implicitly guides when to use, but lacks explicit when-not-to-use or alternative tools.

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

cst_delete_portB

Delete a port by its port number.

ParametersJSON Schema
NameRequiredDescriptionDefault
port_numberYesPort number to delete (1-999)

TDQS

B3.4/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. It only states 'delete a port' without disclosing behaviors like irreversibility, permissions needed, or error handling when port doesn't exist.

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 with no wasted words. Efficiently communicates the core action.

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 operation with one parameter and no output schema, the description is largely complete. It could mention what happens if the port doesn't exist, but overall 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?

Schema coverage is 100%, and the description mirrors the parameter's schema description without adding new semantics. Baseline 3 is appropriate as no additional value is provided.

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 a port by its port number' clearly states the action (delete), resource (port), and method (by port number). It is specific and distinguishes from sibling tools like cst_add_discrete_port.

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 vs alternatives (e.g., what if multiple ports share the number, or need to delete a range). No prerequisites or post-conditions mentioned.

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

cst_delete_resultsA

Delete simulation results from the current CST project. This prevents the 'Results May Get Incompatible With Model' dialog that blocks automation when modifying a model with existing results. Call before making parameter or geometry changes on a project that has been solved.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/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 full burden. It discloses that deleting results prevents a disruptive dialog, which is a key behavioral trait. It implies destructiveness (deletion) and automation impact. More detail on persistence or side effects would push it higher, but it's sufficient for a one-action 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 extremely concise: two sentences with no wasted words. The first sentence states the action and primary effect; the second provides context. Perfectly front-loaded and efficient.

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?

Given zero parameters and no output schema, the description fully covers the tool's purpose, when to use it, and the behavioral outcome. Nothing essential is missing. The context (automation, model modification) is fully addressed.

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 schema coverage is 100% (empty object). The description doesn't need to add parameter info. Baseline 4 is appropriate as there is no information missing.

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 it deletes simulation results from the current CST project and explicitly explains the purpose: to prevent the 'Results May Get Incompatible With Model' dialog that blocks automation. It distinguishes itself from sibling delete tools (e.g., cst_delete_material, cst_delete_port) by specifying the resource and context.

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 guidance: 'Call before making parameter or geometry changes on a project that has been solved.' It tells exactly when to invoke the tool. It lacks explicit 'when not to use' or alternatives, but the context is adequately clear, earning a 4.

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

cst_design_patch_onlyB

Calculate microstrip patch dimensions only (offline, no CST). Sadece boyut hesabı — CST gerekmez.

ParametersJSON Schema
NameRequiredDescriptionDefault
epsilon_rNo
feed_typeNoinset
height_mmNo
tan_deltaNo
frequency_ghzYes

TDQS

B3.1/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. It discloses that the tool operates offline and doesn't require CST, which is a key behavioral trait. However, it doesn't state whether it's read-only, what side effects (if any) occur, or how results are returned, leaving significant gaps for a calculation 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 concise and front-loaded with the core purpose. The inclusion of a Turkish translation ('Sadece boyut hesabı — CST gerekmez') repeats the same information, which is redundant for an AI agent but not harmful; it still fits in one line.

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 lacks an output specification (what dimensions are returned, units, etc.) and does not explain parameter semantics. For a tool with 5 parameters and no output schema, it should describe the calculation scope and result format, making this definition incomplete.

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 input schema has 0% description coverage, and the tool description adds no parameter explanations. Parameters like epsilon_r, feed_type, height_mm, tan_delta, and frequency_ghz are left entirely to the schema's defaults and enum, which an agent may not interpret correctly without guidance.

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 purpose: 'Calculate microstrip patch dimensions only.' The verb 'Calculate' and the resource 'microstrip patch dimensions' are specific. The phrase 'offline, no CST' distinguishes it from sibling CST tools like cst_antenna_patch, which likely require a CST session, but it doesn't enumerate which dimensions (e.g., length, width) are computed.

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 the tool is for quick calculations without CST, but it doesn't explicitly mention alternatives or when to prefer this over cst_antenna_patch or cst_workflow_patch_antenna. The offline note gives context but no direct guidance on when not to use it.

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

cst_disconnectA

Detach this MCP session without closing CST, projects, or a running solver.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/5.0
Behavior4/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 well by disclosing what side effects are avoided (closing CST, projects, or solver). It could further mention whether the session can be resumed with cst_connect, but the key behavioral trait is adequately conveyed.

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, focused sentence with no filler. It front-loads the action and immediately clarifies the non-destructive scope, which is exactly what an agent needs.

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 parameterless, outputless tool with a clear safety profile, the description is complete. An agent can correctly invoke it without any additional context about inputs, outputs, or side effects.

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 100% schema description coverage, so the schema already fully documents the input. A baseline of 4 is appropriate; the description adds no parameter-specific information because none is 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 uses a specific verb ('Detach') and resource ('this MCP session'), and explicitly clarifies what it does NOT do ('without closing CST, projects, or a running solver'). This clearly distinguishes it from project-close and simulation-stop tools among its siblings.

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 clearly implies the use case: when the agent wants to end the MCP session but preserve the CST environment. It does not explicitly name alternatives like cst_connect or cst_close_project, but the scope is clear enough for an agent to select it appropriately.

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

cst_discover_farfield_monitorsB

Discover farfield monitors from the project Result folder and tree-path heuristics. Uzak alan monitörlerini disk + path sezgisiyle listeler.

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. It discloses the mechanism (Result folder and tree-path heuristics) and the action (list), but it does not state whether the operation is read-only, whether the project must be open, or what the return format is. The Turkish sentence reinforces the listing behavior but adds no new behavioral details.

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 English sentence is concise and informative, front-loading the main action. However, the Turkish sentence duplicates the meaning without adding unique value, making the description redundant. The overall length is short, but not 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?

For a simple tool with no parameters and no output schema, the description is adequate but not fully complete. It does not mention prerequisites (e.g., project must be open or farfield monitors must already exist), nor does it specify the exact return shape (e.g., list of names or IDs). An agent may need to rely on the tool name or additional context to understand the output.

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 reflects that with 100% coverage. The description does not need to explain any parameters; it correctly focuses on the tool's action. Baseline of 4 applies for parameterless tools.

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 states a specific verb ('Discover') and resource ('farfield monitors') with an explicit source ('project Result folder and tree-path heuristics'). It is clear enough to distinguish from sibling tools like cst_list_results or cst_get_farfield, though it does not explicitly name an alternative.

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?

There is no explicit guidance on when to use this tool versus alternatives such as cst_list_results or cst_list_saved_results. The context of discovering farfield monitors implies its use, but no exclusions or alternative routing are provided, so usage is only implied.

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

cst_dismiss_dialogsA

Find and dismiss any visible CST dialog windows (error popups, 'Results Incompatible' dialogs, solver warnings). Returns the title and text content of each dialog before dismissing it. Use this to unblock CST when a modal dialog is preventing further automation. Uses Win32 API on Windows.

ParametersJSON Schema
NameRequiredDescriptionDefault
read_onlyNoIf true, only read dialog content without dismissing. Default: false (read and dismiss).

TDQS

A4.6/5.0
Behavior4/5

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

Even without annotations, the description discloses key behaviors: it finds and dismisses dialogs, returns title and text, supports a read-only mode, and uses Win32 API on Windows. This is transparent about its functionality and platform dependency.

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 three tight sentences covering action, output, and usage context. Every sentence adds essential information with no redundancy.

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?

Given the tool's simplicity (one optional parameter, no output schema), the description fully covers the tool's purpose, behavior, and usage context. There are no obvious gaps.

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?

The only parameter (read_only) is described clearly with its meaning and default: 'If true, only read dialog content without dismissing. Default: false (read and dismiss).' This adds value beyond the schema's basic type/default.

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 finds and dismisses visible CST dialog windows, listing specific examples (error popups, 'Results Incompatible', solver warnings) and noting it returns title/text before dismissing. This distinguishes it from siblings that focus on modeling, simulation, or project management tasks.

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 says 'Use this to unblock CST when a modal dialog is preventing further automation.' This provides a clear use case. It does not mention when not to use or mention alternatives, but the specialized nature makes the guidance sufficient.

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

cst_evaluate_antennaA

Evaluate current antenna simulation results against performance goals. Exports S-parameter data and checks VSWR (or return loss) against per-band targets. Read-only — does not modify the model. Returns pass/fail per band, worst VSWR, and detected resonances.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNoPort number for S-parameter (default: 1).
bandsYesFrequency bands to evaluate.

TDQS

A4.2/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 full burden. It explicitly states read-only, does not modify the model, exports S-parameter data, and returns pass/fail, worst VSWR, and resonances. However, 'exports S-parameter data' could imply writing to disk, which may be a side effect not fully clarified.

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?

Three concise sentences, front-loaded with purpose. No unnecessary words. Each sentence adds value.

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 no output schema, the description adequately covers inputs, behavior, and outputs. It could be more specific about the return format, but overall it provides sufficient context for an agent to understand the tool's function.

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 parameters are well-documented in the schema. The description adds minimal extra meaning beyond stating targets per band, which aligns with the vswr_target field. 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 evaluates antenna simulation results against performance goals, specifically checking VSWR or return loss per band. It distinguishes itself from sibling tools like cst_get_vswr or cst_get_s_parameters by combining multiple evaluations and providing a pass/fail summary.

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 for use (after simulation, read-only) but does not explicitly mention when not to use or suggest alternatives among the many sibling tools for specific metrics.

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

cst_execute_vbaA

Execute raw VBA code in CST Studio Suite. The code is validated for safety (shell access, file I/O, and external process execution are blocked). In connected mode the code runs directly; in offline mode the validated script is returned for manual execution.

ParametersJSON Schema
NameRequiredDescriptionDefault
codeYesVBA code to execute in CST Studio. Must not contain shell commands, file I/O, or external process calls.

TDQS

A4.4/5.0
Behavior4/5

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

Without annotations, the description carries the full burden. It discloses safety blocks (shell access, file I/O, external processes) and explains behavior differences between connected and offline modes. It does not cover error handling or return values, but the main behavioral aspects are addressed.

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 purpose, and each sentence adds necessary detail without redundancy. It is efficient 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 simple parameter set and absence of output schema, the description covers key aspects: purpose, safety, and modes. It lacks information about return value or side effects like project modifications, but is otherwise complete for a single-parameter 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?

Schema coverage is 100%, but the description adds value by specifying that the code must not contain dangerous operations, supplementing the schema's 'VBA code to execute.' This provides practical guidance 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 'Execute raw VBA code in CST Studio Suite,' with a specific verb and resource. It distinguishes itself from sibling tools by mentioning safety validation and two execution modes, making the 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 explains when to use the tool (to execute VBA code) and provides context about connected vs. offline modes. However, it does not explicitly state when not to use it or compare with alternatives like cst_vba_help or cst_list_vba_objects, which would further clarify usage boundaries.

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

cst_export_cadA

Export the current CST model (or a specific component) to a CAD format. Supports STL, SAT/ACIS, STEP, IGES, OBJ, and NASTRAN.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatYesExport format: stl, sat, stp (STEP), igs (IGES), obj, nas (NASTRAN).
componentNoOptional component name to export. If omitted, the entire model is exported.
file_pathYesDestination file path for the exported CAD file.

TDQS

A4.2/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 full burden. It mentions exporting the 'current model' or a specific component and lists formats, but does not disclose behavior like file overwrite rules, authentication needs, or any side effects. Acceptable for a simple export but missing some details.

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 sentences, no unnecessary words, all information is relevant and front-loaded.

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 output schema and no annotations, the description adequately covers purpose, parameters, and scope. It lacks information on error behavior (e.g., file overwrite) but is sufficient for selection and basic usage.

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% with descriptions for each parameter. The description adds context beyond the schema by clarifying 'current model (or a specific component)' and listing formats, which complements the enum values.

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 'Export' and the resource 'the current CST model (or a specific component)' to CAD formats. It lists supported formats, which distinguishes it from sibling export tools like cst_export_farfield or cst_export_touchstone.

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 when to use (exporting a model or component to CAD) and lists formats, but does not explicitly mention when not to use or alternatives. The context is clear given sibling names, but lacks explicit exclusions.

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

cst_export_farfieldA

Export far-field radiation pattern data to a file. Requires a completed simulation with far-field monitor results.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoExport format: csv (comma-separated), ffs (CST far-field source), nsf (NSI near-to-far-field).csv
file_pathYesDestination file path for the far-field data.
frequencyYesFrequency in GHz for the far-field data to export.

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 burden. It discloses the prerequisite but lacks details about file overwrite behavior, side effects (e.g., creation of file), or performance impact. The format information is in the schema, so the description is minimally 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?

Two concise sentences with no unnecessary words. The purpose is front-loaded, and the structure is efficient.

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 provides the prerequisite but does not explain the output (file creation success), file handling behavior (overwrite, path requirements), or how this tool fits into a workflow relative to siblings like cst_get_farfield. Adequate but 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?

Schema description coverage is 100%; each parameter is already well-described. The tool description does not add meaning beyond repeating 'far-field radiation pattern data,' so it does not improve understanding.

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 'Export' and the resource 'far-field radiation pattern data to a file', which is specific and distinct from sibling export tools (e.g., cst_export_cad, cst_export_touchstone) and getter tools (e.g., cst_get_farfield).

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 a clear prerequisite: 'Requires a completed simulation with far-field monitor results,' which guides when to use the tool. It does not explicitly mention alternatives or when not to use it, but the condition is helpful.

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

cst_export_projectA

Export the current CST project or its geometry to another format such as STL, STEP, IGES, SAT, OBJ, or NASTRAN.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesDestination file path for the exported file.
formatYesExport format. One of: stl, sat, stp, igs, obj, nas.

TDQS

A3.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 must disclose side effects. It mentions exporting but does not specify whether it overwrites existing files, requires an open project, or any other behavioral traits. More detail is needed 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?

Single sentence, concise, front-loaded with the main action. Every word is necessary and information-dense.

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?

Adequate for a simple export tool with two required parameters. Mentions that it exports the 'current' project, which is contextual. However, lacks details on file overwrite behavior or path requirements (e.g., extension).

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 baseline is 3. The description adds a list of example formats, but these are already enumerated in the schema enum. No additional semantic 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?

Clearly states the action 'Export', the resource 'current CST project or its geometry', and lists example formats. This distinguishes it from sibling export tools like cst_export_farfield and cst_export_result.

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?

Implicitly suggests use when exporting geometry or project to the listed formats, but no explicit guidance on when to use this versus alternatives like cst_export_cad or cst_export_touchstone.

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

cst_export_resultA

Export a simulation result to a file (CSV, Touchstone, or text). Specify the result tree path and desired output format. Useful for post-processing results in external tools like MATLAB or Python.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoExport file format. 'csv' for comma-separated values, 'touchstone' for Touchstone/SnP format (S-parameters only), 'txt' for space-separated text.csv
output_fileYesFull file path for the exported file.
result_pathYesCST result tree path to export, e.g. '1D Results\S-Parameters\S1,1' or 'Farfields\farfield (f=2.45)'.

TDQS

A3.5/5.0
Behavior2/5

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

Without annotations, the description carries the full burden of behavioral disclosure. It omits details such as whether the operation is read-only, if it overwrites existing files, or any prerequisites (e.g., a prior simulation must exist). The description only states the action and formats.

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 concise with two sentences. The first sentence states the core function, and the second provides a use case. No unnecessary words 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?

For a simple export tool with three well-documented parameters, the description is adequate but not rich. It does not explain the scope of results (e.g., 1D Results, Farfields) beyond what the schema implies, nor does it contrast with specialized export siblings. A complete description would mention the types of results exportable.

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 already documents all parameters and their descriptions. The tool description adds no new semantic information beyond indicating that result path and output format are involved. 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's purpose with a specific verb ('Export'), resource ('simulation result'), and supported formats ('CSV, Touchstone, or text'). It differentiates from sibling tools like cst_export_farfield and cst_export_touchstone by being the general-purpose export 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 mentions a use case ('post-processing results in external tools like MATLAB or Python') but does not provide explicit guidance on when to use this tool versus the specialized export siblings (e.g., cst_export_touchstone). No exclusions or alternative recommendations are given.

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

cst_export_structure_viewsA

Export structure screenshots (perspective/xy/xz/yz) via Plot.ExportImage. Yapı görünüm görsellerini dışa aktarır. Connected mode required.

ParametersJSON Schema
NameRequiredDescriptionDefault
viewsNoSubset of: perspective, xy, xz, yz
widthNo
heightNo
out_dirNoOutput folder (default: work_dir/exports/views)

TDQS

A3.5/5.0
Behavior3/5

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

Since no annotations are provided, the description carries the behavioral disclosure burden. It usefully discloses the connected-mode requirement and names the underlying Plot.ExportImage API, but it does not explain side effects such as file creation, output naming, directory creation, or whether an active project must be open.

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 English first sentence is specific and front-loaded, but the Turkish sentence is a direct duplicate of the same meaning and does not add information. The passage is compact overall, yet the redundant sentence prevents it from being highly polished.

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 definition captures the core action, available views, and connected-mode requirement, and the schema provides defaults and the default output directory. Missing pieces include the output file format, behavior when views are omitted, and any project state expectations, so it is adequate but not 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 50%, but the remaining parameters are simple and intuitive. The description essentially restates the views list already documented in the schema ('perspective/xy/xz/yz'), adds no meaning for width/height/out_dir, and relies on default values and schema text to carry the rest.

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 ('Export structure screenshots') and narrows scope to perspective/xy/xz/yz views via Plot. It is clearly distinct from sibling exports like cst_export_cad, cst_export_result, and cst_export_farfield. Even without opening the schema, an agent can tell what this 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 description implies its use case: use it when structure view screenshots are needed rather than geometry/data files, and it notes the operational prerequisite 'Connected mode required'. However, there is no explicit when-to-use or when-not-to-use guidance and no named alternatives.

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

cst_export_touchstoneA

Export S-parameter simulation results to a Touchstone file. Requires a completed simulation with S-parameter data.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoTouchstone format: s1p (1-port), s2p (2-port), snp (n-port).s2p
file_pathYesDestination file path for the Touchstone file.

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 bears the full burden of behavioral disclosure. It only states the basic action and a prerequisite, omitting details such as whether the tool overwrites existing files, handles errors, or returns any status indication. 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 extremely concise, with only two sentences: one for purpose and one for prerequisite. No redundant words or information, making it efficient for an agent 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 tool has no output schema, and the description does not mention return values, error conditions, or success indication. While the core action and prerequisites are covered, the lack of error/return context leaves the agent without complete guidance for handling the operation's outcome.

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 describes both parameters with 100% coverage (format enum with descriptions, file_path description). The description adds minimal semantic value beyond restating the purpose; it does not clarify parameter usage or constraints 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 specifies the verb 'Export', the resource 'S-parameter simulation results', and the target format 'Touchstone file'. It distinguishes itself from sibling export tools like cst_export_cad, cst_export_farfield, and cst_export_result by focusing specifically on S-parameter data and Touchstone format.

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 states a prerequisite ('Requires a completed simulation with S-parameter data'), providing clear context for when to use the tool. However, it does not explicitly list when not to use it or suggest alternatives among sibling export tools.

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

cst_get_axial_ratioA

Extract axial ratio for circularly polarized antennas from a completed CST simulation. Axial ratio (AR) indicates the quality of circular polarization: AR=0 dB is perfect CP, AR<3 dB is acceptable. Can plot AR vs angle or vs frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
modeNo'vs_angle' to plot AR vs theta at fixed frequency, 'vs_frequency' to plot AR vs frequency at fixed angle.vs_angle
phi_cutNoPhi angle (degrees) for the observation direction.
frequencyYesFrequency in GHz at which to extract axial ratio.
theta_cutNoTheta angle (degrees) for the observation direction.

TDQS

A4.4/5.0
Behavior4/5

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

With no annotations, the description carries the full burden. It correctly implies a read-only operation after simulation (no mention of state changes) and adds interpretive context (thresholds). It does not disclose output format (e.g., data vs plot), but the mention of 'plot' suggests visualization.

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 sentences, no filler. The first sentence states the core purpose; the second provides context and options. Every word serves a purpose.

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 specificity and the absence of an output schema, the description covers prerequisites (completed simulation), key parameters, and output interpretation. It could mention the need for farfield results or return format, but it remains sufficient for typical use.

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 description coverage is 100%, but the description adds value beyond it: explaining what axial ratio means, when to use each mode (vs_angle vs vs_frequency), and the significance of thresholds. This helps the agent understand parameter choices.

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 extracts axial ratio from completed CST simulations, defines its meaning (CP quality) with thresholds (0 dB perfect, <3 dB acceptable), and distinguishes between plotting vs angle or frequency. This differentiates it from siblings like cst_get_gain or cst_get_farfield.

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 states 'from a completed CST simulation,' indicating post-simulation use. It does not explain when not to use or list alternatives, but the context of sibling tools and the specific function (axial ratio extraction) makes usage clear.

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

cst_get_bandwidthA

Calculate impedance bandwidth from S-parameter results. Finds the frequency range where S11 (or VSWR) meets the specified threshold. Returns center frequency, bandwidth in MHz, and fractional bandwidth percentage.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNoPort number to compute bandwidth for.
run_idNo
criterionNo'S11' to use return loss threshold, 'VSWR' to use VSWR threshold.S11
max_pointsNoPreview sample count; 0 returns the full curve. Derived metrics use all samples.
threshold_dbNoS11 threshold in dB for bandwidth computation. Common values: -10 dB (VSWR 2:1), -6 dB (VSWR 3:1), -15 dB (VSWR 1.4:1).

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 carries the full burden of behavioral disclosure. It does state what the tool returns (center frequency, bandwidth, fractional bandwidth) and mentions the threshold criterion. However, it omits important behavioral details such as whether a simulation must have been run, how results are stored, or error conditions. The description is transparent about the output but lacks depth on prerequisites and 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 two sentences, front-loading the primary purpose and then detailing the computation and outputs. There is no redundancy or filler. Every sentence contributes to understanding, making it highly efficient 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?

The description is fairly complete for a simple compute tool. It clearly lists the return values, which is crucial since there is no output schema. It could be improved by noting that it operates on existing S-parameter results and possibly the units for center frequency (implied but not explicit). However, given the simplicity and the context from sibling tools, it is adequately 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 80% (4 out of 5 parameters have descriptions), so the schema already provides most parameter meaning. The description adds minimal extra value: it mentions threshold and S11/VSWR but doesn't elaborate on parameter semantics beyond the schema. The baseline of 3 is appropriate since the schema does the heavy lifting.

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: calculating impedance bandwidth from S-parameter results. It specifies the method (finding frequency range where S11 or VSWR meets threshold) and the output (center frequency, bandwidth in MHz, fractional bandwidth). This is distinct from sibling tools like cst_get_s_parameters or cst_get_vswr, making its function 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 does not provide any guidance on when to use this tool versus alternatives. It does not mention prerequisites (e.g., simulation must be run, S-parameters must exist) nor does it suggest when to choose a different tool (e.g., cst_get_s_parameters for raw data). Usage context is only implied, not explicit.

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

cst_get_cross_polarizationA

Extract cross-polarization level and cross-polarization discrimination (XPD) from a completed CST simulation. Supports Ludwig-3, Ludwig-2, and circular polarization definitions. Requires a farfield monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequencyYesFrequency in GHz at which to extract cross-polarization.
definitionNoPolarization definition to use. 'Ludwig3' is the most common for linear polarization, 'Ludwig2' for aperture antennas, 'circular' for CP antennas.Ludwig3

TDQS

A3.7/5.0
Behavior3/5

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

No annotations are provided, so the description must cover behavioral traits. It mentions the prerequisite (farfield monitor) and supported definitions but does not disclose whether the tool is read-only, what happens if the monitor is missing, or any side effects. The return format and units are also omitted.

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-loading the purpose and outcome. It is concise, with no unnecessary words or repetition. Every sentence adds value.

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 no output schema, the description should hint at return values. It mentions extracting cross-polarization level and XPD but not the format or structure (e.g., dict, numeric values). The prerequisite is clear, but return details are missing, which is a gap for a data extraction 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 coverage is 100%, so the schema already describes both parameters. The description adds value by stating the prerequisite that frequency must correspond to an existing farfield monitor, but does not enhance parameter meaning beyond the schema's 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 clearly states the tool extracts cross-polarization level and XPD from a completed CST simulation. It specifies supported polarization definitions and the prerequisite of a farfield monitor. This distinguishes it from sibling tools like cst_get_gain or cst_get_axial_ratio.

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 (completed simulation, farfield monitor required) but does not explicitly state when to use this tool versus alternatives like cst_get_axial_ratio or cst_get_farfield. No 'when not to use' guidance is provided.

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

cst_get_current_distributionA

Extract volume current distribution from a completed CST simulation at a specific frequency. Complements surface current extraction by providing current density inside dielectric or lossy volumes. Requires a current density monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
componentNoOptional: specific component to extract current for. If omitted, extracts for all components.
frequencyYesFrequency in GHz at which to extract current distribution.

TDQS

A3.9/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 mentions the prerequisite (monitor at frequency) and that it works on completed simulations, but does not disclose other behavioral traits like potential performance impact, data format, or error conditions.

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, concise and front-loaded. The first sentence immediately states the core purpose and scope, the second adds context. No unnecessary 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?

The description covers prerequisites and complementarity but lacks information about the return value (format/structure). Given no output schema, an AI agent might need to know what 'extract volume current distribution' returns (e.g., vector field data). Adequate but missing output 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?

Input schema has 100% description coverage for both parameters (frequency, component). The description adds minimal extra meaning beyond the schema, only restating the requirement for a current density monitor at the specified frequency. 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 extracts volume current distribution from a completed CST simulation at a specific frequency. It explicitly distinguishes itself from surface current extraction by mentioning 'volume' and 'inside dielectric or lossy volumes', which differentiates it from sibling cst_get_surface_current.

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?

It provides a clear prerequisite ('requires a current density monitor at the specified frequency') and positions itself as complementary to surface current extraction. However, it does not explicitly state when not to use it or name alternatives beyond the surface current sibling.

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

cst_get_efficiencyA

Get antenna radiation efficiency from a completed CST simulation at a specific frequency. Returns total efficiency (including mismatch), radiation efficiency (excluding mismatch), and mismatch loss in dB.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequencyYesFrequency in GHz at which to extract efficiency.

TDQS

A3.8/5.0
Behavior3/5

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

No annotations are provided. The description mentions 'from a completed CST simulation,' implying a prerequisite. However, it does not disclose if the operation is read-only, any side effects, or required permissions. The behavioral disclosure is minimal but consistent with a getter 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, front-loaded with the main action, and contains no extraneous information. Every word earns its place. It is optimally concise for a simple tool.

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, no nested objects), the description is fairly complete. It specifies the source (completed CST simulation), the frequency input, and the three output metrics. It could mention that the tool is read-only, but overall it provides adequate context for 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 coverage is 100% (one parameter with description). The description says 'at a specific frequency,' which aligns with the schema's description of 'Frequency in GHz at which to extract efficiency.' The description adds context about the returned values but does not significantly enhance parameter understanding 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's purpose: 'Get antenna radiation efficiency from a completed CST simulation at a specific frequency.' It specifies the verb (Get), resource (antenna radiation efficiency), and details the returned values (total efficiency, radiation efficiency, mismatch loss). This provides strong purpose 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 does not explicitly state when to use this tool versus alternatives like cst_get_efficiency_breakdown. It implies usage after a completed simulation but lacks guidance on choosing between efficiency-related siblings. This is a moderate gap.

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

cst_get_efficiency_breakdownA

Get a detailed efficiency breakdown with loss budget from a completed CST simulation. Returns radiation efficiency, total efficiency, and individual loss contributions (mismatch, conductor, dielectric). Useful for identifying dominant loss mechanisms in antenna designs.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequencyYesFrequency in GHz at which to extract efficiency breakdown.

TDQS

A4/5.0
Behavior4/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 that the tool returns detailed efficiency data including loss contributions, and implies a read-only operation. It does not describe error conditions but provides sufficient behavioral context for typical 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 two sentences with no wasted words. The first sentence front-loads the purpose and output, and the second adds use-case context. Every sentence is informative.

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 one parameter, no output schema, and no annotations, the description provides adequate context: it names the outputs and use case. It could mention that the simulation must be completed, which is implied. Lacks details on output format but still fairly 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?

There is only one parameter (frequency) with full schema coverage. The description does not add meaning beyond the schema's 'Frequency in GHz at which to extract efficiency breakdown.' 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 purpose: 'Get a detailed efficiency breakdown with loss budget from a completed CST simulation.' It specifies the output (radiation efficiency, total efficiency, individual loss contributions) and distinguishes itself from sibling tools like cst_get_efficiency by emphasizing detail and loss budget.

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 mentions it is 'useful for identifying dominant loss mechanisms in antenna designs' but does not explicitly state when to use this tool versus alternatives (e.g., cst_get_efficiency for simpler efficiency). It implies a prerequisite (completed simulation) but does not explicitly exclude non-completed cases.

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

cst_get_farfieldA

Get far-field radiation pattern results from a completed CST simulation at a specific frequency. Returns gain, directivity, radiation efficiency, and beam widths. Requires a farfield monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequencyYesFrequency in GHz at which to extract the far-field pattern.
monitor_nameNoName of the far-field monitor. If omitted, defaults to 'farfield (f=<frequency>)' which is the CST auto-generated name.

TDQS

A4.2/5.0
Behavior3/5

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

No annotations provided; description discloses the prerequisite and that it reads completed results. Does not mention error handling, performance, or that it is non-destructive. Acceptable but not exhaustive.

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 focused sentences: first states action and outputs, second states prerequisite. No wasted words, front-loaded.

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?

With no output schema, description lists returned items but not format. For a read tool with simple parameters, this is nearly complete. Could specify that results are numeric arrays or scalar, but the listed items imply scalar values.

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 covers both parameters with descriptions. Description adds meaning: frequency unit (GHz), monitor default naming convention, and condition that a monitor must exist. Adds value beyond 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?

Clearly states 'Get far-field radiation pattern results' with specific outputs (gain, directivity, efficiency, beam widths). Distinct from sibling tools like cst_get_gain or cst_get_radiation_pattern_3d by summarizing all far-field metrics.

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?

Explicit prerequisite: 'Requires a farfield monitor at the specified frequency.' Does not list when not to use or alternative tools, but the condition is helpful.

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

cst_get_farfield_metricsA

Read antenna metrics after a solve: S11 + radiation/total efficiency from 1D Results, plus max realized gain via official FarfieldPlot.GetMax (SelectTreeItem Farfields\farfield (f=X) [1] → Plot → GetMax). Does NOT use ASCIIExportSummary (that API spams Message on CST 2026). Solve sonrası S11, verimlilik ve max gain; GUI farfield ile uyumlu.

ParametersJSON Schema
NameRequiredDescriptionDefault
monitor_nameNoOptional exact monitor label, e.g. farfield (f=2.4) [1]
frequency_ghzNoDesign frequency in GHz (for nearest efficiency sample)
try_farfield_plotNoIf true (default), also run FarfieldPlot.GetMax for peak realized gain. Set false for 1D-only metrics.

TDQS

A3.8/5.0
Behavior4/5

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

With no annotations, the description must disclose behavioral traits. It does disclose that it uses FarfieldPlot.GetMax for gain, avoids ASCIIExportSummary (which spams messages), and is compatible with GUI farfield. It also implies read-only behavior ('Read'). However, it does not mention side effects, error handling, or what happens if no solve exists or monitor_name is incorrect.

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 redundant: it includes both English and Turkish versions of essentially the same information ('Solve sonrası S11, verimlilik ve max gain; GUI farfield ile uyumlu.'). This duplication adds length without value. The structure is front-loaded with the purpose, but the translation bloat makes it less concise than it could be.

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 what metrics are returned (S11, efficiency, gain) and mentions the frequency parameter for efficiency sampling. However, it does not specify the return format (e.g., dict, list) or units, which is critical given there is no output schema. It also lacks information about error handling or prerequisites beyond 'after a solve.' It is adequate but leaves 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?

The schema provides 100% coverage for all three parameters, each with a clear description (monitor_name format, frequency purpose, try_farfield_plot behavior). The description adds no additional parameter-level semantics beyond what the schema already states. Since schema coverage is high, 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 tool's purpose: 'Read antenna metrics after a solve: S11 + radiation/total efficiency from 1D Results, plus max realized gain via official FarfieldPlot.GetMax.' It specifies the exact resource (1D Results, farfield) and the method, which distinguishes it from siblings like cst_get_farfield or cst_get_gain. The mention of the specific API (FarfieldPlot.GetMax) and the avoidance of ASCIIExportSummary further differentiates it.

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?

It implies usage after a solve ('after a solve') and provides a caveat about ASCIIExportSummary on CST 2026, which hints at an alternative. It also notes compatibility with GUI farfield. However, it does not explicitly say when to use this combined tool versus separate tools like cst_get_s_parameters or cst_get_efficiency, nor does it state exclusions.

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

cst_get_gainA

Get antenna gain at a specific frequency from a completed CST simulation. Returns peak gain in dBi and the direction (theta, phi) of maximum gain. Requires a farfield monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequencyYesFrequency in GHz at which to extract gain.

TDQS

A4/5.0
Behavior4/5

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

Given no annotations, the description effectively discloses key behaviors: it reads gain from a completed simulation, requires a farfield monitor, and returns peak gain and direction. It is transparent about prerequisites and outputs, but does not mention potential errors if the monitor is missing.

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 three sentences with no fluff: first sentence states purpose, second describes return, third gives a requirement. It is front-loaded and efficient, earning its keep.

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 tool with one parameter and no output schema, the description sufficiently covers purpose, return value, and prerequisites. However, it could add clarity about the need for an exact frequency match to the farfield monitor and what happens if the monitor 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 schema already describes the frequency parameter with complete coverage (100%). The tool description adds minimal value by stating 'at a specific frequency' and relating it to the output, but does not provide additional validation or format guidance 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 verb 'Get' and resource 'antenna gain' with specific conditions: 'from a completed CST simulation' and 'at a specific frequency'. It also specifies the output (peak gain in dBi and direction), distinguishing it from siblings like cst_get_efficiency or cst_get_bandwidth.

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 mentions the prerequisite of a farfield monitor, implying when not to use, but provides no explicit guidance on when to use this tool versus alternatives like cst_get_farfield or cst_get_radiation_pattern_3d. It lacks exclusionary context.

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

cst_get_group_delayA

Compute group delay from S-parameter phase for a port pair. Group delay is defined as tau = -d(phase)/d(2pif) and represents the signal propagation delay through the device. Useful for UWB antenna and filter characterization.

ParametersJSON Schema
NameRequiredDescriptionDefault
run_idNo
port_inNoInput port number (excitation port).
port_outNoOutput port number (observation port).
max_pointsNoPreview sample count; 0 returns the full curve. Derived metrics use all samples.

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. It explains the mathematical definition and intended use, but does not disclose output shape, prerequisites such as needing prior S-parameter results, units, or whether the tool is strictly read-only.

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?

Three concise sentences: what it computes, the formal definition, and a relevant use case. No filler or repeated schema content; the formula earns its place as behavioral clarification.

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 computation tool, the description plus schema is mostly sufficient, but with no output schema it should clarify what the caller receives (curve vs single value, units, relationship to max_points). It also does not mention preconditions such as existing simulation 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?

Schema description coverage is 75%, with port_in and port_out already described and max_points partially described. The description adds no direct parameter details, but the schema handles most semantics; run_id remains undocumented in both places.

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 ('Compute') and names a precise resource ('group delay from S-parameter phase for a port pair'). It clearly differentiates this tool from siblings like cst_get_s_parameter_phase or cst_get_vswr by identifying the derived quantity and its source.

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 provides a domain context ('Useful for UWB antenna and filter characterization'), which implies when this metric matters. However, it does not explicitly compare with alternatives or state when NOT to use this tool, leaving the agent to infer selection criteria.

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

cst_get_impedanceA

Get input impedance (Z-parameters) for a port from a completed CST simulation. Returns real and imaginary impedance vs frequency. Useful for matching network design and feed optimization.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNoPort number to extract impedance for.

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 behavioral traits such as prerequisites (simulation must be completed), limitations (one port at a time), or output format beyond 'real and imaginary impedance vs frequency'.

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?

Three concise sentences, front-loaded with the main action, each sentence serves a distinct purpose: action, output, use case. 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?

Adequate for a simple tool with full schema coverage, but missing preconditions (simulation must be completed, port must exist) and output details. With no annotations, slightly more context 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?

Schema description already covers the single 'port' parameter. The description adds value by noting the output type but does not add extra semantic meaning for the parameter. Baseline 3 due to 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?

Clearly states it gets input impedance (Z-parameters) for a port from a completed CST simulation. Distinct from sibling tools like cst_get_s_parameters and cst_get_vswr.

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?

Implies usage for matching network design and feed optimization but does not explicitly state when to use this tool vs alternatives like cst_analyze_impedance or cst_impedance_smith_transform.

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

cst_get_material_infoA

Get electromagnetic properties of a material from the bundled database. Returns epsilon_r, mu_r, conductivity, loss tangent, and usage notes.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesMaterial name (e.g. 'Copper', 'FR-4', 'Rogers RO4003C')

TDQS

A4/5.0
Behavior4/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. It states what is returned (epsilon_r, mu_r, etc.) and implies a read-only operation via 'get'. However, it does not explicitly confirm it is non-destructive, requires no project context, or handles errors. Still, the verb and output specification provide good 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 two sentences, front-loaded with the action verb, and every sentence adds value. No unnecessary 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?

Given the simplicity (1 param, no output schema), the description covers the primary purpose and return values. It could mention whether it works independently of an open project or the behavior for invalid material names, but it is mostly 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 coverage is 100% with a clear parameter description and examples. The tool description adds context about the return values but does not enhance the parameter semantics beyond what the schema provides. 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 gets electromagnetic properties of a material from the bundled database, which is a specific verb-resource combination. It distinguishes itself from siblings like cst_list_materials (which lists names) and cst_create_material (which creates new materials) by focusing on retrieving properties.

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 properties of built-in materials but does not explicitly state when to use this tool versus alternatives like cst_list_materials or cst_load_material. No guidance on prerequisites or when not to use.

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

cst_get_mesh_infoB

Get current mesh statistics and settings. In connected mode this queries the live mesh data; in offline mode it returns the VBA to retrieve mesh info.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.4/5.0
Behavior3/5

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

Discloses mode-dependent behavior (connected vs offline) which is important. With no annotations, description carries full burden; it does not mention read-only nature, authorization needs, or performance implications, which are minor 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?

Two concise sentences, no wasted words. Action stated upfront, mode clarification in second sentence. Perfectly 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?

Adequate for a zero-parameter tool, but lacking output schema or detailed description of returned data (e.g., types of statistics). Could be more complete by listing example outputs.

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?

No parameters; baseline is 4 per rules. Description adds meaning by explaining what is returned in each mode, fulfilling the requirement for zero-parameter tools.

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 clearly states 'Get current mesh statistics and settings', specifying the resource and action. It distinguishes between connected and offline modes, adding precision. However, it could more explicitly differentiate from sibling tools like cst_get_mesh_quality.

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. The mode description hints at context, but does not mention when to prefer this over cst_get_mesh_quality or other mesh tools.

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

cst_get_mesh_qualityA

Extract mesh quality metrics including total cells, aspect ratios, and cells per wavelength. In connected mode this queries actual mesh statistics; in offline mode it describes what metrics would be returned.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/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 two behavioral modes (connected queries real data, offline describes expected metrics), but does not state whether this is a read-only operation, any side effects, or authentication requirements. The disclosure is moderate.

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?

Two sentences, front-loaded with key capabilities, no redundant information. Could be slightly more specific about return format, but overall efficient.

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 tool's purpose and two modes, but lacks details about output structure or what exactly 'mesh quality metrics' include beyond the examples. Given no output schema, more specificity would be beneficial for completeness.

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 (schema coverage 100% with empty properties), so the baseline is 4. The description adds no parameter information, but none is needed.

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 extracts mesh quality metrics (total cells, aspect ratios, cells per wavelength), with a specific verb and resource. However, it does not differentiate from a similar sibling tool, cst_get_mesh_info, which could cause confusion.

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 differentiates connected vs offline mode, providing some context for when each mode applies. However, it offers no guidance on when to use this tool versus alternatives like cst_get_mesh_info, and no exclusions or prerequisites.

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

cst_get_parameterA

Get the current value of a design parameter. Returns both the stored expression and the evaluated numeric value.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName of the parameter to retrieve.

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 partially carries the burden. It discloses the return format (expression and numeric value) but omits behaviors like error handling or read-only nature.

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 concise sentences, front-loaded with the purpose. Every word adds value; no 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?

Given the tool's simplicity and no output schema, the description adequately explains the return values (expression and numeric value). Minor omission: no mention of error behavior when parameter 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?

The input schema already describes the 'name' parameter (coverage 100%). The description adds no additional meaning 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 verb ('Get') and resource ('current value of a design parameter'). It distinguishes from sibling tools like 'cst_list_parameters' (which lists all) and 'cst_set_parameter' (which sets).

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 a specific parameter's value, but it does not explicitly state when to use this tool versus alternatives like 'cst_list_parameters' or handle error cases.

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

cst_get_pattern_cutA

Extract an E-plane, H-plane, or custom radiation pattern cut from a completed CST simulation at a specific frequency. Returns gain vs angle for the selected plane. Requires a farfield monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
planeNoPattern cut plane. 'E' for E-plane (phi=0), 'H' for H-plane (phi=90), 'custom' for arbitrary cut.E
phi_cutNoPhi angle (degrees) for custom plane cut. Only used when plane='custom'. Default 0.
frequencyYesFrequency in GHz at which to extract the pattern cut.
theta_cutNoTheta angle (degrees) for custom plane cut. Only used when plane='custom'. Default 90.

TDQS

A4.3/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 full burden. It states the tool extracts data from a 'completed' simulation (implying non-modifying), returns 'gain vs angle', and requires a farfield monitor. This gives good behavioral context, though it could explicitly state it is read-only.

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?

Three short sentences: action, return type, prerequisite. No wasted words. Every sentence is necessary and front-loaded.

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 tool with no output schema, the description adequately explains the return ('gain vs angle') and the prerequisite. Given the tool's simplicity (extracting a pattern cut), the description covers all needed context for an AI 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%, so baseline is 3. The description adds the prerequisite requirement but does not significantly augment the parameter meanings already in the schema. For example, the schema already explains that plane='E' corresponds to phi=0. Thus, minimal added 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 clearly states the tool extracts an E-plane, H-plane, or custom radiation pattern cut from a completed CST simulation at a specific frequency. It distinguishes itself from siblings like cst_get_farfield (which likely returns full 3D) by specifying it is a 'cut', i.e., a 2D slice.

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 a clear prerequisite: requires a farfield monitor at the specified frequency. It implicitly suggests use for 2D pattern cuts, but does not explicitly state when not to use it (e.g., for 3D patterns) or mention alternative tools.

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

cst_get_radiation_pattern_3dA

Export full 3D radiation pattern data from a completed CST simulation at a specific frequency. Returns gain values over the full sphere in spherical or Cartesian coordinates. Useful for antenna pattern visualization and integration with external tools. Requires a farfield monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
frequencyYesFrequency in GHz at which to extract the 3D pattern.
coordinateNo'spherical' for (theta, phi, gain) output, 'cartesian' for (x, y, z, gain) output.spherical
resolution_degNoAngular resolution in degrees for the exported pattern. Lower values give finer resolution but larger data. Typical values: 1, 2, 5, 10.

TDQS

A3.9/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. It discloses the tool is read-only (export) and requires a farfield monitor, but does not address error handling (e.g., missing monitor or incomplete simulation) or return data volume implications. Additional details on behavior beyond the basic action would improve 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 four sentences, each providing essential information: purpose, output, use case, and prerequisite. No wasted words, and the core action is 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 explains what is returned ('gain values over the full sphere') but lacks specifics on output format (e.g., array, structure) or data size implications of resolution_deg. Given no output schema, more detail on return type is needed for full 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 clear descriptions for all three parameters (frequency, coordinate, resolution_deg). The description adds minimal extra meaning beyond the schema, such as mentioning 'spherical or Cartesian coordinates' which already appears in the enum 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 clearly states the tool exports full 3D radiation pattern data at a specific frequency, specifying gain values over the full sphere in spherical or Cartesian coordinates. It distinguishes from sibling tools like cst_get_farfield or cst_get_pattern_cut by emphasizing 'full 3D' and 'over the full sphere'.

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 mentions a prerequisite ('Requires a farfield monitor at the specified frequency') and indicates usage for antenna pattern visualization and integration. However, it does not explicitly contrast with alternatives such as cst_get_farfield (for farfield data) or cst_get_pattern_cut (for a single cut), which could further guide selection.

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

cst_get_result_summaryA

Get a summary of all key simulation results from a completed CST simulation. Returns an overview of S-parameters, gain, efficiency, and impedance. Useful for a quick design evaluation without querying each result type individually.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/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. It communicates that the tool requires a 'completed CST simulation' and returns an overview, but it does not disclose whether it is read-only, if it has side effects, or any prerequisites beyond simulation completion.

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 with no fluff. It starts with the action and resource, then lists return types, ending with use case. Every sentence adds value.

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 tool with no parameters, no output schema, and many siblings, the description adequately covers what the tool does and when to use it. It lacks details on output format or limitations, but given the simple interface, it is sufficiently 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 input schema has no parameters, and schema description coverage is 100% (vacuously). The description adds no parameter information, which is appropriate given zero parameters. Baseline for 0 params is 4.

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 identifies the tool's purpose: retrieving a summary of all key simulation results from completed CST simulations. It specifies the types (S-parameters, gain, efficiency, impedance) and contrasts it with siblings by emphasizing the consolidated overview approach.

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 states it is 'useful for a quick design evaluation without querying each result type individually,' which implies usage context. While it doesn't explicitly list exclusions or alternative tools, the sibling tools provide those alternatives, making the guidance clear.

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

cst_get_simulation_statusA

Read whether a CST simulation is running and return any solver-run metadata exposed by the CST Python API. This does not show a dialog or change the simulation.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeout_sNo

TDQS

A4/5.0
Behavior4/5

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

With no annotations provided, the description carries full behavioral disclosure. It explicitly states 'does not show a dialog or change the simulation', which is a key behavioral trait that distinguishes it from mutation and dialog tools. However, it does not disclose the behavior of the timeout_s parameter (e.g., whether it polls, blocks, or returns immediately) or describe the structure of 'solver-run metadata', leaving some operational 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 two sentences, front-loading the primary purpose ('Read whether a CST simulation is running') and immediately adding a clarifying negative constraint. 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.

Completeness3/5

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

For a simple one-optional-parameter tool with no output schema, the description is reasonably complete but leaves gaps. It does not explain the role of timeout_s (why or how it is used), what specific 'solver-run metadata' might be returned, or whether an active connection is required. These are plausible questions an agent might need resolved before calling, though the core read-only behavior is clearly stated.

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 0%, so the description must compensate for the undocumented parameter. It does not mention timeout_s at all, providing no additional meaning beyond the parameter's name and default value. Since the only parameter is optional and self-descriptive, the lack of explanation is a minor shortcoming, but the description still fails to add any semantic value for the parameter.

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 ('Read') and resource ('whether a CST simulation is running'), clearly distinguishing this from control tools like cst_run_simulation, cst_pause_simulation, and cst_stop_simulation. It also clarifies it 'does not show a dialog or change the simulation', which differentiates it from dialog-watcher and mutation tools. This is unambiguous and leaves no room for confusion about its core function.

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 clearly implies use when you need to check simulation status without side effects, stating 'This does not show a dialog or change the simulation.' It provides context for selecting this over simulation-control or dialog-related tools, though it does not explicitly name alternative tools or state when not to use it. The intended usage is evident from the read-only framing.

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

cst_get_smith_chart_dataA

Extract Smith chart formatted impedance data from a completed CST simulation. Computes normalized impedance from S11 reflection coefficient: Z = Z0*(1+S11)/(1-S11). Returns real and imaginary parts of the normalized impedance for Smith chart plotting.

ParametersJSON Schema
NameRequiredDescriptionDefault
z0NoReference impedance in Ohms for normalization. Typically 50 Ohms for most RF systems.
portNoPort number to extract Smith chart data for.
run_idNo
max_pointsNoPreview sample count; 0 returns the full curve. Derived metrics use all samples.

TDQS

A4.2/5.0
Behavior4/5

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

No annotations are present, so the description carries the full disclosure burden. It discloses the computation path (from S11 via the given formula) and the return content (real and imaginary normalized impedance). It does not cover error behavior or explicitly confirm no side effects, but the 'completed simulation' phrasing implies read-only extraction.

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 concise sentences: the first states the purpose, the second states the formula and return values. No filler or repetition of schema 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 tool with four optional parameters and no output schema, the description provides the essential operational context: prerequisite, computation, and return shape. The only notable gap is run_id's meaning, which the schema also leaves undescribed, though defaults make the tool usable without it.

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%, covering z0, port, and max_points, leaving only run_id unexplained. The description reinforces z0's role through the formula but adds little beyond the schema and does not clarify run_id.

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?

States a specific verb ('Extract'), the resource ('Smith chart formatted impedance data'), and the source ('completed CST simulation'). The formula Z = Z0*(1+S11)/(1-S11) makes the function's role precise and differentiates it from sibling impedance or S-parameter getters.

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?

Clearly frames usage as post-simulation extraction ('from a completed CST simulation') and identifies the output purpose ('for Smith chart plotting'). It provides a clear context but does not explicitly name alternatives or when-not-to-use this tool.

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

cst_get_solver_infoA

Get current solver configuration and status. In connected mode this queries the active solver settings; in offline mode it describes expected parameters.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/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 disclosure. It notes that behavior differs by mode (queries vs describes), which is helpful. However, it omits details like whether a connection is required, authentication needs, or side effects, 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 two concise sentences with clear structure. Every word adds value, and it is front-loaded with the action and key modes.

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 no output schema, more detail about the return value (e.g., structure or fields) would improve completeness. The description says 'solver configuration and status' but doesn't specify what that includes, leaving the agent to infer.

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 no parameters, and the schema coverage is 100% (trivially). The description adds no extra parameter info because none are needed. Per guidelines, for zero parameters baseline is 4, and the description meets that standard.

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 retrieves solver configuration and status, with explicit distinction between connected and offline modes. This differentiates it from sibling tools like cst_get_mesh_info or cst_get_simulation_status.

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 context on when to use the tool (connected vs offline mode), which helps decide applicability. However, it does not explicitly state when not to use it or mention alternatives, though the sibling list is extensive and this tool is unique.

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

cst_get_s_parameter_phaseA

Extract S-parameter phase response from a completed CST simulation. Returns the phase of the specified S-parameter vs frequency. Optionally unwraps the phase to remove 360-degree discontinuities. Useful for group delay analysis and phase-matching designs.

ParametersJSON Schema
NameRequiredDescriptionDefault
run_idNo
unwrapNoIf true, unwrap the phase to remove 360-degree jumps. Useful for group delay computation.
port_inNoInput port number (excitation port).
port_outNoOutput port number (observation port).
max_pointsNoPreview sample count; 0 returns the full curve. Derived metrics use all samples.

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 carries the behavioral disclosure burden. It states a key prerequisite (completed CST simulation) and the optional unwrap behavior, which is useful. However, it does not disclose the read-only nature, return format, units, or error handling, leaving notable gaps.

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?

Four concise sentences with no fluff. The main action and key option are front-loaded. There is slight redundancy between 'Extract' and 'Returns,' but overall the structure is efficient and each sentence contributes.

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 5-parameter get tool with no annotations and no output schema, the description should clarify run_id semantics, phase units (degrees vs radians), and the return structure. It covers purpose and unwrap well but leaves these important operational details to the schema or agent inference, making it adequate but 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?

Schema description coverage is 80%, so baseline is 3. The description indirectly references unwrap and the specified S-parameter (via port_in/port_out), but the schema already describes most parameters. It does not compensate for the undocumented run_id parameter, which lacks a schema description.

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 identifies the resource (S-parameter phase), the action (extract/return), and the output (phase vs frequency). It distinguishes itself from sibling tools like cst_get_s_parameters and cst_get_group_delay by focusing specifically on phase, though it doesn't explicitly name those alternatives.

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 explicit use cases ('Useful for group delay analysis and phase-matching designs'), giving agents clear context for when to apply the tool. It does not mention when not to use it or name alternative tools, stopping short of full exclusion guidance.

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

cst_get_s_parametersA

Extract S-parameter results from a completed CST simulation. Returns S-parameter data (magnitude, phase, real/imaginary) for the specified port pair. In connected mode reads directly from the result tree; in offline mode returns VBA scripts and explains the CST result tree structure.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoOutput format for S-parameter data. 'db' = magnitude in dB, 'mag' = linear magnitude, 'real_imag' = real and imaginary parts, 'phase' = phase in degrees.db
run_idNo
port_inNoInput port number (excitation port).
port_outNoOutput port number (observation port).
max_pointsNoPreview sample count; 0 returns the full curve. Derived metrics use all samples.

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 full burden. It adds meaningful behavioral context by disclosing mode-specific behavior (direct result tree read vs VBA script generation), but it does not explicitly state the tool is read-only, explain how to select a run via run_id, or describe error behavior if the simulation is incomplete. This is partial 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?

The description is two sentences, front-loaded with the primary purpose, and includes the offline mode detail without unnecessary words. Every sentence contributes to understanding the tool's function and behavior.

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 no output schema and no annotations, the description covers the core function and modes. However, it omits guidance on run_id (which simulation run to use), how to determine connected vs offline mode, and behavior when no simulation results exist. For a tool with 5 parameters, this is a noticeable gap.

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 description coverage is 80%, so baseline is 3. The description adds meaning by explaining the 'port pair' concept (port_in/port_out) and the available data formats (magnitude, phase, real/imaginary) which map to the format parameter. It does not clarify run_id, but the schema covers most 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 tool extracts S-parameter results from a completed CST simulation and specifies the data types returned (magnitude, phase, real/imaginary) for a port pair. This is a specific verb+resource that effectively differentiates it from the phase-only sibling cst_get_s_parameter_phase, though it does not explicitly name that sibling.

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?

It provides clear context by noting the simulation must be completed and distinguishes connected vs offline modes. However, it does not explicitly direct users to alternatives (e.g., cst_get_s_parameter_phase for phase-only needs) or state when not to use this tool, so it lacks explicit exclusions.

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

cst_get_surface_currentA

Extract surface current density distribution from a completed CST simulation at a specific frequency. Useful for understanding current flow on antenna structures and identifying hot spots. Requires a surface current monitor at the specified frequency.

ParametersJSON Schema
NameRequiredDescriptionDefault
componentNoOptional: specific component to extract current for. If omitted, extracts for all components.
frequencyYesFrequency in GHz at which to extract surface current.

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 adds behavioral context beyond the schema by specifying that the simulation must be completed and that a surface current monitor is required. However, it does not disclose whether the operation is read-only, side effects, or error conditions like missing monitors.

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 three concise sentences, front-loaded with the main purpose. Each sentence adds essential context without unnecessary 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?

Given the tool's simplicity, the description covers the main precondition (completed simulation, monitor) and purpose. However, it lacks details on the output format or return type, which 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 coverage is 100%, providing baseline of 3. The description adds meaning for the 'frequency' parameter by linking it to a required monitor, but does not add extra information for 'component'. The added context is modest.

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 'extract' and the resource 'surface current density distribution', specifying the context of a completed CST simulation at a specific frequency. It differentiates from siblings like cst_get_current_distribution by focusing on surface current and requiring a monitor.

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 for use (understanding current flow on antenna structures, identifying hot spots) and states a prerequisite (surface current monitor at the specified frequency). However, it does not explicitly compare to alternative tools like cst_get_current_distribution.

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

cst_get_time_domain_signalA

Extract time-domain port signal waveforms from a completed CST time-domain simulation. Returns incident, reflected, or transmitted signal vs time. Useful for UWB pulse analysis, time-domain reflectometry, and transient response evaluation.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNoPort number for the signal.
port_outNoOutput port number (only used when signal_type='transmitted'). Specifies which port receives the transmitted signal.
signal_typeNo'incident' for the excitation signal at the port, 'reflected' for the reflected signal, 'transmitted' for the signal received at another port.reflected

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 full responsibility for behavioral transparency. It describes a read-like operation but does not explicitly confirm it is non-destructive, nor does it mention any side effects, authentication requirements, or error conditions (e.g., what happens if the simulation is not completed). The description is too brief for a tool lacking 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 highly concise at three short sentences. It front-loads the primary action and purpose, followed by the signal types and use cases. Every sentence adds value without redundancy or 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?

Given the moderate complexity and 100% schema coverage, the description provides a reasonable overview but misses key context: it does not explain the relationship between signal_type='transmitted' and the port_out parameter, nor does it describe the output format (beyond 'signal vs time') despite no output schema being present. It is functional but could be more 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 already provides 100% coverage with descriptions for all three parameters. The tool description adds no additional semantic information beyond what the schema states, so it meets the baseline expectation 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 verb 'extract' and the resource 'time-domain port signal waveforms from a completed CST time-domain simulation'. It lists the three signal types (incident, reflected, transmitted) and provides example use cases. This level of specificity distinguishes it from sibling tools that focus on frequency-domain results like S-parameters or impedance.

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 'from a completed CST time-domain simulation', but does not explicitly state when to use this tool versus alternatives (e.g., frequency-domain result tools). It lacks guidance on prerequisites or when not to use it, so the agent must infer context from the signal type and sibling names.

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

cst_get_vswrA

Get Voltage Standing Wave Ratio (VSWR) for a port from a completed CST simulation. VSWR indicates impedance matching quality: 1.0 is perfect match, <2.0 is generally acceptable. Can also be computed from S11: VSWR = (1+|S11|)/(1-|S11|).

ParametersJSON Schema
NameRequiredDescriptionDefault
portNoPort number to extract VSWR for.
run_idNo
max_pointsNoPreview sample count; 0 returns the full curve. Derived metrics use all samples.

TDQS

A3.9/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. It discloses that the tool reads from a completed simulation and explains the VSWR metric, but it does not mention whether it requires a specific solver type, what happens if the simulation is incomplete, or the return format. The max_points parameter behavior is partially described in the schema, not the 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 compact and front-loaded with the core purpose, followed by a brief explanation of the metric and its relation to S11. Every sentence adds value, and there is no redundant or filler 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 read-only post-processing tool with no output schema, the description covers the metric definition and the prerequisite (completed simulation), but it omits details about the return structure, how run_id is used, and any solver-specific requirements. The sibling list shows many related result-getting tools, so a bit more context on when this is the right choice 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?

Schema description coverage is 67% (port and max_points are described, run_id is not). The description adds context for the port parameter by explaining VSWR is per-port, but it does not explain run_id or the max_points preview behavior beyond what the schema already states. The description adds some value but does not fully compensate for the undocumented run_id.

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 retrieves VSWR for a port from a completed CST simulation, with a specific verb ('Get') and resource ('Voltage Standing Wave Ratio for a port'). It also explains what VSWR means and how it relates to S11, which distinguishes it from sibling tools like cst_get_s_parameters or cst_get_impedance.

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 for post-simulation analysis ('from a completed CST simulation') and provides the VSWR formula from S11, which helps an agent understand when to use it. However, it does not explicitly state when not to use it or name alternative tools for similar metrics (e.g., cst_get_s_parameters, cst_get_impedance).

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

cst_impedance_smith_transformA

Apply a reactive element transformation to an impedance on the Smith chart. Supports series L/C, shunt L/C, and transmission line operations. Returns transformed impedance, reflection coefficient, and VSWR. Pure Python computation.

ParametersJSON Schema
NameRequiredDescriptionDefault
z0NoReference impedance in ohms (default 50)
valueYesComponent value: L in nH, C in pF, or transmission line electrical length in degrees
operationYesType of transformation to apply
z_in_imagYesInput reactance in ohms
z_in_realYesInput resistance in ohms
frequency_ghzYesOperating frequency in GHz

TDQS

A4/5.0
Behavior4/5

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

With no annotations, the description discloses that computation is pure Python (no simulation), lists return values, and enumerates allowed operations. However, it does not describe behavior for invalid inputs or boundary conditions, which would be beneficial for agent decision-making.

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?

Three concise sentences with no filler. The most critical information (purpose, operations, returns, computation type) is front-loaded. Every sentence 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?

Given no output schema, the description adequately lists return types. For a transform tool with moderate complexity (6 params, 5 required), the core functionality is covered. Missing are examples or details on parameter relationships, but it remains sufficient for most uses.

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 baseline is 3. The description adds value by specifying units for component values (L in nH, C in pF, electrical length in degrees) and clarifies that value depends on operation type, which goes beyond the schema's generic 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?

Clearly states the tool applies reactive element transformations on a Smith chart, lists specific operations (series L/C, shunt L/C, transmission line), and specifies outputs (transformed impedance, reflection coefficient, VSWR). This distinguishes it from sibling tools like impedance analysis or stub matching.

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 (e.g., cst_matching_* tools). No prerequisites, limitations, or exclusions are mentioned, leaving the agent to infer appropriate context.

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

cst_import_cadA

Import a CAD file into CST Studio. Supports STEP (.stp/.step), IGES (.igs/.iges), STL (.stl), SAT/ACIS (.sat), DXF (.dxf), and OBJ (.obj) formats.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatYesCAD file format: stp (STEP), igs (IGES), stl, sat (ACIS), dxf, obj.
componentNoTarget component name for the imported geometry.Import
file_pathYesFull path to the CAD file to import.

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 full burden. It only states the basic action without disclosing behavioral traits such as whether it merges or replaces existing geometry, or if it creates a new component.

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 efficient sentences: first states the action, second lists supported formats. No extraneous 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 import tool, the description is adequate but has gaps. It does not mention what happens to existing data, nor does it explain the component parameter behavior. Without an output schema, more context on results would be helpful.

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 three parameters. The description adds context by listing supported formats, which is partially redundant with the enum in the schema. It does not significantly enhance parameter understanding 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 verb 'Import' and the resource 'a CAD file into CST Studio', and lists the supported formats. This distinguishes it from other import tools like cst_import_touchstone.

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 CAD files through the listed formats, but does not explicitly state when to use this tool versus alternatives (e.g., cst_import_touchstone) or provide any 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.

cst_import_touchstoneB

Import a Touchstone S-parameter file (.s1p, .s2p, .snp) into CST Studio for use as a reference or circuit element.

ParametersJSON Schema
NameRequiredDescriptionDefault
file_pathYesFull path to the Touchstone file (.s1p, .s2p, etc.).
port_numberNoPort number to associate the imported data with.

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 burden for disclosing side effects, but it does not mention whether it modifies the project tree, overwrites existing data, or requires specific permissions. The phrase 'into CST Studio' is vague about the target location.

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, straightforward sentence with no filler. Every word is necessary and informative.

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 an import tool with no output schema, the description lacks details about the import's impact (e.g., component creation, project state). It is adequate but not thorough given the tool's potential 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% (both parameters documented), and the description adds marginal value by mentioning file types and usage purpose. The port_number parameter is already explained in 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 action (import), resource (Touchstone S-parameter file with explicit extensions .s1p, .s2p, .snp), and intended use (as reference or circuit element). It effectively distinguishes from siblings like cst_export_touchstone.

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, prerequisites (e.g., open project), or conditions under which import should be avoided. The agent is left to infer usage context.

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

cst_list_antenna_templatesA

List all available parametric antenna templates with descriptions and typical use cases. No arguments required.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/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 full burden. It describes the tool as a read-only listing operation, which is non-destructive. However, it does not disclose potential behaviors like return format or performance implications, which is adequate but not exceptional.

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 core purpose and includes useful detail about descriptions and use cases. Every word earns its place with no 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?

While the description covers the basic purpose, it omits details about the output format. Given no output schema, the description could have been more explicit about what the list contains (e.g., names, dictionaries) to fully prepare the agent. It is adequate but not 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?

With zero parameters and 100% schema coverage, the schema is already complete. The description adds value by explicitly stating 'No arguments required,' confirming the parameterless invocation, which aligns with the baseline of 4.

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 available parametric antenna templates with descriptions and typical use cases. The verb 'list' and the resource 'parametric antenna templates' are specific and distinguish it from sibling tools like specific antenna creation tools.

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 notes that no arguments are required, providing clear usage guidance. While it doesn't explicitly contrast with other tools, the context of sibling antenna tools implies this is for browsing before selection, making it clear when to use.

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

cst_list_ferrite_materialsA

List available ferrite materials from the bundled database. Returns name, permittivity, saturation magnetisation, linewidth, loss tangent, maximum frequency, and usage notes for each ferrite.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior4/5

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

No annotations provided, but the description accurately implies a read-only operation by stating it lists materials from the database; no side effects are disclosed, which is acceptable for a simple list.

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 sentence, front-loaded with the action, and each word adds value; no redundancy.

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?

Given no parameters and no output schema, the description fully covers the tool's behavior and output, making it complete for a list operation.

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?

No parameters exist, schema coverage is 100%, and the description adds value by detailing the return fields, exceeding the baseline for zero-parameter tools.

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 it lists ferrite materials from the bundled database, with a specific verb and resource, and distinguishes from sibling tools like cst_list_materials and cst_create_ferrite_material.

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?

Implied usage as a retrieval tool, but no explicit guidance on when to use vs alternatives like cst_list_materials or when not to use it.

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

cst_list_materialsA

List available materials from the bundled material database. Optionally filter by category: 'metals', 'dielectrics', or 'substrates'. Returns name, key EM properties, and usage notes for each material.

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryNoFilter by category: 'metals', 'dielectrics', or 'substrates'

TDQS

A3.8/5.0
Behavior3/5

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

Description indicates return content (name, properties, usage notes) but does not explicitly state it is a read-only operation with no side effects. Given no annotations, provides moderate transparency but could clarify data source or performance.

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?

Extremely concise two-sentence structure. Front-loaded with core purpose, then adds filtering and return details. No unnecessary 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?

For a list tool without output schema, description specifies return content (name, properties, notes). Lacks pagination or size hints but sufficient for typical 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 already fully describes the parameter with enum values. Description adds context by identifying the categories as material types, but no additional syntax or usage details beyond schema. Baseline 3 due to 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?

Clearly states it lists available materials from a specific bundled database, with optional filtering by category. Distinguishes itself from sibling tools like cst_get_material_info (single material info) and cst_create_material (creation).

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?

Provides filtering options but no explicit guidance on when to use this versus sibling tools like cst_get_material_info or cst_list_ferrite_materials for specific material types.

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

cst_list_parametersA

List all design parameters in the current CST project with their names, expressions, and evaluated numeric values.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/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 full burden. It indicates read-only behavior (list) with no side effects, but provides no additional context beyond purpose, such as performance implications or permission requirements. The description 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 verb and resource. Every word is necessary, with no redundancy or extra information.

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?

Given the tool's simplicity (no parameters, no output schema), the description is fully complete. It covers what the tool does and what it returns, which is sufficient for an AI agent to understand its purpose and invocation.

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 no parameters (schema coverage 100%), so the description does not need to add parameter details. However, it adds value by specifying the output context (names, expressions, values), which goes beyond the empty 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 lists all design parameters in the current CST project, specifying the returned information (names, expressions, numeric values). It uses a specific verb ('list') and distinguishes from siblings like cst_get_parameter (single get) and cst_set_parameter (set).

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 use when needing a full list of parameters, but lacks explicit guidance on when to use this tool versus alternatives like cst_get_parameter. No exclusions or prerequisites are mentioned, which is a minor gap.

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

cst_list_portsA

List all ports defined in the current CST project. Returns VBA to query port information, or a description in offline mode.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior4/5

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

With no annotations, the description carries full burden. It discloses key behaviors: returns VBA code (not raw data) and describes offline mode behavior. This adds useful context beyond the schema.

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 efficient sentences: first states purpose with scope (current project), second explains return type in two modes. No unnecessary words.

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 zero-parameter list tool, the description fully covers purpose, return type (VBA or description), and context (offline mode). No gaps given the simplicity.

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?

No parameters defined; schema coverage is 100% with zero params. Baseline is 4 as description is irrelevant here. No further explanation 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 tool lists all ports in the CST project, distinguishing it from sibling tools that add or delete ports. The verb 'List all' and resource 'ports' are specific 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 Guidelines3/5

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

No explicit guidance on when to use vs alternatives. However, the tool's purpose is straightforward (listing), and the context of sibling tools implies it's for viewing ports. A minimal viable score.

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

cst_list_resultsA

List all available results in the CST result tree. Optionally specify a subtree path to narrow the listing. Useful for discovering what simulation results are available before extracting specific data.

ParametersJSON Schema
NameRequiredDescriptionDefault
tree_pathNoResult tree path to list, e.g. '1D Results', '1D Results\S-Parameters', 'Farfields', '2D/3D Results'. Omit to list top-level result categories.

TDQS

A4/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. It implies a read-only operation (listing) but does not explicitly state it does not modify data or require permissions. The description is straightforward but lacks depth; a score of 3 is appropriate for a simple 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, to the point, with no unnecessary words. It front-loads the purpose and adds usage context efficiently.

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 optional parameter, no output schema), the description covers the purpose, usage context, and parameter. It could mention the return format (e.g., list of paths), but that is not critical. The description is nearly 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% for the single parameter, so baseline is 3. The description adds context by stating the parameter is optional and used to narrow the listing, which is a minor addition. It does not provide substantial new meaning 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 lists all available results in the CST result tree, with optional subtree filtering. The verb 'List' and resource 'CST result tree' are specific, and the mention of discovering results before extraction distinguishes it from sibling tools like cst_get_result_summary or cst_export_result.

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 says the tool is 'Useful for discovering what simulation results are available before extracting specific data,' providing clear context for when to use it. It does not mention when not to use or name alternatives explicitly, but the context is sufficient.

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

cst_list_saved_resultsA

List exact result tree paths and run IDs from a saved, unpacked, completed .cst file using cst.results. No connection or CST GUI is required. Do not use a file currently being solved.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
offsetNo
containsNo
project_pathYes

TDQS

A3.7/5.0
Behavior4/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 that no connection or CST GUI is required, that it uses cst.results, and that in-progress files are off-limits. These are useful behavioral constraints, and the verb 'list' implies a non-destructive read operation. It doesn't explicitly state 'read-only' or error behavior, but the included context is valuable.

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 with no fluff. The main action is front-loaded, and the additional constraints (no connection, not for in-progress files) are stated efficiently. Every sentence 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 must explain the tool's behavior and parameters. It covers the returned data type and prerequisites, but omits parameter semantics entirely and does not mention return format or error conditions. For a tool with pagination and filtering parameters, this is incomplete.

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?

Schema coverage is 0% and the description adds no meaning for any of the four parameters. It never mentions project_path, limit, offset, or contains, so an agent cannot infer that limit/offset control pagination or that contains filters results. This is a critical gap given the schema provides no 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 clearly states the tool lists exact result tree paths and run IDs from a saved, unpacked, completed .cst file. It uses a specific verb (list) and resource, and differentiates itself from sibling result-listing tools by specifying 'saved' and 'no connection required', so an agent can distinguish it from live project tools like cst_list_results.

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 gives clear context for when to use this tool: when working with a saved, unpacked, completed .cst file and no connection or GUI is needed. It also provides an explicit exclusion ('Do not use a file currently being solved'). However, it does not name alternative tools such as cst_list_results, so the guidance is clear but not fully comparative.

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

cst_list_vba_objectsA

List available CST Studio VBA objects, optionally filtered by category. Returns object names with brief descriptions.

ParametersJSON Schema
NameRequiredDescriptionDefault
categoryNoOptional category filter. If omitted, all categories are returned.

TDQS

A4/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 full burden. It indicates a read-only query (list operation) with no side effects, but does not explicitly state safety, permissions, or limitations. The description is adequate but not thorough.

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 two clauses, efficiently communicating purpose, filtering, and output. No 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?

For a simple list tool with one optional parameter and no output schema, the description adequately covers the return format (names with descriptions) and filtering. It is complete enough for the 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?

Schema coverage is 100%; the description adds minimal value by restating the filtering option. It does not elaborate on the category values or parameter behavior beyond what the schema provides. 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 it lists CST Studio VBA objects, specifying optional filtering by category and noting the return of names with descriptions. This distinguishes it from sibling tools like cst_list_materials or cst_list_ports, making the 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 usage for discovering available VBA objects, especially with filtering. However, it lacks explicit guidance on when not to use it or alternatives. Given the context, it provides clear context but no exclusions.

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

cst_load_materialA

Load a material from the CST material library by its library name. The material is added to the project under the given name.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName for the material in the project
library_nameYesName in the CST library (e.g. 'Copper (annealed)')

TDQS

A3.9/5.0
Behavior2/5

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

No annotations provided; description does not disclose side effects like overwriting, permissions, or error handling, leaving behavioral aspects unclear.

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 efficient sentences with no wordiness, clearly communicating purpose and key 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?

Adequate for a simple tool but lacks details on error handling or behavior when inputs are invalid or duplicate.

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 covers both parameters with descriptions; description reinforces 'library_name' and 'name' roles, adding slight context.

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 loads a material from the CST library and adds it to the project, distinguishing it from create material tools.

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?

It implies usage for loading predefined materials, but lacks explicit alternatives or 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.

cst_matching_create_lumpedB

Generate CST VBA code to create a lumped-element matching network. Each component (inductor, capacitor, resistor) is placed as a CST LumpedElement with specified series/shunt connection.

ParametersJSON Schema
NameRequiredDescriptionDefault
componentsYesList of lumped components in the network (ordered source to load)
frequency_ghzYesDesign frequency in GHz
port_impedanceNoPort reference impedance in ohms (default 50)

TDQS

B3.1/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. It only states what the tool does (generate code) without disclosing side effects, whether it executes the code, if it modifies existing components, or requires an open project. For a code-generation tool, 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?

Description is a single concise sentence with no redundant phrases. It efficiently conveys the core function, though slight restructuring could improve clarity (e.g., separating the code generation aspect from the placement details).

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 output schema or annotations, the description should explain what the generated code does, its format, or any prerequisites. It lacks information about execution context, return value, or integration with CST, leaving significant gaps 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 covers 100% of parameters with descriptions; the description adds minimal extra meaning (e.g., placing components as LumpedElement with series/shunt). Baseline 3 is appropriate as no additional semantic insight is provided 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 generates CST VBA code to create a lumped-element matching network with explicit mention of components (inductor, capacitor, resistor) and placement as CST LumpedElement. This differentiates it from sibling tools like cst_matching_l_network or cst_matching_pi_network which target specific topologies.

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 (e.g., other matching network tools or lumped element tools). There is no mention of prerequisites, contexts, or when not to use it.

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

cst_matching_l_networkA

Design an L-section impedance matching network. Computes inductor and capacitor values for matching a source impedance to a load impedance at a given frequency. Supports lowpass and highpass topologies. Pure Python computation — no CST connection needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
topologyNoNetwork topology (default lowpass)lowpass
z_load_imagNoLoad reactance in ohms (default 0)
z_load_realYesLoad resistance in ohms
frequency_ghzYesDesign frequency in GHz
z_source_imagNoSource reactance in ohms (default 0)
z_source_realYesSource resistance in ohms

TDQS

A4.2/5.0
Behavior4/5

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

No annotations are present, so the description must handle behavioral disclosure. It explicitly states 'Pure Python computation — no CST connection needed,' which clarifies side effects (none) and independence from CST. It doesn't describe return format or error behavior, but the core behavior is well-covered.

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 three sentences, front-loaded with the primary purpose, and contains no redundant information. Every sentence adds value: purpose, computation, topologies, and independence from CST.

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 and no output schema, the description covers the essential aspects. It could mention that the tool returns L and C values, but this is implicit. Slight gap in output specification prevents a perfect score.

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 parameters have descriptions in the schema (100% coverage), so the description adds minimal extra meaning beyond contextualizing them as inputs for the matching network. 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 it designs an L-section matching network, computes inductor and capacitor values, and supports lowpass/highpass topologies. It differentiates from sibling tools like cst_matching_pi_network and cst_matching_t_network by specifying 'L-section' and noting no CST connection.

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?

It indicates topologies supported but does not explicitly state when to use this versus alternatives like pi, T, or stub networks. However, the sibling list suggests usage for L-network design, and the description is clear enough for an agent to infer context.

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

cst_matching_microstrip_impedanceB

Calculate microstrip transmission line characteristic impedance from physical dimensions using the Hammerstad-Jensen model with optional Kirschning-Jansen frequency dispersion correction. Pure Python computation.

ParametersJSON Schema
NameRequiredDescriptionDefault
width_mmYesTrace width in mm
epsilon_rYesSubstrate relative permittivity
height_mmYesSubstrate height (dielectric thickness) in mm
thickness_mmNoConductor thickness in mm (default 0.035 = 1 oz copper)
frequency_ghzNoFrequency in GHz for dispersion correction (optional)

TDQS

B3.4/5.0
Behavior3/5

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

Discloses it uses pure Python computation (no CST simulation side effects) and the specific model. However, does not describe the output format (e.g., impedance value in ohms) or any constraints. With no annotations, more detail would improve 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?

Two concise sentences. First sentence covers purpose and model; second adds 'pure Python computation' as a key behavioral indicator. No wasted words.

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?

Missing information about return value (e.g., characteristic impedance in ohms) and error/range conditions. Since there is no output schema, the description should clarify what the tool returns. The tool is simple but incomplete without output details.

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 baseline is 3. Description adds context about the Hammerstad-Jensen model and that frequency_ghz enables dispersion correction, but this is also implicit in the schema description. Adds minimal extra meaning.

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 tool calculates microstrip characteristic impedance using specific models (Hammerstad-Jensen, optional Kirschning-Jansen). Distinct from siblings like cst_analyze_impedance by highlighting pure Python computation, indicating no simulation dependency.

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 vs alternatives (e.g., simulation-based impedance extraction). No prerequisites or when-not-to-use conditions are mentioned.

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

cst_matching_pi_networkA

Design a Pi-section impedance matching network (C-L-C or L-C-L). Uses two back-to-back L-sections via a virtual resistance for controllable Q factor. Pure Python computation.

ParametersJSON Schema
NameRequiredDescriptionDefault
q_factorNoDesired loaded Q factor. Must be > sqrt(R_large/R_small - 1). If omitted, a default Q is chosen automatically.
z_load_imagNoLoad reactance in ohms (default 0)
z_load_realYesLoad resistance in ohms
frequency_ghzYesDesign frequency in GHz
z_source_imagNoSource reactance in ohms (default 0)
z_source_realYesSource resistance in ohms

TDQS

A3.7/5.0
Behavior3/5

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

States 'Pure Python computation' but no annotations exist. Does not disclose side effects, output format, or if it modifies any data. Adequate but lacks depth for a computation-heavy 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?

Two sentences with no redundancy. Front-loaded with key purpose and method. Efficiently conveys essence.

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?

Lacks explanation of output (e.g., does it return component values?). Given no output schema, description should cover this. Basic topology info is present but incomplete for practical 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 coverage is 100%, so parameters are already described. The description adds no extra meaning beyond the schema; mentions Q factor but that is also in schema. Baseline 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?

Description clearly states it designs a Pi-section impedance matching network with specific topologies (C-L-C or L-C-L) and mentions the method (back-to-back L-sections). This is distinct from sibling tools like L-network or T-network.

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?

Implies use for controllable Q factor but does not explicitly state when to choose Pi over other matching networks (e.g., L-network or T-network). No exclusions or alternative guidance provided.

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

cst_matching_quarter_waveA

Design a quarter-wave transformer matching network. Supports single and multi-section designs with maximally flat (binomial) or Chebyshev impedance profiles. Pure Python computation.

ParametersJSON Schema
NameRequiredDescriptionDefault
designNoMulti-section design method (default maximally_flat)maximally_flat
z_loadYesLoad impedance in ohms
z_sourceYesSource impedance in ohms
num_sectionsNoNumber of quarter-wave sections (1-4, default 1)
frequency_ghzYesDesign center frequency in GHz

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 burden of transparency. It discloses that computation is 'pure Python' (non-simulation based), which is helpful, but does not specify return values, constraints (e.g., frequency range validity), or side effects. More detail would improve 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 very concise: two sentences with no redundant phrases. It front-loads the core purpose, then mentions key features. Every word serves a purpose, earning a high score.

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 5 parameters, no output schema, and no annotations, the description is moderately complete. It covers design capabilities but omits important context such as return value structure (e.g., section impedances, lengths), edge cases (e.g., unmatched loads), or usage in a simulation workflow. For a design tool, this leaves gaps for an AI 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 coverage is 100% with clear parameter descriptions. The description adds minimal extra meaning beyond referencing 'maximally flat' and 'Chebyshev' (matching design enum) and 'single and multi-section' (matching num_sections). It does not elaborate on parameter semantics beyond what the schema provides, 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?

The description states the tool's purpose clearly: 'Design a quarter-wave transformer matching network.' It specifies supported features (single/multi-section, maximally flat/Chebyshev) and distinguishes it as a pure Python computation, setting it apart from sibling tools like cst_matching_stub or cst_matching_l_network.

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 quarter-wave transformer design but does not explicitly state when to use it over other matching tools (e.g., stub, L-network). It lacks guidance on prerequisites (e.g., real impedances only) or alternatives, leaving the agent to infer context from the tool name and sibling list.

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

cst_matching_stubA

Design a single-stub impedance matching network. Computes the stub length and distance from the load using Smith chart transmission-line matching. Pure Python computation.

ParametersJSON Schema
NameRequiredDescriptionDefault
z0NoCharacteristic impedance in ohms (default 50)
stub_typeNoStub termination type (default open)open
z_load_imagNoLoad reactance in ohms (default 0)
z_load_realYesLoad resistance in ohms
frequency_ghzYesDesign frequency in GHz

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 full burden. It discloses 'Pure Python computation' (no CST interaction) and that it computes stub length and distance, but does not clarify whether results are returned, printed, or applied to a project. More detail on side effects or output method would improve 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?

Three short, focused sentences with no redundancy. The first sentence states the purpose, the second details the computation method, and the third notes the implementation. Every sentence adds value.

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 omits output specification (units, format) and does not mention any prerequisites or return behavior. Given the 5 parameters and no output schema, the description should provide more details 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?

Schema description coverage is 100% (all parameters documented). The description adds context that outputs are stub length and distance, but does not enhance parameter understanding beyond the schema. 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?

Clearly states 'Design a single-stub impedance matching network' and specifies it computes stub length and distance. Differentiates from sibling tools that handle other matching types (L-network, quarter-wave, etc.). The phrase 'Pure Python computation' further clarifies it is a standalone calculation.

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 single-stub matching but does not explicitly state when to use this tool over alternatives like cst_matching_l_network or cst_matching_quarter_wave. No exclusions or when-not-to-use are provided.

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

cst_matching_t_networkA

Design a T-section impedance matching network (L-C-L). Dual of Pi-network, uses two back-to-back L-sections. Pure Python computation.

ParametersJSON Schema
NameRequiredDescriptionDefault
q_factorNoDesired loaded Q factor. Must be > sqrt(R_large/R_small - 1). If omitted, a default Q is chosen automatically.
z_load_imagNoLoad reactance in ohms (default 0)
z_load_realYesLoad resistance in ohms
frequency_ghzYesDesign frequency in GHz
z_source_imagNoSource reactance in ohms (default 0)
z_source_realYesSource resistance in ohms

TDQS

A3.7/5.0
Behavior3/5

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

No annotations provided. States 'Pure Python computation' indicating no side effects. However, doesn't disclose return format, error handling, 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.

Conciseness5/5

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

Two concise sentences, front-loaded with key information. No waste.

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?

No output schema, but description is adequate for a simple computation tool. However, it doesn't mention return values or integration with CST model, which could be important for the 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 has 100% coverage with descriptions for all 6 parameters. The description adds minimal extra meaning beyond the schema, just mentioning the L-C-L topology.

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 it designs a T-section impedance matching network (L-C-L) and distinguishes from Pi-network. Mentions it's pure Python, no simulation.

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?

Mentions it's the dual of Pi-network, but doesn't explicitly guide when to choose this over Pi or other matching networks. Lacks when-to-use or when-not-to-use scenarios.

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

cst_multi_objective_optimizerA

Set up a multi-objective optimization with weighted goals and optional constraints. Uses a weighted sum of goals with an evaluation cap; this is not a Pareto-front search. Configuration only; start explicitly.

ParametersJSON Schema
NameRequiredDescriptionDefault
goalsYesList of optimization goals with weights.
methodNoEvaluation-capped optimization method.CMAES
parametersYes
constraintsNoOptional inequality constraints on results.
max_evaluationsNo

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 behavioral burden. It usefully discloses the weighted-sum algorithm, an evaluation cap, that it is not a Pareto search, and that it is configuration-only. However, it does not state what project state it modifies, whether previous optimizer settings are overwritten, or what the tool returns or requires to be active.

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?

Three short sentences with no filler. The main purpose is front-loaded, the algorithmic caveat follows, and the critical config-only behavior is stated last. 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?

For a config-only tool with no output schema, the description covers the core semantics and the important 'start explicitly' behavior. Missing context includes whether an active project is required, which tool should be used to start the optimization, and what happens to previously configured optimizer state.

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 60%, so the description is expected to add some parameter meaning. It adds value by calling out 'weighted goals,' 'optional constraints,' and the 'evaluation cap,' which map to goals, constraints, and max_evaluations. But the required parameters array is not described beyond its schema and the description does not explain what 'parameters' means in the optimization context.

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 specifies a concrete action ('Set up a multi-objective optimization') and names the main inputs ('weighted goals and optional constraints'). It distinguishes this from a Pareto-front search, which is helpful, but it does not explicitly differentiate from related siblings such as cst_optimizer or cst_constrained_optimizer.

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: use this when setting up a weighted-sum multi-objective optimization, and do not expect a Pareto search. The phrase 'Configuration only; start explicitly' gives important when-not guidance, though no sibling tool is named as the alternative for starting or for constrained optimization.

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

cst_open_projectA

Open an existing CST Studio Suite project. In connected mode the project is opened in the running instance; in offline mode a reference is stored for subsequent operations.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesFull file path of the existing .cst project to open.

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 the burden. It explains connected vs offline mode but lacks detail on prerequisites, side effects, or error handling. Beyond schema, it adds mode context but not comprehensive 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?

Two efficient sentences with zero waste. Front-loaded with verb and resource, concise and structured effectively.

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 open operation, the description is fairly complete. It covers modes and parameter. Missing are return value (no output schema) and edge cases, but acceptable for this 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?

Schema coverage is 100% with a clear description for the only parameter (path). The tool description adds no additional parameter meaning beyond what the schema provides, 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?

The description clearly states the tool opens an existing CST Studio Suite project, distinguishing between connected and offline modes. Among siblings, cst_create_project and cst_close_project highlight the distinct purpose.

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 when to use (opening an existing project) and mentions two modes, but does not explicitly note when not to use or reference alternatives like cst_create_project.

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

cst_optimizerB

Set up an optimization in CST Studio. Define a goal (minimize, maximize, or target a specific value for a result), specify which parameters to vary with their bounds, and choose an optimization algorithm.

ParametersJSON Schema
NameRequiredDescriptionDefault
methodNoOptimization algorithm.Trust Region
goal_typeYesOptimization goal type.
goal_valueNoTarget value for 'target' goal type. Ignored for minimize/maximize.
parametersYesList of parameters to optimize with their min/max bounds.
result_pathYesResult tree path to optimize, e.g. '1D Results\S-Parameters\S1,1' or '1D Results\S-Parameters\S2,1'.
max_evaluationsNoMaximum number of solver evaluations.

TDQS

B3.4/5.0
Behavior3/5

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

There are no annotations provided, so the description carries the full burden. The description states that a goal is defined with minimize/maximize/target, and parameters vary with bounds. However, it does not disclose important behaviors such as whether the tool modifies the existing project (mutation), requires a running solver, or has side effects (e.g., generating new results). It also doesn't mention that this is a configurational step before running an optimization, which could affect the agent's expectations.

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 listing the key components (goal, parameters, algorithm) in a logical order. It is concise and front-loads the core purpose. However, it could be slightly more structured by explicitly listing the parameters or providing an example, but it's efficient and clear.

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 6 parameters and no output schema, the description covers the main inputs but does not explain the expected output or behavior—such as returning a summary of the optimization setup or actually running the optimization. It also doesn't mention any preconditions (e.g., a project must be open, results must exist for result_path). Since it's a complex tool with nested parameters (parameters array), more context on the workflow would be beneficial.

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% description coverage, so parameters like goal_type, result_path, parameters, method, goal_value, max_evaluations are described. The tool description adds a high-level summary but does not add extra meaning beyond what the schema already provides. For example, it doesn't clarify the format of result_path beyond the schema's example, or explain the interaction between goal_type and goal_value beyond the schema's note. Thus, it meets the baseline 3 but does not go beyond.

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 sets up an optimization in CST Studio, with a specific verb ('Set up') and resource ('optimization'). It outlines the main components: goal, parameters, and algorithm. However, it does not explicitly differentiate from sibling tools like cst_parameter_sweep, cst_multi_objective_optimizer, or cst_constrained_optimizer, which might also involve optimization. A brief mention of alternative tools or distinguishing features would elevate it to 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 Guidelines3/5

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

The description implies usage in optimization scenarios, but it does not specify when to use this tool versus alternatives like cst_parameter_sweep (for sweeps) or cst_multi_objective_optimizer (for multi-objective). It also doesn't mention prerequisites like running a simulation first or having results available. The 'result_path' parameter hints at needing existing results, but the description doesn't explicitly state that.

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

cst_parameter_interpolationA

Interpolate results between parameter sweep data points to estimate performance at a specific parameter value without running a new simulation.

ParametersJSON Schema
NameRequiredDescriptionDefault
parameterYesName of the sweep parameter.
result_pathYesResult tree path to interpolate.
target_valueYesParameter value at which to interpolate results.

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 must convey behavioral traits. It states the tool estimates performance via interpolation without running a simulation, which is helpful. However, it omits details like interpolation method, accuracy, or requirements (e.g., sweep data must exist).

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 that front-loads the core action and purpose. No unnecessary words 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?

The description explains the tool's purpose but does not specify what it returns (presumably interpolated results) or preconditions like a completed sweep. While the schema covers parameters, the lack of output schema detail and prerequisites limits 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 descriptions for all three parameters (parameter, result_path, target_value). The description reinforces that interpolation is across sweep data points, adding context but not new parameter-level meaning. 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's function: interpolating results from parameter sweep data to estimate performance at a specific parameter value, avoiding a new simulation. It distinguishes from sibling cst_parameter_sweep by emphasizing the interpolation over sweep execution.

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 usage after a parameter sweep has been run, noting that no new simulation is needed. It provides clear context but lacks explicit when-not-to-use or alternative tools for related tasks.

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

cst_parameter_sweepC

Set up a parameter sweep in CST Studio. The sweep runs the simulation multiple times, varying the specified parameter across a range of values.

ParametersJSON Schema
NameRequiredDescriptionDefault
stopYesStop value of the sweep range.
startYesStart value of the sweep range.
stepsYesNumber of steps in the sweep (minimum 2).
parameterYesName of the parameter to sweep.
simulation_typeNoSolver type for the sweep. Defaults to Transient.

TDQS

C2.9/5.0
Behavior2/5

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

No annotations provided, so the description must fully disclose behavioral traits. It states the sweep runs simulations multiple times, but does not clarify whether it both sets up and executes, whether it modifies project state, or how results are returned. It lacks details on side effects, asynchronous execution, or required prior setup.

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, front-loaded with the core purpose, and contains no redundant information. It is appropriately sized for the tool's complexity.

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 sets up and runs simulations, the description omits crucial details: whether execution is synchronous, how to retrieve results, and what the output format is. Since no output schema exists, the description should provide more context on return values or side effects.

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 each parameter. The tool description adds no significant meaning beyond the schema; it does not explain step type (e.g., linear/logarithmic) or constraints beyond the schema's minimum steps.

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 sets up a parameter sweep and runs simulations multiple times. The verb 'set up' and resource 'parameter sweep' are specific. However, it does not differentiate from sibling tools like cst_parameter_interpolation or cst_sensitivity_analysis, which perform related but distinct 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 on when to use this tool versus alternatives, such as cst_parameter_interpolation or cst_sensitivity_analysis. There is no mention of prerequisites (e.g., parameter must exist, project must be open) or context for typical use cases.

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

cst_pause_simulationB

Pause a currently running CST simulation. The simulation can be resumed later with cst_resume_simulation.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeout_sNo

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 adds the useful fact that the pause is reversible (resumable later), but says nothing about blocking behavior, failure conditions when no simulation is running, what the timeout_s parameter does, or whether the pause is immediate. This is thin disclosure for a state-mutating control 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?

Two sentences with no filler; the primary action is front-loaded and the second sentence earns its place by establishing the resume pairing. It is appropriately sized for a simple control tool, though it could have traded a little brevity for a timeout_s hint.

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, no-output-schema tool this is moderately complete: the core action and its reversibility are covered. But given zero annotations, the unexplained timeout_s parameter and unspecified behavior when no simulation is running leave an agent needing to guess.

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?

Schema description coverage is 0% and the description adds nothing about the only parameter, timeout_s. An agent cannot tell what the timeout applies to (waiting for the pause to take effect? total delay?), what units it uses, or what the default of 30 means behaviorally. The description completely fails to compensate for the undocumented 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 states a specific verb and resource ('Pause a currently running CST simulation') and immediately distinguishes the tool from its sibling by noting the simulation 'can be resumed later with cst_resume_simulation'. This clearly separates pause from cst_stop_simulation and cst_run_simulation.

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 'currently running CST simulation' gives clear context for when the tool applies, and the mention of resuming implies it is not a terminal action. However, it does not explicitly exclude other states (e.g., idle/completed simulations) or contrast with cst_stop_simulation as the terminating alternative, so the guidance is 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.

cst_pcb_calculate_couplingA

Calculate electromagnetic coupling between parallel PCB traces. Computes even/odd mode impedances, coupling coefficient, and near-end/far-end crosstalk estimates using coupled microstrip formulas. Pure calculation — no VBA or CST geometry is generated.

ParametersJSON Schema
NameRequiredDescriptionDefault
epsilon_rYesSubstrate relative permittivity
height_mmYesSubstrate height to reference plane in mm
frequency_ghzYesOperating frequency in GHz
separation_mmYesEdge-to-edge separation between traces in mm
trace_width_mmYesWidth of each trace in mm
coupling_length_mmYesParallel coupling length in mm

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 carries full behavioral burden. It clearly states it is a pure calculation with no geometry generation, which is helpful. However, it does not disclose whether it modifies project state, requires prior setup, or any side effects. The read-only nature is implied but not explicitly confirmed.

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 extraneous words. It front-loads the core purpose and adds a clarifying statement about no geometry generation. Every sentence adds value.

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 computes complex quantities but has no output schema, and the description does not specify the format, structure, or units of the return value. For an agent to use this tool correctly, it needs to know what the output looks like. Additionally, prerequisites (e.g., existing PCB stackup or trace definitions) are not mentioned. The description is incomplete for practical 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 input schema already explains all 6 parameters. The description does not add additional parameter-specific meaning or usage tips. Baseline score of 3 is appropriate as the schema handles parameter documentation.

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 explicitly states the tool calculates electromagnetic coupling between parallel PCB traces, lists specific computed quantities (even/odd mode impedances, coupling coefficient, crosstalk), and clarifies it is a pure calculation with no geometry generation. This clearly distinguishes it from sibling tools that create or modify geometry.

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 analytical coupling calculations without creating geometry, but it does not explicitly state when to use this tool versus alternatives like cst_pcb_differential_pair or cst_array_mutual_coupling. No usage exclusions or alternative tool references are provided.

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

cst_pcb_cpw_transitionA

Create a coplanar waveguide (CPW) to microstrip transition in CST Studio. Generates a tapered geometry that linearly tapers the center conductor width and gap over the transition length. Calculates CPW and microstrip impedances.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName for the transition structure
layerYesLayer name (e.g. 'Top')
componentNoCST component namePCB
epsilon_rNoSubstrate relative permittivity
height_mmYesSubstrate height to reference plane in mm
cpw_gap_mmYesCPW gap width in mm
cpw_width_mmYesCPW center conductor width in mm
transition_typeNoType of transitioncpw_to_microstrip
microstrip_width_mmYesMicrostrip trace width at the end of the transition in mm
transition_length_mmYesLength of the tapered transition in mm

TDQS

A3.8/5.0
Behavior3/5

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

No annotations are provided, so the description must cover behavioral aspects. It mentions generating a tapered geometry and calculating impedances, but does not disclose potential side effects, required permissions, or whether it modifies existing geometry or creates new objects.

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 three sentences long, front-loaded with the main action, followed by taper details and calculation. Every sentence adds value, no unnecessary 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?

Given the tool's complexity (10 parameters, transition design), the description covers the purpose and taper mechanism. It does not explain the output (no output schema) or the transition_type enum options, but it reasonably addresses the main behavior. Slightly more detail on output would improve completeness.

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 100% coverage with descriptions for each parameter. The description adds value by explaining that the center conductor width and gap are linearly tapered, directly relating to parameters like cpw_width_mm, cpw_gap_mm, transition_length_mm, and microstrip_width_mm. It also mentions impedance calculation, adding domain context 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 creates a CPW-to-microstrip transition with a tapered geometry, specifying the linear taper of center conductor width and gap over transition length, and mentions impedance calculation. It is distinct from siblings like cst_pcb_create_trace which creates generic traces.

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 cst_pcb_create_trace or cst_pcb_differential_pair. It does not mention prerequisites, complementary tools, or suitable scenarios.

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

cst_pcb_create_ground_planeA

Create a ground or power plane with optional cutouts (split planes, isolation slots) in CST Studio. Generates a solid copper brick and subtracts cutout regions.

ParametersJSON Schema
NameRequiredDescriptionDefault
layerYesLayer name (e.g. 'GND', 'PWR')
cutoutsNoOptional list of rectangular cutout regions
width_mmYesPlane width in mm (X dimension)
length_mmYesPlane length in mm (Y dimension)
z_positionNoZ position of the plane bottom surface in mm
thickness_mmNoCopper thickness in mm (default 0.035 for 1oz)

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 must cover behavioral traits. It explains the construction method (brick minus cutouts) but omits details like whether existing geometry is affected, if the plane is created on a specific layer, or if undo support exists. It carries the burden adequately but not thoroughly.

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 concise sentences front-load the core action and optional feature, with no filler. Every word adds value.

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 6 parameters with full schema and no output schema, the description is nearly complete. It explains the high-level process (brick + subtraction) and mentions optional cutouts. Lacks any mention of return values, but no output schema exists, so it's not required.

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 description's role in adding parameter meaning is minimal. The description adds context like 'split planes' and 'isolation slots' but does not detail individual parameters beyond what the schema already provides. 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 it creates a ground or power plane with optional cutouts, explaining the mechanism of generating a solid copper brick and subtracting cutout regions. This distinguishes it from sibling tools like cst_pcb_create_trace (creates traces) or cst_create_brick (generic brick).

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 when-not-to-use guidance is provided. While the description implies it's for PCB ground/power planes, it does not differentiate from other PCB creation tools (e.g., when to use this vs cst_pcb_create_trace) or mention prerequisites like having a stackup defined.

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

cst_pcb_create_stackupA

Create a PCB layer stackup in CST Studio. Generates brick geometry for each layer (signal, ground, power, dielectric) positioned vertically with correct materials. Returns total thickness and layer positions.

ParametersJSON Schema
NameRequiredDescriptionDefault
layersYesOrdered list of layers from top to bottom. Example 4-layer: signal-dielectric-ground-dielectric(core)-power-dielectric-signal
board_width_mmYesBoard width in mm (X dimension)
board_length_mmYesBoard length in mm (Y dimension)

TDQS

A4/5.0
Behavior3/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. It discloses that it generates brick geometry and positions layers vertically, but does not mention side effects like whether it requires an open project, if it overwrites existing stackups, or how it modifies the project tree. The behavioral disclosure is adequate 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 concise sentences with front-loaded purpose. Every sentence adds value with no fluff: the first states the verb-resource, the second details outputs. Perfectly 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 tool's complexity (multi-layer stackup with materials) and the fact that there is no output schema, the description adequately covers inputs (layers array, board dimensions) and outputs (thickness, positions). It could be more complete by mentioning that layers are created as 3D objects in the project tree, but overall it provides sufficient context 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?

Schema coverage is 100% with descriptions for all parameters. The description adds meaningful context beyond the schema by explaining that it generates brick geometry for each layer positioned vertically with correct materials and that it returns total thickness and layer positions. This adds value for an agent selecting 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 tool creates a PCB layer stackup, generates brick geometry for each layer, and returns total thickness and layer positions. It distinguishes itself from sibling tools like cst_pcb_create_ground_plane or cst_create_brick by specifying the unique function of layer stackup creation.

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 provide explicit guidance on when to use this tool versus alternatives, such as cst_pcb_import_gerber or cst_create_brick. It implies usage for stackup creation but lacks when-not or exclusionary language.

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

cst_pcb_create_traceA

Create a PCB trace (microstrip, stripline, coplanar waveguide, or grounded CPW) in CST Studio. Optionally calculates trace width from a target impedance using Hammerstad-Jensen (microstrip) or Cohn (stripline) formulas.

ParametersJSON Schema
NameRequiredDescriptionDefault
layerYesLayer name where the trace is placed (e.g. 'Top')
x_startNoX coordinate of trace start (mm)
y_startNoY coordinate of trace start (mm)
width_mmNoTrace width in mm. If impedance_target is specified, this is ignored and the width is calculated automatically.
directionNoTrace direction: 'x' for +X, 'y' for +Y, or angle in degrees from +X axis (e.g. '45')x
epsilon_rNoSubstrate relative permittivity. Required when impedance_target is given.
length_mmYesTrace length in mm
trace_typeYesType of transmission line
z_positionNoZ position of the trace bottom surface in mm. If omitted, defaults to 0 (top surface of the board).
impedance_targetNoTarget characteristic impedance in ohms. When specified, trace width is auto-calculated. Requires substrate_height_mm and epsilon_r.
copper_thickness_mmNoCopper thickness in mm (default 0.035 for 1oz)
substrate_height_mmNoSubstrate height between trace and reference plane (mm). Required when impedance_target is given.

TDQS

A3.8/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 of behavioral disclosure. It mentions the impedance calculation behavior and required parameters for that, but does not disclose potential side effects, failure modes, or what happens upon creation (e.g., trace appears in model, no return value).

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 with only two sentences, front-loading the core action and optional feature. Every word is essential and there is no 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?

Given the large number of parameters and complete schema coverage, the description is adequate. It covers the main purpose and optional behavior, though it could mention what the tool returns or that the trace is added to the project.

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 all parameters are documented in the schema. The description adds some context by naming the formulas used for width calculation, but overall it does not significantly enhance understanding 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 creates a PCB trace and lists the specific types (microstrip, stripline, coplanar waveguide, grounded CPW). It also mentions the optional impedance-based width calculation, distinguishing it from other PCB creation 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 provide explicit guidance on when to use this tool versus alternatives. While it mentions optional features, it lacks context on prerequisites or scenarios where other tools might be more appropriate.

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

cst_pcb_create_viaA

Create a PCB via (through, blind, or buried) in CST Studio. Generates the cylindrical via barrel with specified drill and pad dimensions. Pad and antipad diameters are validated and reported but the geometry covers the barrel only; add pads separately if needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYesVia X position in mm
yYesVia Y position in mm
nameNoVia name for the CST model (auto-generated if omitted)
end_zYesZ coordinate of the via end (bottom) in mm
start_zYesZ coordinate of the via start (top) in mm
via_typeNoVia typethrough
end_layerYesName of the ending layer (e.g. 'Bottom')
start_layerYesName of the starting layer (e.g. 'Top')
pad_diameter_mmNoAnnular pad diameter in mm
drill_diameter_mmNoDrill hole diameter in mm
antipad_diameter_mmNoAntipad (clearance) diameter in plane layers in mm

TDQS

A3.6/5.0
Behavior4/5

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

Without annotations, the description discloses key behavioral traits: only barrel geometry is created, pads added separately, and pad/antipad dimensions are validated and reported. This provides useful 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 concise with three sentences, each adding value. Front-loaded with the main purpose, no redundant 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 tool with 11 parameters and no output schema, the description explains core behavior and limitations but omits return values or error conditions. Adequate but not fully comprehensive.

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%, but the description adds context that pad and antipad diameters are validated but only the barrel is generated. This explains behavior beyond raw parameter descriptions, justifying above baseline.

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 creates a PCB via (through, blind, buried) and generates the barrel. It distinguishes from sibling tools like traces and ground planes by specifying via creation, though it does not explicitly differentiate from other via-related 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?

No explicit guidance on when to use this tool versus alternatives. The description implies use for via creation but lacks when-not or alternative recommendations.

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

cst_pcb_differential_pairB

Create a differential pair of PCB traces in CST Studio. Generates two parallel bricks separated by a gap and calculates the differential impedance using coupled-line theory (Zdiff = 2Z0(1-k)).

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesBase name for the differential pair (e.g. 'USB_DP')
layerYesLayer name (e.g. 'Top')
gap_mmYesGap between the two traces in mm
x_startNoX coordinate of the pair center start in mm
y_startNoY coordinate of the pair center start in mm
componentNoCST component namePCB
epsilon_rNoSubstrate relative permittivity
height_mmNoSubstrate height to reference plane in mm
length_mmYesTrace length in mm
trace_width_mmYesWidth of each trace in mm
target_impedance_diffNoTarget differential impedance in ohms

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 full burden. It discloses the creation and calculation behavior, but lacks details on side effects, required project state, destructiveness, or whether it modifies existing objects. Important traits like creating geometry in the active CST project are not mentioned.

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 concise with two sentences. The first sentence clearly states the main purpose, and the second adds relevant technical context. No superfluous content.

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 (11 parameters, no output schema) and the presence of many sibling tools, the description is insufficient. It does not explain what the tool returns (e.g., the impedance value or just geometry), nor does it mention any prerequisites like an open project or required prior steps.

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 described in the schema. The tool description does not add additional meaning beyond listing the parameters indirectly via the formula. 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 tool creates a differential pair of PCB traces, specifies the geometry (two parallel bricks separated by a gap), and mentions the impedance calculation. This distinguishes it from sibling tools like cst_pcb_create_trace (single trace) and other PCB structures.

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 a differential pair is needed, but does not explicitly state when to use this tool versus alternatives (e.g., single trace creation or other matching tools). No guidance on prerequisites or scenarios where this tool is not appropriate.

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

cst_pcb_import_gerberB

Import a Gerber/ODB++/DXF file for PCB analysis in CST Studio. Generates VBA for the CST Gerber import wizard. In offline mode, explains the import process and required settings.

ParametersJSON Schema
NameRequiredDescriptionDefault
file_pathYesPath to the Gerber file (.gbr, .ger, .gtl, .gbl, etc.)
file_typeNoImport file formatgerber
layer_nameYesTarget layer name in the CST model

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 adds some behavioral details (generates VBA, explains process in offline mode), but does not disclose important aspects like whether the operation is synchronous, if it modifies the project, error handling, or permissions 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?

Two sentences, front-loaded with the primary purpose. No wasted words; efficient and clear.

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 main functionality but could be more complete given the complexity of PCB import. Mentions VBA generation and offline mode, but lacks details on prerequisites, workflow, or what the VBA does.

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 already describes all parameters. The description does not add meaning beyond what the schema provides (file types, layer name), 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 action (import), the resources (Gerber/ODB++/DXF files for PCB analysis), and distinguishes from siblings like cst_import_cad and cst_import_touchstone by specifying the file types and mentioning VBA generation and offline mode.

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 vs alternatives (e.g., cst_import_cad, cst_import_touchstone). The mention of 'offline mode' is ambiguous and does not clarify usage context.

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

cst_pcb_list_stackup_templatesA

List predefined PCB stackup templates with complete layer definitions. Includes standard 2/4/6-layer FR-4 and RF-grade Rogers stackups. Use the returned layer data directly with cst_pcb_create_stackup.

ParametersJSON Schema
NameRequiredDescriptionDefault
filterNoOptional filter string to match template names (e.g. '4-layer', 'Rogers', 'RF'). Case-insensitive.

TDQS

A4.2/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 behavioral disclosure. It describes the tool as listing templates without side effects, but it does not mention prerequisites, performance, or whether the operation is read-only. The description is adequate for a simple retrieval but lacks deeper 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 two sentences long, front-loads the core purpose, and contains no redundant information. 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 mentions that returned data includes complete layer definitions and can be used with another tool, but with no output schema, it lacks details on the structure of the returned data. This is sufficient for a simple listing but could be more complete.

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?

The input schema has 100% coverage for the single parameter 'filter', but the description adds value by providing concrete examples ('4-layer', 'Rogers', 'RF') and stating case-insensitivity, which aids correct invocation.

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 it lists predefined PCB stackup templates with complete layer definitions and specifies the types (standard 2/4/6-layer FR-4 and RF-grade Rogers). It also mentions that the returned data can be used directly with cst_pcb_create_stackup, distinguishing 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 Guidelines4/5

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

The description explicitly tells the agent to use the returned layer data with cst_pcb_create_stackup, providing clear context for when to use this tool. However, it does not explicitly state when not to use it or mention alternatives, which is a minor gap.

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

cst_pcb_siw_waveguideB

Create a Substrate Integrated Waveguide (SIW) in CST Studio. Generates top and bottom copper planes with two rows of via fences forming the waveguide sidewalls. Calculates effective width, cutoff frequency, and guided wavelength using Cassivi et al. formulas.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesName for the SIW structure
layerYesLayer name (e.g. 'Top')
x_startNoX coordinate of the SIW start in mm
y_startNoY coordinate of the SIW start in mm
width_mmYesSIW width (center-to-center of via rows) in mm
componentNoCST component namePCB
epsilon_rNoSubstrate relative permittivity
height_mmNoSubstrate height in mm
length_mmYesSIW length in mm
via_pitch_mmYesCenter-to-center via spacing along the length in mm
via_diameter_mmYesVia drill diameter in mm

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 all behavioral traits. It mentions the structure generated and formulas used but does not describe side effects, permissions required, or whether the tool modifies existing objects. The description is insufficiently transparent for a complex 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 concise with two sentences: the first states the primary action, and the second provides key technical details. It is front-loaded and uses efficient language, though it could be slightly more structured 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 the tool has 11 parameters, no output schema, and no annotations, the description should provide more context. It lacks details on how the tool integrates with other CST processes, what it returns, or any assumptions about the simulation environment. This makes it incomplete 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 coverage is 100% with all parameters described, so the baseline is 3. The description adds minimal additional meaning beyond the schema, only noting that width is center-to-center and mentioning Cassivi formulas. It does not explain parameter relationships or provide deeper context.

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 creates a Substrate Integrated Waveguide (SIW) in CST Studio, with specific details about generating copper planes and via fences. This distinctly differentiates it from sibling tools like cst_pcb_create_trace or cst_pcb_via_fence, which serve different purposes.

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 SIW creation but provides no explicit guidance on when to use this tool versus alternatives, nor does it mention prerequisites or limitations. For a domain-specific tool, the context is clear but lacks exclusions or comparison.

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

cst_pcb_via_fenceA

Create a row (or multiple rows) of vias along a path for isolation or Substrate Integrated Waveguide (SIW) construction. Generates an array of cylinders from start to end point with specified spacing.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesBase name for the via fence
rowsNoNumber of parallel rows (1-3)
x_endYesX coordinate of the fence end in mm
y_endYesY coordinate of the fence end in mm
x_startYesX coordinate of the fence start in mm
y_startYesY coordinate of the fence start in mm
componentNoCST component namePCB
row_offset_mmNoLateral offset between rows for staggering in mm
via_spacing_mmYesCenter-to-center spacing between vias in mm
pad_diameter_mmYesVia pad diameter in mm
via_diameter_mmYesVia drill diameter in mm

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 carries full burden. It states it generates cylinders along a path, but lacks details on side effects, prerequisites, error handling, or impact on existing geometry. Basic behavior is covered but not deeply.

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, short and front-loaded. Some redundancy between sentences (both mention arrays of vias), but overall efficient.

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 11 parameters and no output schema, the description provides basic purpose and method but lacks usage guidance, behavioral constraints, and output details. Adequate for simple usage but incomplete for novice users.

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 baseline is 3. The description adds context about multiple rows and staggering, which are already in schema descriptions. No significant extra meaning beyond 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 creates a row of vias for isolation or SIW construction, with specific verb and resource. It distinguishes from sibling tools like cst_pcb_create_via which creates single vias, and other PCB geometry 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 mentions use cases (isolation, SIW) but does not explicitly state when to prefer this over alternatives or provide exclusion criteria. No direct comparison with sibling tools is given.

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

cst_pcb_via_modelB

Create a detailed PCB via model in CST Studio with parasitic inductance and capacitance estimates. Uses the Goldfarb model for via inductance and a simplified capacitance formula.

ParametersJSON Schema
NameRequiredDescriptionDefault
xYesVia X position in mm
yYesVia Y position in mm
nameYesVia name for the CST model
componentNoCST component namePCB
end_layerYesName of the ending (bottom) layer
epsilon_rNoSubstrate relative permittivity
start_layerYesName of the starting (top) layer
pad_diameter_mmYesAnnular pad diameter in mm
barrel_plating_umNoBarrel plating thickness in micrometers
drill_diameter_mmYesDrill hole diameter in mm
board_thickness_mmNoBoard thickness in mm
antipad_diameter_mmYesAntipad (clearance) diameter in mm

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 must fully disclose behavior. It mentions creating a model and estimating parasitics but omits side effects, prerequisites (e.g., existing stackup), whether it modifies existing models, and 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 concise with two sentences, no wasted words, and effectively communicates the core purpose and methodology.

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 12 parameters and no output schema, yet the description lacks information on return values, prerequisites, side effects, or how the model is integrated. This makes 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?

Schema coverage is 100%, so the baseline is 3. The description adds context about the models used but does not significantly augment the parameter meanings beyond the schema 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 clearly states it creates a detailed PCB via model with parasitic estimates, specifying the Goldfarb model for inductance and a simplified capacitance formula. This distinguishes it from sibling tools like cst_pcb_create_via which likely only create geometry.

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 detailed modeling with parasitics but does not explicitly state when to use this tool versus alternatives like cst_pcb_create_via. No when-to-use or when-not-to-use guidance is provided.

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

cst_project_infoA

Get information about the currently open CST project, including connection mode, project path, and status.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/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. It implies read-only behavior ('Get information') but does not explicitly state that no modifications are made, nor does it describe error handling (e.g., what happens if no project is open) or any 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 sentence of 16 words, directly stating the purpose. It is front-loaded with the key action and resource, avoiding any 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?

Given the lack of output schema and annotations, the description provides a reasonable list of output fields (connection mode, project path, status). However, it does not describe the return format (e.g., JSON structure) or potential error conditions. For a simple getter, this is mostly sufficient but could be slightly more comprehensive.

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?

The tool has no parameters, so there is no need for the description to add meaning beyond the input schema. Schema coverage is 100% trivially, and the description appropriately omits param 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 gets information about the currently open CST project, specifying the exact pieces of info (connection mode, project path, status). This distinguishes it from siblings like cst_connection_status or cst_get_simulation_status which focus on specific aspects.

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 provide guidance on when to use this tool versus alternative siblngs. While it's clear that this is for general project info, it lacks indications such as 'Use this for an overview; for specific status details, use cst_get_simulation_status'. No when-not-to-use or prerequisites are mentioned.

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

cst_project_treeB

List items in the CST project navigation tree. Optionally specify a subtree path such as 'Components', 'Materials', 'Ports', 'Monitors', or 'Results'.

ParametersJSON Schema
NameRequiredDescriptionDefault
tree_pathNoNavigation tree path to list, e.g. 'Components', 'Results', or '2D/3D Results'. Omit for the root tree.

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 states the tool lists items but does not mention expected behavior for invalid paths, whether the list is flat or hierarchical, or any side effects (likely none). The minimal disclosure leaves significant behavioral aspects unclear.

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 efficiently conveys the tool's function and optional parameter, making it easy to parse quickly.

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 has one optional parameter, no output schema, and many siblings, the description adequately covers the main purpose and provides concrete path examples. It is complete enough for a simple listing tool but could mention that the output is a list of sub-items (e.g., names) and behavior for non-existent paths.

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% as the single parameter 'tree_path' has a description. The description adds example values (e.g., 'Components', 'Materials') which are helpful but largely redundant with the schema description. The baseline of 3 is appropriate as the description provides marginal added 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 tool lists items in the CST project navigation tree with a specific verb ('List') and resource. It provides example subtree paths, distinguishing it from siblings that focus on specific item types (e.g., ports, materials) or actions (e.g., creating simulations). However, it could be more precise about the scope (e.g., 'contents of the entire tree').

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 exploring the project tree by offering an optional subtree path. It gives examples of valid paths but lacks explicit guidance on when to use this tool versus alternative listing tools like cst_list_materials or cst_list_ports, and no when-not-to-use scenarios.

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

cst_read_helpA

Read a paginated official local CST help topic returned by cst_search_help. No GUI or solver.

ParametersJSON Schema
NameRequiredDescriptionDefault
topicYes
offsetNo
max_charsNo

TDQS

A3.8/5.0
Behavior4/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 important behaviors: the help is 'paginated', 'official local' (implying offline/static), and 'No GUI or solver' indicates a headless, non-interactive, read-only operation. This is strong for a simple read tool, though it doesn't mention error handling or edge cases like invalid topics.

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 unnecessary words. The first sentence immediately states the action and resource, and the second delivers a crisp clarification. Every term 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 straightforward read operation, the description covers the main purpose and basic behavior. However, with no output schema and no annotations, it does not specify the return format (e.g., plain text, formatting), how pagination parameters interact, or failure modes. This leaves some gaps an agent might need to guess.

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 0%, so the description must compensate. It adds only the concept of pagination and hints that `topic` comes from `cst_search_help`, but it does not explain the meaning or format of `topic`, `offset`, or `max_chars` beyond what the schema already shows (type/defaults). Thus it provides minimal additional value for parameter understanding.

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 ('Read') and a precise resource ('official local CST help topic'), and explicitly ties it to cst_search_help, which distinguishes it from that sibling. The phrase 'No GUI or solver' further clarifies that this is a direct, headless read operation, differentiating it from simulation or interactive 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 implies a workflow: first use cst_search_help to obtain a topic, then call this tool to read it. However, it does not explicitly state when to use this tool over alternatives or provide exclusion criteria (e.g., 'use cst_vba_help for VBA-specific help'). The guidance is contextual but not fully explicit.

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

cst_read_project_logA

Read solver log files and project status information from the current CST project. Returns solver running state and the contents of the most recent log file. Useful for diagnosing solver errors, checking simulation progress, and understanding what happened during a failed run.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

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 bears the full burden of behavioral disclosure. It states that the tool returns solver running state and log file contents, but does not address edge cases, authentication requirements, or potential side effects. Given it is a read-only operation, the description is adequate 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 concise, consisting of two clear sentences that provide essential information without redundancy. Every sentence adds value: the first defines the action, the second explains utility.

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 simple read tool with no parameters and no output schema, the description fully covers what the tool does, what it returns, and its typical use cases. It mentions both the running state and log file contents, which is sufficient for an agent to understand the tool's functionality.

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, so there is no parameter information to add beyond what the schema provides. According to guidelines, this merits a baseline score of 4, and the description appropriately does not attempt to describe nonexistent 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 tool reads solver log files and project status information from the current CST project, specifying it returns solver running state and the most recent log file contents. This distinctively differentiates it from sibling tools like cst_get_solver_info or cst_get_simulation_status, which may return different data.

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 suggests it is useful for diagnosing solver errors and checking simulation progress, implying when to use it. However, it does not provide explicit guidance on when not to use it or contrast it with similar tools such as cst_get_solver_info or cst_get_result_summary.

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

cst_read_saved_resultA

Read a complete complex 1D curve by exact tree path and run_id from a completed saved .cst, without opening CST. Raw real/imag are preserved; format adds derived values. max_points=0 returns all samples; otherwise returns an explicitly sampled preview.

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNoreal_imag
run_idNo
tree_pathYes
max_pointsNo
project_pathYes

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 and largely meets it: it discloses that reading happens without opening CST, raw real/imag values stay unchanged while format adds derived values, and max_points controls whether all samples or a sampled preview are returned. It could go further by describing error behavior for missing paths or run_ids, but the disclosed behaviors are meaningful and not hidden.

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?

Three compact sentences, front-loaded with the core action first, then the key behavioral nuances. No filler or repetition of schema defaults; 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?

For a five-parameter tool with no output schema and no annotations, the description should clarify return structure, but it only says a curve is read and mentions samples without stating the returned fields or shape. It covers core semantics and sampling behavior adequately, yet an agent still lacks a complete picture of what the call returns.

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 0%, so the description must compensate, and it does for two parameters: max_points (0 means all samples) and format (adds derived values over raw real/imag). However, tree_path format, project_path meaning, run_id semantics, and the format enum values are left unexplained, leaving gaps for required and optional 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 names a specific verb ('Read'), a specific resource ('complete complex 1D curve'), and the exact addressing mechanism ('tree path and run_id' from a completed saved .cst). It also distinguishes itself from heavier workflows by adding 'without opening CST', making it easy for an agent to tell apart from related tools like cst_list_saved_results or cst_get_s_parameters.

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 conveys a clear context: use this when a saved .cst already has completed results and you need an exact curve without launching CST. It implies prerequisites (completed save, exact tree path, run_id) but does not explicitly name alternatives or state when not to use it.

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

cst_refine_antennaA

Run an automated Nelder-Mead optimization loop to tune CST design parameters toward VSWR goals across specified frequency bands. Each iteration sets parameters, runs the solver, exports S11, and evaluates against targets. Uses silent VBA execution to avoid history bloat. Applies the best parameters permanently at the end. Connected mode only — requires a live CST session with a solvable project.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNoPort number (default: 1).
bandsYesFrequency bands with VSWR targets.
parametersYesParameters to optimize with initial values and bounds.
max_iterationsNoMaximum optimization iterations (default: 20).

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description carries full burden and does well: it discloses the use of Nelder-Mead, each iteration's steps (set parameters, run solver, export S11, evaluate), silent VBA execution to avoid history bloat, permanent application of best parameters, and connectivity requirement. Missing details on failure handling (e.g., optimization failure, state reversion) prevent a higher 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 concise at 5 sentences, each sentence adds value, and the most important information (purpose) is front-loaded. 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?

Given the tool's complexity (4 parameters, nested objects, no output schema), the description covers the optimization process, silent execution, permanent update, and connectivity requirement. However, it does not describe what the tool returns (e.g., optimized parameters, success status), which is needed since no output schema exists. This gap prevents a score of 5.

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 baseline is 3. The description adds no new information about parameters beyond what the schema provides. It explains the overall process but does not detail how each parameter (port, bands, parameters, max_iterations) affects the optimization, nor does it provide usage examples or constraints.

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 a Nelder-Mead optimization loop to tune CST design parameters toward VSWR goals across specified frequency bands. It specifies the verb ('run'), resource ('CST design parameters'), and goal ('VSWR goals'), and distinguishes itself from sibling tools like cst_optimizer by being specialized for antenna VSWR tuning.

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 mentions the prerequisite of 'Connected mode only — requires a live CST session with a solvable project,' providing clear context on when the tool can be used. However, it does not provide guidance on when to prefer this tool over other optimizers (e.g., cst_optimizer) or when not to use it, which is a minor gap.

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

cst_resume_simulationB

Resume a previously paused CST simulation. Use after cst_pause_simulation to continue from where it stopped.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeout_sNo

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 full behavioral disclosure. It only states the core action and the prerequisite but omits any side effects, error conditions, whether the call is synchronous, or what the timeout parameter does. For a control tool, this is a significant gap in transparency.

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 succinct and front-loaded, with two sentences that state the purpose and the prerequisite without fluff. It is appropriately sized for a simple tool, though it could be slightly more informative without sacrificing 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's simplicity, the description is incomplete: it does not explain the timeout_s parameter, does not describe return values (since there is no output schema), and does not mention any error behavior or prerequisites beyond a paused simulation. An agent would be uncertain about how to invoke it correctly in edge cases.

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 does not mention the timeout_s parameter at all, and the schema description coverage is 0%, meaning the schema also provides no explanation. The parameter's purpose is entirely opaque, so the description fails to add any semantic value beyond the bare 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 ('Resume a previously paused CST simulation') and the resource, making it distinct from simulation control siblings like cst_run_simulation and cst_stop_simulation. It also names the prerequisite tool (cst_pause_simulation), so an agent can immediately identify its role.

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 gives an explicit usage condition ('Use after cst_pause_simulation') and implies the context where the tool is applicable. It does not explicitly mention when not to use it, but the prerequisite is clear enough for an agent to infer that it is only for resuming, not for starting or stopping.

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

cst_run_simulationA

Start a CST simulation with the current solver settings. This is a blocking call that waits for the simulation to complete. Use cst_run_simulation_async for long-running simulations.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeout_sNoMaximum CST Python API call duration in seconds.
solver_typeNoSolver type to use. If omitted, the currently configured solver is used. Options: 'Time Domain', 'Frequency Domain', 'Eigenmode', 'Integral Equation'.

TDQS

A4.4/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 full burden of behavioral disclosure. It clearly states the blocking behavior ('waits for the simulation to complete'), which is a critical behavioral trait. However, it doesn't mention potential side effects (e.g., modifying the project state, creating result files) or whether it requires an active connection/project. The blocking disclosure is strong, but a bit more context on prerequisites or side effects would push it to 5.

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 sentences with zero waste. The core action is front-loaded, and the critical behavioral trait (blocking) and alternative routing are included. Every sentence 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 blocking simulation tool with no output schema, the description covers the main behavioral trait (blocking) and the alternative for long-running simulations. It doesn't mention what happens after completion (e.g., results retrieval via cst_get_s_parameters) or prerequisites like an active project/connection, but the sibling list and schema provide some context. The description is largely complete for the tool's core purpose, with minor gaps around prerequisites and post-conditions.

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 (timeout_s and solver_type) with descriptions. The description adds no additional parameter semantics beyond what the schema provides. Baseline 3 is appropriate since the schema does the heavy lifting.

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: 'Start a CST simulation with the current solver settings.' It uses a specific verb ('Start') and resource ('CST simulation'), and explicitly distinguishes itself from the async variant by name. This makes it easy for an agent to understand what the tool does and how it differs from its sibling.

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

Usage Guidelines5/5

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

The description provides explicit usage guidance: 'This is a blocking call that waits for the simulation to complete. Use cst_run_simulation_async for long-running simulations.' This tells the agent when to use this tool (short simulations) and when to use the alternative (long-running simulations), which is exactly what the dimension requires.

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

cst_run_simulation_asyncA

Start a CST simulation asynchronously (non-blocking). The simulation launches and control returns immediately. Use cst_get_simulation_status to monitor progress.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeout_sNoMaximum CST Python API start-command duration in seconds.
solver_typeNoSolver type to use. If omitted, the currently configured solver is used. Options: 'Time Domain', 'Frequency Domain', 'Eigenmode', 'Integral Equation'.

TDQS

A3.9/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 correctly discloses the non-blocking behavior and immediate return of control. However, it does not mention what happens if the start command fails, whether a simulation can only be started once a project is open, or what the tool returns upon success, 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 tight sentences with no filler. The key non-blocking behavior is front-loaded, and the monitoring pointer is added in the second sentence without 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?

There is no output schema, so the description must explain enough context for correct invocation. It covers launch semantics and monitoring, which is good. However, it omits return-value behavior and error/failure handling for the launch itself, so an agent is left guessing what the immediate result of calling this tool is beyond 'control returns immediately. This is a clear completeness gap for a tool with 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?

The input schema already documents both parameters fully, with 100% schema description coverage and a clear enum for solver_type. The 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 states a specific verb and resource: 'Start a CST simulation asynchronously (non-blocking).' It immediately distinguishes itself from the synchronous sibling cst_run_simulation by emphasizing that control returns immediately. This makes the tool's role 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 gives clear context that this launches and returns immediately, and it explicitly directs the agent to use cst_get_simulation_status for monitoring. It does not explicitly name cst_run_simulation as the alternative for blocking execution or state when to prefer one over the other, but the async/non-blocking framing makes the intended usage clear.

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

cst_save_projectA

Save the currently open CST project. Optionally provide a new path to 'Save As'.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathNoOptional file path for 'Save As'. If omitted, saves to the current project path.

TDQS

A4/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 fails to mention whether overwriting occurs without confirmation, if the project must have a current path for normal saves, or any side effects like updating internal state. Basic save operation details are missing.

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 sentences with the verb and resource front-loaded. Every word is functional; no redundancy or filler.

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 one-parameter tool with no output schema, the description covers the essential scenario. It could be improved by noting return behavior (e.g., throws on failure), but overall it is complete enough for the tool's complexity.

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 parameters, so baseline is 3. The description adds value by explaining that omitting 'path' uses the current project path, which clarifies the parameter's behavior beyond the schema's type/description alone.

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 resource ('the currently open CST project') with specific differentiation for 'Save As' via optional path. This distinguishes it from siblings like cst_open_project or cst_export_project.

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 implicitly indicates usage when the current project needs saving or saving to a new location. However, it does not explicitly exclude use cases like closing without saving or exporting to other formats, leaving some ambiguity among siblings.

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

cst_search_helpA

Search the installed official CST Python/VBA help by topic filename. Does not start CST. Read the matching help before constructing API calls.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
queryYes

TDQS

A4.4/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 clearly states the tool is a read-only search operation ('Does not start CST'), which is a key behavioral trait. It also discloses that it searches 'by topic filename,' which sets expectations about the query format. It could add more detail about what the search returns (e.g., file paths, snippets), but the core behavioral profile is well covered.

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 sentences with zero waste. The first sentence states the action and scope; the second sentence adds the critical behavioral note and the usage directive. Every word earns its place, and the most important information is front-loaded.

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 search tool with 2 parameters and no output schema, the description is largely complete. It covers the purpose, the key behavioral trait (no CST launch), and the usage directive. The main gap is the lack of detail about the return format and the exact matching semantics of the query parameter, but these are minor for a search tool of this 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?

Schema description coverage is 0%, so the description must compensate for the schema's lack of parameter documentation. The description explains that 'query' is a topic filename, which adds meaning beyond the schema's bare 'query' string. However, it does not explain the 'limit' parameter's semantics beyond the schema's default/max/min values, nor does it clarify whether the query is a partial match, exact filename, or regex. The description adds some value but leaves gaps.

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 ('Search'), a specific resource ('installed official CST Python/VBA help'), and a specific scope ('by topic filename'). It also explicitly says it does not start CST, which distinguishes it from tools that launch the application. This is a clear, non-tautological statement that an agent can act on.

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

Usage Guidelines5/5

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

The description explicitly instructs the agent to 'Read the matching help before constructing API calls,' which is a clear directive on when to use this tool. It also implicitly distinguishes it from cst_read_help (which presumably reads a specific help file) by focusing on searching by topic filename. The 'Does not start CST' note further clarifies when it is safe to use without side effects.

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

cst_sensitivity_analysisA

Set up a one-at-a-time sensitivity analysis to rank parameters by their impact on a result. Varies each parameter individually while keeping others at nominal values.

ParametersJSON Schema
NameRequiredDescriptionDefault
parametersYes
result_pathYesResult tree path to monitor.

TDQS

A3.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 full burden. It only says 'set up', which suggests configuration but not execution, and does not disclose side effects, return values, or whether it runs a simulation. This is insufficient behavioral detail.

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 efficient sentences with no wasted words. The key information is front-loaded and actionable.

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 an output schema, the description should hint at return values or whether the analysis is executed. It lacks details on what happens after setup (e.g., ranking, simulation trigger). Given the tool's complexity (array parameters, analysis setup), the description is incomplete.

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 description adds meaning beyond the schema by explaining that parameters are varied individually and result_path is the monitored result. It contextualizes the nominal and perturbation fields, although the schema already partially describes result_path and perturbation_pct.

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 up a one-at-a-time sensitivity analysis to rank parameter impact, with a specific method (varying each individually). The name and sibling tools make the purpose distinct from sweeps or optimization.

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 sensitivity analysis but does not specify when to use this versus alternatives like cst_parameter_sweep or cst_optimizer. No exclusions or when-not guidance is provided.

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

cst_set_adaptive_meshA

Configure adaptive mesh refinement. When enabled, the solver runs multiple passes, refining the mesh in regions of high field gradient until the result converges within the specified threshold.

ParametersJSON Schema
NameRequiredDescriptionDefault
enabledNoEnable or disable adaptive meshing (default true)
thresholdNoConvergence threshold in dB — stop when S-parameter change is below this (default 0.02)
max_passesNoMaximum number of adaptive mesh refinement passes (default 3)

TDQS

A3.8/5.0
Behavior3/5

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

Description explains that the solver runs multiple passes, refines in high-gradient regions, and converges within threshold. However, it does not mention that it stops after max_passes even if not converged, which is a key behavior. With no annotations, this 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?

Two sentences: first states purpose, second explains the mechanism. Every word earns its place. No extraneous text.

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 configuration tool with 3 optional parameters and no output schema, the description covers the core functionality. Lacking context of its role in the simulation setup sequence is a minor gap, but overall 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?

Schema coverage is 100%, so baseline is 3. The description adds minimal semantic value beyond the parameter descriptions, only framing the behavior with 'when enabled'. No additional context for each parameter.

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 configures adaptive mesh refinement, a specific and distinct function among siblings. The verb 'configure' and resource 'adaptive mesh refinement' are precise. No tautology.

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 adaptive refinement is desired but does not explicitly state when to use this tool versus alternatives like cst_add_mesh_refinement or cst_set_mesh_type. No 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.

cst_set_backgroundA

Set the background material properties of the simulation domain. The background fills all space not occupied by defined solids.

ParametersJSON Schema
NameRequiredDescriptionDefault
muNoRelative permeability (default 1.0, used when material is Normal)
epsilonNoRelative permittivity (default 1.0, used when material is Normal)
materialNoBackground material type (default Normal)Normal

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. It does not mention whether calling the tool overwrites existing settings, requires specific permissions, or has any side effects. This is inadequate for a tool that modifies simulation state.

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 sentences, no fluff, front-loaded with the action. Every word serves a purpose.

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 3 parameters and no output schema, the description is minimal but covers the basic purpose. It lacks details on parameter dependencies (e.g., when mu/epsilon are used) and the effect of omitting parameters (defaults).

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 description adds no extra meaning to parameters beyond what is already in the schema (mu, epsilon, material with defaults and enums). The description does not clarify how parameters interact (e.g., mu/epsilon ignored for PEC/PMC).

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 the background material properties') and the scope ('fills all space not occupied by defined solids'), which distinguishes it from sibling tools that deal with material assignment to objects.

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 guidance on when to use this tool versus alternatives like cst_create_material or cst_assign_material. The description implies it is used before defining solids, but does not state exclusions or prerequisites.

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

cst_set_boundaryB

Set boundary conditions for the simulation domain. Each face of the bounding box can be assigned an independent boundary type (open, electric, magnetic, periodic, etc.).

ParametersJSON Schema
NameRequiredDescriptionDefault
x_maxYesBoundary condition on the +X face
x_minYesBoundary condition on the -X face
y_maxYesBoundary condition on the +Y face
y_minYesBoundary condition on the -Y face
z_maxYesBoundary condition on the +Z face
z_minYesBoundary condition on the -Z face

TDQS

B3.3/5.0
Behavior3/5

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

Without annotations, the description carries the full burden. It mentions independent boundary types per face, but does not disclose that this overrides previous settings, require an existing simulation domain, or any side effects. Adequate but not thorough.

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 sentences: the first states the core purpose, the second expands on the parameter semantics. Each sentence earns its place with no extraneous 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?

The description covers the basic purpose and parameter independence, but does not explain the meaning of boundary types (e.g., open vs expanded open) or any broader simulation context. No output schema exists, so return values are unaddressed. Adequate for a moderately complex 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 coverage is 100% with enum values and descriptions for all 6 parameters. The description reiterates the enum values ('open, electric, magnetic, periodic') but adds the context that each face is independent. This adds modest value beyond the schema, achieving the baseline of 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 'Set boundary conditions for the simulation domain' with a specific verb and resource. It also mentions that each face can have an independent boundary type. Although it does not explicitly differentiate from sibling tools like 'cst_set_periodic_boundary', the domain-wide scope 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 compared to alternatives (e.g., cst_set_periodic_boundary for periodic boundaries only). No prerequisites or exclusions are mentioned, leaving the agent to infer usage context.

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

cst_set_floquet_port_advancedA

Configure advanced Floquet port settings for periodic structures. Controls the number of Floquet modes and scan angle for phased array element simulation and oblique incidence analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault
num_modesNoNumber of Floquet modes (2-20, default 2)
scan_phi_degNoScan azimuth angle in degrees (default 0)
scan_theta_degNoScan elevation angle in degrees (default 0)

TDQS

A3.5/5.0
Behavior2/5

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

No annotations provided, so description carries full burden. It does not disclose behavioral traits like prerequisites (e.g., existing Floquet port), side effects, or error handling. Users are left unsure if this modifies an existing port or creates new settings.

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 sentences, front-loaded with purpose, no fluff. Every sentence adds value. Appropriate length and structure.

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 full schema coverage and lack of output schema, description covers purpose and parameters. However, it lacks context on prerequisites (e.g., existence of a Floquet port) and return values, which are important for a configuration 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?

Input schema has 100% coverage with descriptions for all three parameters. Description mentions they control modes and scan angle but adds no extra meaning beyond 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?

Description clearly states the verb 'Configure' and resource 'advanced Floquet port settings'. It distinguishes from sibling tools like 'cst_add_floquet_port' by focusing on advanced settings. Mentions specific controls (number of modes and scan angle) and context (periodic structures, phased array).

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?

Description implies this tool is for advanced configuration after adding a Floquet port, but does not explicitly state when to use it vs alternatives. Siblings include basic port creation, so guidance on sequencing or prerequisites would improve clarity.

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

cst_set_frequency_rangeB

Set the simulation frequency range in GHz. This determines the bandwidth over which the solver computes results.

ParametersJSON Schema
NameRequiredDescriptionDefault
f_maxYesMaximum frequency in GHz
f_minYesMinimum frequency in GHz

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 of behavioral disclosure. It only states that the tool 'determines the bandwidth over which the solver computes results', but fails to mention any side effects, required sequence, or potential impact on existing settings. The description is 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 extremely concise with two sentences. The first sentence front-loads the action, and the second adds context. Every word is necessary, and there is no 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?

For a simple two-parameter tool, the description is adequate but lacks additional context such as whether this setting is persistent, if it can be called multiple times, or any preconditions. Given the absence of an output schema and annotations, a score of 3 reflects a minimum viable 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?

Schema coverage is 100%, with both parameters described as 'Minimum/Maximum frequency in GHz'. The description does not add any semantic 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.

Purpose5/5

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

The description clearly states the verb 'Set' and the resource 'simulation frequency range', specifying units in GHz. It is distinct from sibling tools like cst_set_mesh_density or cst_set_boundary, 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 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, such as whether it should be called before setting ports or running a simulation, or if there are prerequisites. No exclusion criteria or context is given.

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

cst_set_mesh_densityA

Set global mesh density parameters controlling automatic mesh generation. Higher cells_per_wavelength gives finer mesh and better accuracy at the cost of longer simulation time.

ParametersJSON Schema
NameRequiredDescriptionDefault
min_cellsNoMinimum number of mesh steps across any structure (default 5)
ratio_limitNoMaximum ratio between adjacent mesh cells (default 20)
cells_per_wavelengthNoNumber of mesh cells per wavelength (default 15)

TDQS

A3.6/5.0
Behavior3/5

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

The description adds some behavioral context by explaining the accuracy-performance trade-off, but with no annotations, it misses details such as whether settings are overwritten, if mesh regeneration is required, or other 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 concise (two sentences) and front-loaded: first sentence states purpose, second adds a key trade-off. No unnecessary 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?

Given no output schema and no annotations, the description adequately covers the tool's role and the main parameter's effect. It could be improved by referencing when to use this tool vs other mesh-related 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?

Schema covers 100% of parameters with descriptions; the description adds value only for cells_per_wavelength by explaining its effect. This meets the baseline of 3 for high schema coverage with minimal additional insight.

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 ('global mesh density parameters controlling automatic mesh generation'), effectively distinguishing it from sibling tools like cst_add_mesh_refinement or cst_set_mesh_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 lacks explicit guidance on when to use this tool vs alternatives. While it mentions the trade-off for cells_per_wavelength, it does not compare to other mesh tools or provide context for when settings should be adjusted.

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

cst_set_mesh_typeA

Set the mesh type for the simulation. Hexahedral is used for time-domain, Tetrahedral for frequency-domain, Surface for integral-equation, and Hexahedral TLM for TLM solver.

ParametersJSON Schema
NameRequiredDescriptionDefault
mesh_typeYesType of mesh to use

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 full burden of behavioral disclosure. It explains the mapping of mesh types to solvers but does not disclose side effects (e.g., whether this call can be made multiple times, if it resets other mesh settings, or if a project must be open). This is adequate but not comprehensive.

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 purpose, and the second explains the mapping. 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?

Given the tool's simplicity (one required parameter, no output schema), the description is fairly complete. It explains the parameter's values and their implications. However, it could mention whether the tool can be called multiple times or if there are prerequisites like an open project, but these are minor gaps.

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?

The input schema already has 100% coverage with a description for the 'mesh_type' parameter. The description adds significant value by explaining each enum value's meaning in the context of solver domains, which is beyond the schema's simple 'Type of mesh to use' 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 purpose: setting the mesh type for the simulation. It goes beyond a simple verb+resource by providing a mapping of each mesh type to its corresponding solver domain (e.g., Hexahedral for time-domain, Tetrahedral for frequency-domain), which distinguishes it from sibling tools that set other simulation parameters.

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 on when to use each mesh type by associating them with different solver domains (time-domain, frequency-domain, integral-equation, TLM). However, it does not explicitly state when not to use this tool or mention alternative mesh-related tools like cst_set_mesh_density, so it lacks explicit exclusions.

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

cst_set_parameterA

Set or create a design parameter in CST Studio. Parameters can hold numeric values or string expressions referencing other parameters.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesParameter name (e.g. 'patch_length', 'substrate_h').
valueYesParameter value — a number (e.g. 10.5) or a string expression referencing other parameters (e.g. 'patch_length / 2').
descriptionNoOptional human-readable description of the parameter.

TDQS

A3.6/5.0
Behavior2/5

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

With no annotations, the description must fully disclose behavioral traits. It notes that values can be numeric or string expressions, but fails to mention side effects like triggering recomputation, requirement of an open project, or that setting a parameter may invalidate previous results.

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 at two sentences, with no redundant information. The key action ('Set or create a design parameter') is front-loaded, and every word adds value.

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 (3 parameters, no output schema) and the existence of sibling tools covering other parameter operations, the description covers the core functionality well. It could mention the optional 'description' parameter and whether the tool returns a result, but overall is sufficiently 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 covers 100% of parameters with descriptions, establishing a baseline of 3. The description adds value by elaborating that 'value' can be a numeric or a string expression referencing other parameters, and provides concrete examples for 'name' (e.g., 'patch_length'). This enhances semantic clarity 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's verb ('Set or create') and resource ('design parameter'). It distinguishes from sibling tools like cst_get_parameter, cst_delete_parameter, and cst_list_parameters, which perform different actions.

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., when to update vs create, or prerequisites like having an open project). No 'when not to use' or explicit context is given.

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

cst_set_periodic_boundaryB

Configure periodic boundary conditions with optional phase shift for unit cell simulation. Sets X and Y boundaries to periodic and configures the phase shift for infinite array, FSS, and metasurface analysis.

ParametersJSON Schema
NameRequiredDescriptionDefault
phase_x_degNoPhase shift in X direction in degrees (default 0)
phase_y_degNoPhase shift in Y direction in degrees (default 0)

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 should disclose behavioral traits. It only states that it sets X and Y boundaries to periodic and configures phase shift, but does not mention any side effects, prerequisites (e.g., required solver, open project), or limitations (e.g., Z boundary unchanged). This is minimal 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?

Two sentences, front-loaded with core purpose, then context. No filler, every sentence adds value.

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-param tool with no output schema, the description covers the main action. However, it could be more complete by noting that only X and Y are affected, or that no required parameters exist. Currently 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% with descriptions for both parameters (phase_x_deg, phase_y_deg). The description adds only 'optional phase shift' which is vague; no additional meaning like typical ranges or usage tips beyond schema. Baseline 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?

Description uses specific verb 'configure' and resource 'periodic boundary conditions', and mentions use case (unit cell simulation, FSS, metasurface). However, it does not explicitly differentiate from closely related sibling like cst_set_boundary, which could also set periodic boundaries without phase shift.

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 vs alternatives. The description implies use for periodic boundaries with phase shift but does not state when not to use or provide alternative tool names. Given many sibling tools, this is a gap.

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

cst_set_pml_propertiesA

Configure PML (Perfectly Matched Layer) absorbing boundary properties. Controls the number of absorbing layers and the target reflection level for fine-tuning radiation boundary accuracy.

ParametersJSON Schema
NameRequiredDescriptionDefault
num_layersNoNumber of PML layers (4-12, default 4)
reflection_level_dbNoTarget reflection level in dB (-80 to -20, default -40)

TDQS

A3.6/5.0
Behavior2/5

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

No annotations provided; description only states basic functionality without disclosing behavioral traits such as whether it overwrites previous PML settings, dependencies on boundary type, or 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?

Two succinct sentences with front-loaded action verb and no superfluous information, earning 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 configuration tool with two well-documented parameters and no output schema, the description is sufficiently complete, though it lacks mention of return behavior or persistence.

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 clear default values and ranges; description adds minimal context ('fine-tuning accuracy') beyond schema, so baseline score 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 specifies verb 'Configure' and resource 'PML absorbing boundary properties', clearly distinguishing from sibling tools like cst_set_boundary which handle general boundaries.

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?

Description implies usage context (fine-tuning radiation boundaries) but provides no explicit when-to-use or when-not-to-use guidance compared to alternatives like cst_set_boundary.

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

cst_set_symmetryA

Set symmetry planes to reduce computation time. Each axis can be assigned electric or magnetic symmetry, or none. Requires the model geometry and excitation to be compatible with the chosen symmetry.

ParametersJSON Schema
NameRequiredDescriptionDefault
x_planeNoSymmetry condition on the YZ plane (default none)none
y_planeNoSymmetry condition on the XZ plane (default none)none
z_planeNoSymmetry condition on the XY plane (default none)none

TDQS

A4/5.0
Behavior3/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 tool sets symmetry planes and lists options, but does not mention side effects, reversibility, or impact on other project settings. The compatibility requirement is noted, but more detail on consequences would improve 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 concise with two sentences, no redundant words, and the key information is front-loaded. Every sentence contributes meaning.

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 has only three parameters (all enumerated) and no output schema, the description covers the purpose, usage requirement, and parameter options adequately. It does not detail the return value (likely void), but for a simple setting tool this is acceptable.

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 description coverage is 100%, so the baseline is 3. The description adds value by explaining the purpose of symmetry (reducing computation time) and the compatibility constraint, which goes beyond the schema's per-parameter descriptions. This additional context justifies a higher 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 clearly states the tool's action ('set symmetry planes') and purpose ('reduce computation time'), and specifies the available options (electric, magnetic, none). It distinguishes itself from sibling tools by focusing on symmetry settings, which is a unique function among the listed 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 provides a prerequisite ('requires model geometry and excitation to be compatible') but does not explicitly state when to use this tool versus alternatives (e.g., boundary conditions or other symmetry methods). No guidance on when not to use it is given.

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

cst_start_dialog_watcherA

Start a background thread that automatically detects and dismisses CST dialog windows as they appear. Essential for long-running operations like optimization loops where dialogs would otherwise block execution. The watcher logs every dialog it dismisses — retrieve the log with cst_stop_dialog_watcher.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/5.0
Behavior4/5

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

With no annotations provided, the description fully carries the burden of behavioral disclosure. It states the watcher runs in a background thread, automatically detects and dismisses CST dialog windows, and logs each dismissal. It does not mention potential side effects (e.g., performance impact), but the core behavior is well-covered.

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 that efficiently convey purpose, usage context, and a reference to the complementary tool. Every word adds value.

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?

Given the tool has no parameters, no output schema, and is a straightforward start action, the description provides complete context: what it does, when to use it (long-running ops), and what the output is (a log retrievable via another tool). No missing information.

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, and schema coverage is 100%, so the description needs no parameter details. The baseline for 0 parameters is 4, which 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 uses a specific verb ('start') and resource ('dialog watcher'), and distinguishes itself from the sibling tools 'cst_stop_dialog_watcher' (complementary) and 'cst_dismiss_dialogs' (one-time action) by noting it runs in the background for long-running operations.

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 states when to use the tool ('essential for long-running operations like optimization loops where dialogs would otherwise block execution') and references the complementary tool 'cst_stop_dialog_watcher' for retrieving logs. It does not provide explicit when-not-to-use scenarios, but the context is clear.

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

cst_stop_dialog_watcherA

Stop the background dialog watcher and return its log of all dialogs that were auto-dismissed. Use after completing an operation that required the watcher.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.4/5.0
Behavior4/5

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

With no annotations, the description covers the key behavior—stopping the watcher and returning a log. It does not elaborate on side effects like log clearing, but the action is straightforward and sufficiently disclosed.

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 consists of two concise, front-loaded sentences. Every sentence adds value: first states what it does, second provides usage timing. No 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?

Given the tool has no parameters, no output schema, and is a simple stop action, the description is adequate. It could optionally detail the log format, but the current info is sufficient for an agent to understand its role.

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 no parameters, so schema coverage is trivially 100%. The description adds no parameter details, which is acceptable since 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 tool stops a background dialog watcher and returns its log. It identifies a specific resource and action, and distinguishes from siblings like cst_start_dialog_watcher and cst_dismiss_dialogs.

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 explicit usage context: 'Use after completing an operation that required the watcher.' This implies it should be called after starting the watcher, but it does not explicitly mention when not to use or compare to alternatives.

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

cst_stop_simulationA

Stop and abort a running CST simulation. Unlike pause, a stopped simulation cannot be resumed — it must be restarted from the beginning.

ParametersJSON Schema
NameRequiredDescriptionDefault
timeout_sNo

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 behavioral disclosure. It states the key behavioral trait that stopping is irreversible (unlike pause), which is important. However, it doesn't mention potential side effects like whether results are discarded, or if there are any prerequisites (e.g., simulation must be running). 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 two sentences, both concise and to the point. The core action is front-loaded, and the critical distinction from pause is provided 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?

Given the tool's simplicity (1 optional parameter, no output schema), the description covers the main purpose and the irreversibility. However, the timeout_s parameter is unexplained, and there's no mention of what happens to partial results. For a simple tool, this is reasonable but has minor gaps.

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 has only one parameter, timeout_s, with 0% coverage in the description. The description does not explain the purpose of timeout_s (e.g., how long to wait for the stop operation to complete). With such low schema coverage, the description should have explained this parameter, but it doesn't.

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 abort') and the resource ('a running CST simulation'). It distinguishes itself from pause by explicitly noting that a stopped simulation cannot be resumed. This differentiates it from the sibling tool cst_pause_simulation.

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 implicitly indicates when to use this tool (when you need to abort a simulation) and contrasts with pause, but it doesn't explicitly state when NOT to use it or mention alternatives like cst_resume_simulation. However, the context is clear enough for an agent to decide.

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

cst_transform_mirrorB

Mirror a solid across a plane (xy, xz, or yz). An optional center point can be specified.

ParametersJSON Schema
NameRequiredDescriptionDefault
copyNoIf true, create a copy instead of moving the original
planeYesMirror plane
solidYesSolid reference in "Component:Solid" format
center_xNoX coordinate of the transform center
center_yNoY coordinate of the transform center
center_zNoZ coordinate of the transform center

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 mentions mirroring across a plane and an optional center point, but fails to describe the critical copy parameter (whether the original is moved or a copy is created). This omission significantly reduces 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, direct sentence that front-loads the key operation: 'Mirror a solid across a plane' and mentions the optional center point. No wasted words.

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 six parameters (including a boolean copy and three center coordinates) and no output schema or annotations, the description is too sparse. It lacks details on copy behavior, coordinate system assumptions, and default center behavior, leaving the agent underinformed.

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 no new information beyond the schema: it repeats plane enum options and the existence of a center point, but does not explain semantics like 'copy' or coordinate defaults.

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 identifies the verb 'mirror' and resource 'solid' across a plane, listing specific plane options (xy, xz, yz) and the optional center point. This differentiates it from sibling transform tools like cst_transform_translate or cst_transform_rotate.

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 like translate or rotate, nor does it mention prerequisites or exclude negative cases. It only gives a minimal operation statement.

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

cst_transform_rotateA

Rotate a solid by a given angle around an axis (x, y, or z). An optional center point can be specified.

ParametersJSON Schema
NameRequiredDescriptionDefault
axisYesRotation axis
copyNoIf true, create a copy instead of moving the original
angleYesRotation angle in degrees
solidYesSolid reference in "Component:Solid" format
center_xNoX coordinate of the transform center
center_yNoY coordinate of the transform center
center_zNoZ coordinate of the transform center

TDQS

A3.5/5.0
Behavior3/5

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

With no annotations, the description should disclose behavior beyond the schema. It mentions optional center and axis, but does not clarify that the tool modifies the solid in place (copy parameter defaults to false) or what the return value is. This is adequate 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 a single 22-word sentence that efficiently conveys the core functionality without unnecessary detail. It is front-loaded and 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 tool with 7 parameters, no output schema, and no annotations, the description covers the main idea but omits important context: in-place modification behavior (copy parameter) and that no output is returned. It suffices 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?

The input schema has 100% coverage, so baseline is 3. The description adds 'around an axis (x, y, or z)' and 'optional center point', which aligns with schema fields but does not add substantial new meaning beyond existing 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 clearly states the tool rotates a solid, specifies angle, axis (x,y,z), and optional center point. It distinguishes from sibling transform tools (scale, mirror, translate) by naming the specific 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 when to use this tool vs. alternatives like cst_transform_scale or cst_transform_translate. It only implies usage for rotation without giving exclusion criteria.

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

cst_transform_scaleB

Scale a solid by independent factors along each axis. An optional center point can be specified.

ParametersJSON Schema
NameRequiredDescriptionDefault
copyNoIf true, create a copy instead of moving the original
solidYesSolid reference in "Component:Solid" format
scale_xNoScale factor along X axis
scale_yNoScale factor along Y axis
scale_zNoScale factor along Z axis
center_xNoX coordinate of the transform center
center_yNoY coordinate of the transform center
center_zNoZ coordinate of the transform center

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 full responsibility. It does not disclose whether scaling modifies the original or creates a copy (though the 'copy' parameter exists), nor does it mention side effects, permissions, or result 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 two sentences (20 words), front-loaded with the main action, and contains no redundant information. Highly concise and efficient.

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 with 8 parameters, no output schema, and no annotations, the description is too minimal. It fails to explain the meaning of scale factors (e.g., default 1 is identity), the role of the center point, or warning about negative factors.

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 baseline is 3. The description adds context about the optional center point, but this is already implied by the schema parameters. No additional semantic value 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 verb 'Scale', the resource 'a solid', and specifies scaling by independent factors along each axis with an optional center point. This effectively distinguishes it from sibling tools like rotate and translate.

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 cst_transform_rotate or cst_transform_translate. It lacks context about prerequisites, scenarios, or exclusions.

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

cst_transform_translateA

Translate (move) a solid by a displacement vector (dx, dy, dz). Optionally create a translated copy.

ParametersJSON Schema
NameRequiredDescriptionDefault
dxYesTranslation distance along X axis
dyYesTranslation distance along Y axis
dzYesTranslation distance along Z axis
copyNoIf true, create a copy instead of moving the original
solidYesSolid reference in "Component:Solid" format

TDQS

A3.9/5.0
Behavior3/5

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

No annotations provided, so the description carries the burden. It indicates the tool can move or copy a solid, but does not clarify if the original is modified by default, what happens to the original when copying, or any return value. The ambiguity around destructive behavior 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 short sentence that conveys all key information without redundancy. It is front-loaded and efficient.

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 tool's purpose and parameters but lacks information about return values, side effects, or prerequisites. With no output schema, the agent is left uncertain about what the tool provides after execution.

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. The description adds minimal value beyond the schema, grouping dx, dy, dz as a displacement vector and noting the copy option. It does not introduce new meaning not already in 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 verb 'Translate (move)' and the resource 'a solid', specifying the displacement vector as (dx, dy, dz). It distinguishes from sibling tools like cst_transform_rotate or cst_transform_scale by focusing on translation.

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 when to use this tool (for moving solids) and briefly mentions the optional copy feature, but does not explicitly state when not to use it or compare to alternatives. Given sibling names, the context is clear enough.

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

cst_vba_helpA

Get VBA reference documentation for a CST Studio object. Returns the object description and a list of its common methods and properties.

ParametersJSON Schema
NameRequiredDescriptionDefault
object_nameYesName of the CST VBA object to look up, e.g. 'Brick', 'Solver', 'Material', 'Port', 'Mesh', 'FarfieldPlot'.

TDQS

A3.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 must fully disclose behavioral traits. It does not mention that the tool is read-only, has no side effects, or requires specific permissions/authentication. The behavior is implied but not explicitly stated.

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 sentences, front-loaded with verb and resource, no extraneous text. Every word contributes to clarity.

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 help tool with one parameter and no output schema, the description covers the essential return information (description and list of methods/properties). It is adequate for the expected usage, though it could specify scope (e.g., current project).

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% with a brief description for the 'object_name' parameter. The description adds meaningful examples (e.g., 'Brick', 'Solver') that enhance understanding beyond the schema, compensating for the schema's brevity.

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 returns VBA reference documentation for a CST Studio object, specifying the verb (Get), resource (documentation), and what is returned (object description and common methods/properties). This distinguishes it from siblings like cst_execute_vba or cst_list_vba_objects.

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 such as cst_list_vba_objects. The description does not specify prerequisites or scenarios where 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.

cst_workflow_design_reportA

ONE-SHOT design package after modeling/simulation: project status, parameters/dimensions, S-parameters (+metrics), best-effort farfield export, and structure view images. Each section fails soft — you still get partial results. Tasarım bittikten sonra boyutlar, S11, uzak alan ve görselleri tek çağrıda toplar.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNo
out_dirNoReport folder (default under CST_WORK_DIR/exports/report_*)
max_pointsNo
frequency_ghzNoOptional farfield monitor frequency hint
include_imagesNo
include_sparamsNo
include_farfieldNo
include_parametersNo

TDQS

A3.8/5.0
Behavior4/5

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

With no annotations, the description bears full behavioral disclosure. It discloses soft-failure behavior, best-effort farfield export, and the one-shot aggregation nature. It does not mention side effects like file writing locations or runtime costs, but the failure-mode transparency is genuinely useful.

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 core English content is compact and front-loaded with the key idea and then the failure behavior. The Turkish sentence adds duplication without new information, slightly reducing efficiency, but overall the description is appropriately 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?

Given 8 parameters, low parameter documentation, no annotations, and no output schema, the description leaves meaningful gaps. An agent still lacks clarity on output format/return value, how max_points or port influence results, and what 'best-effort' means concretely for farfield data. It is a good high-level package description but not fully complete for safe invocation.

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%, so the description needed to compensate. It hints at the include_* toggles by naming sections (S-parameters, farfield, images, parameters), but it does not explain port, max_points, frequency_ghz, or out_dir beyond the schema's sparse coverage. Parameter meaning remains largely underspecified.

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?

States a specific composite action ('ONE-SHOT design package') and enumerates concrete result sections: project status, parameters/dimensions, S-parameters, farfield export, and structure view images. This clearly distinguishes it from single-purpose siblings like cst_export_farfield or cst_export_structure_views.

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?

Explicitly scopes the tool to use 'after modeling/simulation' and frames it as a one-shot aggregation call. It communicates failure tolerance ('Each section fails soft') which helps an agent decide to invoke it even when some data may be missing, though it does not name explicit alternatives or exclusions.

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

cst_workflow_patch_antennaA

END-TO-END / Uçtan uca: size a rectangular microstrip patch, build substrate/ground/patch/feed, frequency, open BCs, waveguide port, farfield monitor. Does not connect to or start CST; call cst_connect first for live execution, otherwise it returns offline VBA. Does NOT run the solver. Simülasyon çalıştırmaz — next: cst_workflow_run_and_s11 or cst_run_simulation.

ParametersJSON Schema
NameRequiredDescriptionDefault
epsilon_rNoSubstrate εr
feed_typeNoinset
height_mmNoSubstrate height (mm)
tan_deltaNoLoss tangent
project_pathNoOptional .cst path when creating a new project
frequency_ghzYesCenter frequency (GHz) / Merkez frekans
create_projectNo

TDQS

A3.6/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. It discloses a key behavioral trait: the tool returns offline VBA if CST is not connected, which is critical. It also states it does not run the solver and builds the full setup. However, it does not disclose other behaviors like whether it overwrites an existing project, how it handles the project_path parameter, or what the output actually looks like (VBA script? built model?). Since the description covers some key points but leaves these gaps, a 3 is appropriate.

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 relatively concise, with a bilingual twist that may confuse but is not overly long. It front-loads the main purpose ('END-TO-END / Uçtan uca') and then provides essential usage notes. It could be more concise by removing the Turkish repetition, but it's structured clearly with caveats toward the end.

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 complexity (a multi-step workflow) and the lack of an output schema, the description does a good job of explaining the scope and prerequisites. It tells the agent what to do next and what not to expect. However, it omits some details like parameter constraints (e.g., valid frequency ranges) and the exact behavior when create_project is false, but these are less critical.

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 several parameters (epsilon_r, height_mm, tan_delta, frequency_ghz) with 71% coverage. The description adds little beyond what the schema provides—it mentions the end-to-end components but doesn't elaborate on how each parameter influences the design. Since schema coverage is high (>80%), the baseline is 3, and the description does not add extra semantic depth, so 3 is correct.

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 purpose: to create an end-to-end rectangular microstrip patch antenna model in CST, listing all the components built (substrate, ground, patch, feed) and the setup (frequency, boundary conditions, port, monitor). This distinguishes it from siblings like cst_antenna_patch (which appears to be a template-based approach vs this building from scratch) and cst_design_patch_only (which likely only designs the patch without the full setup). It falls short of a 5 because it doesn't explicitly name the sibling tools it differs from; the reader has to infer from the sibling list.

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 strong usage context: it explicitly says 'call cst_connect first for live execution, otherwise it returns offline VBA' and tells the agent to use next steps (cst_workflow_run_and_s11 or cst_run_simulation). It also states clearly what it does NOT do (does not run the solver, does not connect to CST). However, it does not explicitly name alternative tools for when the user wants only the design without the full setup (e.g., cst_design_patch_only) or other antenna types, so it stops short of full exclusion guidance.

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

cst_workflow_run_and_s11C

Run solver and return structured S11/Sij with metrics (min dB, bandwidth). Solver çalıştırır ve S parametrelerini metriklerle döner.

ParametersJSON Schema
NameRequiredDescriptionDefault
port_inNo
port_outNo
timeout_sNo
max_pointsNo

TDQS

C2.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 carries the full transparency burden. It discloses that the tool invokes a solver and returns metrics, but it does not mention side effects on the project, whether it blocks, what happens on timeout, or dependencies on previously configured ports/solver settings.

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 short but not efficient: the second sentence is a Turkish translation of the first, adding no new information. The key idea is front-loaded, but the duplicate sentence means not every sentence 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?

There is no output schema and no annotations, so the description must explain both behavior and return value shape. It gives a high-level summary and lists two metrics, but 'structured S11/Sij' is vague, parameters are unexplained, and no prerequisites or failure behavior are mentioned. The definition is only minimally adequate for a 4-parameter workflow tool.

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?

Schema description coverage is 0%, and the description does not explain any of the parameters (port_in, port_out, timeout_s, max_points). The agent receives no meaning beyond the raw parameter names and defaults, so the description fails to compensate for the schema gap.

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 ('Run solver') and names the output ('structured S11/Sij with metrics (min dB, bandwidth)'). This clearly distinguishes it from siblings like cst_run_simulation or cst_get_s_parameters, because it both runs the solver and returns computed metrics in one action.

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 workflow versus alternatives such as cst_run_simulation, cst_get_s_parameters, or cst_get_bandwidth. It does not state prerequisites (e.g., ports must exist) or exclusions, leaving the agent to infer when this combined tool is appropriate.

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

cst_workflow_simulate_and_reportB

Run the solver, then immediately build a design report (S-params + views + optional farfield). Simülasyonu çalıştırıp rapor paketini üretir.

ParametersJSON Schema
NameRequiredDescriptionDefault
portNo
out_dirNo
timeout_sNo
max_pointsNo
frequency_ghzNo
include_imagesNo
include_farfieldNo

TDQS

B3.1/5.0
Behavior3/5

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

The description discloses the high-level behavior: it runs the solver, builds a report, and includes optional farfield. However, with no annotations it does not say whether this blocks, how long it may run, what files are written, whether existing reports are overwritten, or how results are returned.

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 English sentence is compact and front-loaded, but the second Turkish sentence ('Simülasyonu çalıştırıp rapor paketini üretir') merely repeats the same information and does not add value for an agent.

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 chained, potentially long-running action with 7 parameters and no output schema, this is incomplete. It lacks return-value information, behavior around missing farfield monitors, report destination, and required setup.

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?

All seven parameters are undocumented in the schema (0% coverage) and the description only indirectly hints at include_farfield ('optional farfield') and port via 'S-params'. It does not explain out_dir, timeout_s, max_points, frequency_ghz, or include_images, leaving the agent to guess from parameter names.

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 clear, composite operation – 'Run the solver, then immediately build a design report' – and enumerates the report contents ('S-params + views + optional farfield'). This is enough to distinguish it from siblings such as cst_run_simulation (run-only) and cst_workflow_design_report (report-only).

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 about when to choose this combined workflow instead of cst_run_simulation, cst_workflow_design_report, or cst_workflow_run_and_s11. It gives no prerequisites (e.g., ports/solver setup, farfield monitors) and no exclusions, so the agent must infer selection from the tool name.

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

cst_yield_analysisB

Set up a Monte Carlo yield analysis to estimate manufacturing yield. Randomly varies parameters according to their tolerances and evaluates pass/fail criteria.

ParametersJSON Schema
NameRequiredDescriptionDefault
parametersYes
num_samplesNoNumber of Monte Carlo samples.
pass_criteriaYes

TDQS

B3.2/5.0
Behavior3/5

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

The description discloses core behavior: random parameter variation and pass/fail evaluation. However, it does not clarify whether the tool runs simulations or merely sets up the analysis, nor does it mention side effects or requirements. With no annotations, more detail on execution and output would improve 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 concise, consisting of two sentences that front-load the core purpose and method. No extraneous information is present.

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 Monte Carlo analysis, the lack of an output schema, and low schema coverage, the description is insufficient. It does not explain how results are returned or what the output of the tool is, leaving a significant gap for an AI agent to correctly invoke and process 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?

The description adds meaning by explaining that parameters are varied according to tolerances and that pass/fail criteria are evaluated, which complements the schema. However, it does not elaborate on the distribution or num_samples parameters, and schema coverage is low (33%), so the description only partially compensates.

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 performs a Monte Carlo yield analysis, specifying it varies parameters based on tolerances and evaluates pass/fail criteria. This directly conveys the purpose and distinguishes from general simulation tools, though it does not explicitly differentiate from other analysis tools like sensitivity analysis.

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 parameter sweep or sensitivity analysis. The description lacks context for appropriate usage scenarios or exclusions.

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. 184 tool updatesv1.1.0
    • First observedcst_add_discrete_port
    • First observedcst_add_field_monitor
    • First observedcst_add_fixpoint_mesh
    • First observedcst_add_floquet_port
    • First observedcst_add_lumped_element
    • First observedcst_add_mesh_refinement
    • First observedcst_add_multipin_port
    • First observedcst_add_plane_wave
    • First observedcst_add_waveguide_port
    • First observedcst_analyze_impedance
    • First observedcst_antenna_bowtie
    • First observedcst_antenna_dipole
    • First observedcst_antenna_helix
    • First observedcst_antenna_horn
    • First observedcst_antenna_ifa
    • First observedcst_antenna_monopole
    • First observedcst_antenna_patch
    • First observedcst_antenna_pifa
    • First observedcst_antenna_slot
    • First observedcst_antenna_spiral
    • First observedcst_antenna_vivaldi
    • First observedcst_antenna_yagi
    • First observedcst_array_beam_steering
    • First observedcst_array_circular
    • First observedcst_array_compute_factor
    • First observedcst_array_grating_lobe_analysis
    • First observedcst_array_linear
    • First observedcst_array_mutual_coupling
    • First observedcst_array_planar
    • First observedcst_array_taper_design
    • First observedcst_assign_material
    • First observedcst_boolean_add
    • First observedcst_boolean_insert
    • First observedcst_boolean_intersect
    • First observedcst_boolean_subtract
    • First observedcst_close_project
    • First observedcst_configure_eigenmode_advanced
    • First observedcst_configure_eigenmode_solver
    • First observedcst_configure_frequency_domain_solver
    • First observedcst_configure_ie_solver_advanced
    • First observedcst_configure_integral_equation_solver
    • First observedcst_configure_multilayer_solver
    • First observedcst_configure_time_domain_solver
    • First observedcst_connect
    • First observedcst_connection_status
    • First observedcst_constrained_optimizer
    • First observedcst_create_analytical_curve
    • First observedcst_create_anisotropic_material
    • First observedcst_create_brick
    • First observedcst_create_cole_cole_material
    • First observedcst_create_cone
    • First observedcst_create_cylinder
    • First observedcst_create_debye_material
    • First observedcst_create_drude_material
    • First observedcst_create_ecylinder
    • First observedcst_create_extrude
    • First observedcst_create_face_from_curves
    • First observedcst_create_ferrite_material
    • First observedcst_create_loft
    • First observedcst_create_lorentz_material
    • First observedcst_create_lossy_metal
    • First observedcst_create_material
    • First observedcst_create_polygon_extrude
    • First observedcst_create_polygon3d
    • First observedcst_create_project
    • First observedcst_create_sphere
    • First observedcst_create_temperature_dependent_material
    • First observedcst_create_torus
    • First observedcst_create_wire
    • First observedcst_delete_material
    • First observedcst_delete_parameter
    • First observedcst_delete_port
    • First observedcst_delete_results
    • First observedcst_design_patch_only
    • First observedcst_disconnect
    • First observedcst_discover_farfield_monitors
    • First observedcst_dismiss_dialogs
    • First observedcst_evaluate_antenna
    • First observedcst_execute_vba
    • First observedcst_export_cad
    • First observedcst_export_farfield
    • First observedcst_export_project
    • First observedcst_export_result
    • First observedcst_export_structure_views
    • First observedcst_export_touchstone
    • First observedcst_get_axial_ratio
    • First observedcst_get_bandwidth
    • First observedcst_get_cross_polarization
    • First observedcst_get_current_distribution
    • First observedcst_get_efficiency
    • First observedcst_get_efficiency_breakdown
    • First observedcst_get_farfield
    • First observedcst_get_farfield_metrics
    • First observedcst_get_gain
    • First observedcst_get_group_delay
    • First observedcst_get_impedance
    • First observedcst_get_material_info
    • First observedcst_get_mesh_info
    • First observedcst_get_mesh_quality
    • First observedcst_get_parameter
    • First observedcst_get_pattern_cut
    • First observedcst_get_radiation_pattern_3d
    • First observedcst_get_result_summary
    • First observedcst_get_s_parameter_phase
    • First observedcst_get_s_parameters
    • First observedcst_get_simulation_status
    • First observedcst_get_smith_chart_data
    • First observedcst_get_solver_info
    • First observedcst_get_surface_current
    • First observedcst_get_time_domain_signal
    • First observedcst_get_vswr
    • First observedcst_impedance_smith_transform
    • First observedcst_import_cad
    • First observedcst_import_touchstone
    • First observedcst_list_antenna_templates
    • First observedcst_list_ferrite_materials
    • First observedcst_list_materials
    • First observedcst_list_parameters
    • First observedcst_list_ports
    • First observedcst_list_results
    • First observedcst_list_saved_results
    • First observedcst_list_vba_objects
    • First observedcst_load_material
    • First observedcst_matching_create_lumped
    • First observedcst_matching_l_network
    • First observedcst_matching_microstrip_impedance
    • First observedcst_matching_pi_network
    • First observedcst_matching_quarter_wave
    • First observedcst_matching_stub
    • First observedcst_matching_t_network
    • First observedcst_multi_objective_optimizer
    • First observedcst_open_project
    • First observedcst_optimizer
    • First observedcst_parameter_interpolation
    • First observedcst_parameter_sweep
    • First observedcst_pause_simulation
    • First observedcst_pcb_calculate_coupling
    • First observedcst_pcb_cpw_transition
    • First observedcst_pcb_create_ground_plane
    • First observedcst_pcb_create_stackup
    • First observedcst_pcb_create_trace
    • First observedcst_pcb_create_via
    • First observedcst_pcb_differential_pair
    • First observedcst_pcb_import_gerber
    • First observedcst_pcb_list_stackup_templates
    • First observedcst_pcb_siw_waveguide
    • First observedcst_pcb_via_fence
    • First observedcst_pcb_via_model
    • First observedcst_project_info
    • First observedcst_project_tree
    • First observedcst_read_help
    • First observedcst_read_project_log
    • First observedcst_read_saved_result
    • First observedcst_refine_antenna
    • First observedcst_resume_simulation
    • First observedcst_run_simulation
    • First observedcst_run_simulation_async
    • First observedcst_save_project
    • First observedcst_search_help
    • First observedcst_sensitivity_analysis
    • First observedcst_set_adaptive_mesh
    • First observedcst_set_background
    • First observedcst_set_boundary
    • First observedcst_set_floquet_port_advanced
    • First observedcst_set_frequency_range
    • First observedcst_set_mesh_density
    • First observedcst_set_mesh_type
    • First observedcst_set_parameter
    • First observedcst_set_periodic_boundary
    • First observedcst_set_pml_properties
    • First observedcst_set_symmetry
    • First observedcst_start_dialog_watcher
    • First observedcst_stop_dialog_watcher
    • First observedcst_stop_simulation
    • First observedcst_transform_mirror
    • First observedcst_transform_rotate
    • First observedcst_transform_scale
    • First observedcst_transform_translate
    • First observedcst_vba_help
    • First observedcst_workflow_design_report
    • First observedcst_workflow_patch_antenna
    • First observedcst_workflow_run_and_s11
    • First observedcst_workflow_simulate_and_report
    • First observedcst_yield_analysis

TDQS

B3.3/5.0

Scored across 184 tools

Disambiguation4/5

Most tools have clearly distinct purposes across geometry, simulation, results, and antenna/PCB domains. A few near-overlaps exist (e.g., cst_get_farfield vs cst_get_radiation_pattern_3d, cst_run_simulation vs cst_workflow_run_and_s11) but descriptions sufficiently differentiate them.

Naming Consistency3/5

All tools share the cst_ prefix, but the pattern mixes verb-based names (cst_create_brick, cst_get_s_parameters) with category-based names (cst_antenna_patch, cst_pcb_create_trace, cst_matching_l_network). Within each category naming is consistent, but globally it is a mixed convention.

Tool Count1/5

184 tools is extreme over-proliferation. Even the lower bound of 'too many' (25+) is far exceeded, creating an overwhelming surface that increases selection difficulty and maintenance overhead.

Completeness5/5

The domain coverage is remarkably thorough: project management, geometry creation, materials, ports, boundaries, mesh, solvers, simulation control, results extraction, antenna templates, arrays, PCB design, matching networks, and workflows. No significant gaps are apparent for the stated purpose.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers