Skip to main content
Glama

sch_auto_place_functional

Automatically place schematic symbols into functional zones (connectors, MCU, power, etc.) for clear signal flow and professional layout.

Instructions

Place schematic symbols into semantically meaningful zones on the sheet.

Unlike the basic sch_auto_place_symbols which uses a plain grid, this tool categorises each symbol by its function (MCU, connector, power IC, sensor, passive, protection …) and places it in the corresponding region of the schematic sheet. The result is a readable, professionally structured schematic with logical signal flow (connectors on the left, processing in the centre, power/decoupling at the bottom).

Zone layout (column × row, each cell = 25.4 × 17.78 mm)::

Col →    0-2          3-5          6-8
Row 0:   connectors   MCU          UI/LED/SW
Row 3:   power IC     sensors/IC   protection
Row 5:   power_pass   passives     transistors/filter
Row 7:   test points  ---          misc

The actual sheet size is read from the schematic file. If the symbol count would overflow the current sheet, a warning is appended recommending sch_auto_resize_sheet to switch to a larger format (A3, A2, …) before re-running this tool.

Symbols already placed (not in symbol_list) are treated as fixed obstacles and will not be overwritten. Within each zone, symbols are arranged in a compact row-major sub-grid.

Args: symbol_list: Optional list of reference designators to place. If omitted, all symbols in the schematic are placed.

Returns: A summary showing how many symbols were placed per functional zone, plus an overflow warning if the sheet is too small.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
symbol_listNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes
Behavior5/5

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

With empty annotations, the description carries full burden and succeeds: it explains functional categorization, zone layout, sheet-size reading, overflow warnings, treatment of pre-placed symbols as fixed obstacles, and the compact row-major arrangement within zones. No contradictions with annotations (none present).

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 well-structured and front-loaded with the core purpose. The ASCII zone diagram and parameter/return sections earn their place, supporting the reader efficiently without verbosity.

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?

Despite no annotations and minimal schema, the description covers purpose, usage context, zone layout, overflow handling, obstacle behavior, parameter meaning, and returns summary. It is complete for a placement tool of this complexity, even with an output schema present.

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 schema only defines symbol_list as an optional array/null with 0% parameter coverage. The description adds crucial semantics: it's a list of reference designators, and omitting it places all symbols. This fully compensates for the sparse 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+resource+method: 'Place schematic symbols into semantically meaningful zones on the sheet.' It also explicitly contrasts with the basic sch_auto_place_symbols, making the tool's unique purpose unmistakable.

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 directly names the alternative tool (sch_auto_place_symbols) and when to use this one for readable, professionally structured schematics. It also recommends sch_auto_resize_sheet when overflow occurs, giving clear guidance on next steps.

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

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Valxyria/kicad-mcp-pro'

If you have feedback or need assistance with the MCP directory API, please join our Discord server