Skip to main content
Glama

Export 2D SVG, BOM, 3D GLB, and 3D-Print Deliverables

export_deliverables
DestructiveIdempotent

Generate 2D elevation and wiring SVGs, a Markdown BOM, a 3D GLB scene, and OpenSCAD or STL print models for the active rack project, writing deterministic files locally or returning download URLs.

Instructions

Generate 2D elevation and wiring SVGs, a Markdown BOM, a binary 3D GLB scene, and parametric OpenSCAD or watertight STL 3D-print models for the active rack project. Omitting 'formats' exports all six types; 'carrier-scad' and 'carrier-stl' emit one file per mounted modular carrier, switch cradle, or printable cover panel and emit zero files when none are mounted, while 'output_dir' resolves relative paths within the project directory and creates missing folders. Local stdio execution writes deterministic filenames—elevation.svg, wiring-schematic.svg, BOM.md, rack-scene.glb, and .scad or .stl—overwriting same-named files in place, whereas hosted remote sessions stream in-memory HTTPS download URLs; neither mode mutates rack state or undo history. Use after validate_rack confirms a valid layout; use validate_rack instead for read-only validation and ASCII elevation inspection without generating export files.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

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

Input Schema

NameRequiredDescriptionDefault
formatsNoDeliverable formats to generate and write to disk (defaults to all 6 formats; carrier-scad and carrier-stl emit files when modular carriers are mounted).
output_dirNoOptional target filesystem directory for generated files in local stdio mode (defaults to the directory of the active rack.yaml file; ignored on hosted remote MCP servers where HTTPS download URLs are returned instead).

Output Schema

NameRequiredDescriptionDefault
dataYesDeliverable export result payload.
issuesYesStructured diagnostic findings (ERROR, WARNING, INFO) with actionable remediation_suggestions.
statusYesDeterministic execution outcome: "VALID" when the operation succeeded with 0 validation errors; "INVALID" when precondition or engineering validation errors are present in issues[].
summaryYesConcise human- and agent-readable summary of the tool result and validation status.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.7.8
    • addedInput schema / properties / formats / maxItems
      Added value: +6
    • addedInput schema / properties / output_dir / maxLength
      Added value: +512
  2. Changed9 schema fields changedv0.5.0
    • changedInput schema / properties / output_dir / description
      Previous value: -"Optional target filesystem directory for generated files (defaults to the directory of the active rack.yaml file)."New value: +"Optional target filesystem directory for generated files in local stdio mode (defaults to the directory of the active rack.yaml file; ignored on hosted remote MCP servers where HTTPS download URLs are returned instead)."
    • changedOutput schema / properties / data / properties / exported_files / description
      Previous value: -"Metadata for each deliverable file written to disk."New value: +"Metadata for each generated deliverable file or download URL."
    • addedOutput schema / properties / data / properties / exported_files / items / properties / download_url
      Added value: +{
      +  "description": "Direct HTTPS download URL for this deliverable when connected to a hosted remote MCP server.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / data / properties / exported_files / items / properties / filename
      Added value: +{
      +  "description": "Suggested local filename for saving the deliverable.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / data / properties / exported_files / items / properties / path / description
      Previous value: -"Absolute filesystem path of the written file."New value: +"Absolute filesystem path of the written file (or direct HTTPS download URL in hosted remote MCP mode)."
    • changedOutput schema / properties / data / properties / exported_files / items / properties / size_bytes / description
      Previous value: -"Size of the written file in bytes."New value: +"Size of the generated deliverable in bytes."
    • addedOutput schema / properties / data / properties / live_viewer_url
      Added value: +{
      +  "description": "Interactive 3D/2D Web-Viewer URL bound live to this remote MCP session (present in hosted remote MCP mode).",
      +  "type": "string"
      +}
    • changedOutput schema / properties / data / properties / output_dir / description
      Previous value: -"Resolved absolute directory path where deliverable files were written."New value: +"Resolved absolute directory path where deliverable files were written (or HTTPS base export endpoint when running on a hosted remote MCP server)."
    • addedOutput schema / properties / data / properties / rack_yaml_url
      Added value: +{
      +  "description": "Direct HTTPS download URL for the session rack.yaml source of truth (present in hosted remote MCP mode).",
      +  "type": "string"
      +}
  3. Changed3 schema fields changedv0.4.10
    • changedInput schema / properties / formats / description
      Previous value: -"Deliverable formats to export."New value: +"Deliverable formats to generate and write to disk (defaults to all 6 formats; carrier-scad and carrier-stl emit files when modular carriers are mounted)."
    • changedInput schema / properties / output_dir / description
      Previous value: -"Optional target directory where deliverable files will be written."New value: +"Optional target filesystem directory for generated files (defaults to the directory of the active rack.yaml file)."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "data": {
      +      "additionalProperties": {},
      +      "description": "Deliverable export result payload.",
      +      "properties": {
      +        "bom_summary": {
      +          "additionalProperties": {},
      +          "description": "Summary counts and power totals included in the Bill of Materials.",
      +          "properties": {
      +            "cables_count": {
      +              "description": "Total routed cables.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "mounted_devices_count": {
      +              "description": "Total mounted rack devices and carrier sub-modules.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "total_poe_budget_watts": {
      +              "description": "Total available PSE PoE budget in watts.",
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "total_poe_draw_watts": {
      +              "description": "Total PoE power draw in watts.",
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "total_power_draw_watts": {
      +              "description": "Total peak system power draw in watts.",
      +              "minimum": 0,
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "mounted_devices_count",
      +            "cables_count",
      +            "total_power_draw_watts",
      +            "total_poe_draw_watts",
      +            "total_poe_budget_watts"
      +          ],
      +          "type": "object"
      +        },
      +        "exported_files": {
      +          "description": "Metadata for each deliverable file written to disk.",
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "format": {
      +                "description": "Deliverable format identifier (e.g., \"elevation-svg\", \"carrier-stl\").",
      +                "type": "string"
      +              },
      +              "path": {
      +                "description": "Absolute filesystem path of the written file.",
      +                "type": "string"
      +              },
      +              "size_bytes": {
      +                "description": "Size of the written file in bytes.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "path",
      +              "size_bytes"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "output_dir": {
      +          "description": "Resolved absolute directory path where deliverable files were written.",
      +          "type": "string"
      +        },
      +        "validation": {
      +          "additionalProperties": false,
      +          "description": "Current 5-stage validation report at the time of export.",
      +          "properties": {
      +            "error_count": {
      +              "description": "Total number of blocking ERROR diagnostics.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "is_valid": {
      +              "description": "True when zero ERROR-level diagnostic issues exist.",
      +              "type": "boolean"
      +            },
      +            "issues": {
      +              "description": "List of all detected ERROR, WARNING, and INFO diagnostic issues.",
      +              "items": {
      +                "additionalProperties": false,
      +                "description": "Single validation finding with deterministic self-correction feedback.",
      +                "properties": {
      +                  "affected_instances": {
      +                    "description": "Device instance IDs involved in this diagnostic issue.",
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "code": {
      +                    "description": "Machine-readable deterministic validation diagnostic code.",
      +                    "enum": [
      +                      "CHASSIS_COLLISION",
      +                      "PLUG_CLEARANCE_COLLISION",
      +                      "FRONT_DOOR_COLLISION",
      +                      "SLOT_DIMENSION_OVERFLOW",
      +                      "SLOT_INCOMPATIBLE",
      +                      "OUT_OF_RACK_BOUNDS",
      +                      "BLUEPRINT_NOT_FOUND",
      +                      "PORT_NOT_FOUND",
      +                      "PORT_ALREADY_OCCUPIED",
      +                      "CONNECTOR_INCOMPATIBLE",
      +                      "SIGNAL_PROTOCOL_INCOMPATIBLE",
      +                      "SPEED_MISMATCH",
      +                      "POE_BUDGET_EXCEEDED",
      +                      "POE_CLASS_EXCEEDED",
      +                      "UPS_OVERLOAD",
      +                      "UNPOWERED_DEVICE",
      +                      "TOP_HEAVY_RACK",
      +                      "NO_FRONT_TO_REAR_PORTAL",
      +                      "THERMAL_AIRFLOW_CONFLICT",
      +                      "THERMAL_HOTSPOT_STACKING",
      +                      "ACOUSTIC_NOISE_HIGH"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "message": {
      +                    "description": "Detailed engineering explanation with exact millimeter/watt figures.",
      +                    "type": "string"
      +                  },
      +                  "remediation_actions": {
      +                    "description": "Optional machine-actionable remediation descriptors.",
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "description": "Structured self-correction action for autonomous agent remediation.",
      +                      "properties": {
      +                        "action_type": {
      +                          "description": "Recommended self-correction operation category.",
      +                          "enum": [
      +                            "move_device",
      +                            "change_cable_type",
      +                            "connect_power",
      +                            "disconnect_cable",
      +                            "redistribute_poe",
      +                            "add_portal_gap",
      +                            "change_rack_depth"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "description": {
      +                          "description": "Human- and agent-readable explanation of the remediation step.",
      +                          "type": "string"
      +                        },
      +                        "suggested_cable_type": {
      +                          "description": "Suggested replacement cable_type (e.g. angled plug or higher speed grade).",
      +                          "type": "string"
      +                        },
      +                        "suggested_face": {
      +                          "description": "Mounting or port face relative to the rack or chassis.",
      +                          "enum": [
      +                            "front",
      +                            "rear"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "suggested_u_positions": {
      +                          "description": "Candidate 1-indexed U positions that resolve the spatial conflict.",
      +                          "items": {
      +                            "exclusiveMinimum": 0,
      +                            "maximum": 9007199254740991,
      +                            "type": "integer"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "target_cable_id": {
      +                          "description": "Cable connection cable_id targeted by this remediation action.",
      +                          "type": "string"
      +                        },
      +                        "target_instance_id": {
      +                          "description": "Device instance_id targeted by this remediation action.",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "action_type",
      +                        "description"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "remediation_suggestions": {
      +                    "description": "Actionable self-correction instructions for the calling LLM agent.",
      +                    "items": {
      +                      "type": "string"
      +                    },
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "severity": {
      +                    "description": "Severity level of the engineering constraint diagnostic.",
      +                    "enum": [
      +                      "ERROR",
      +                      "WARNING",
      +                      "INFO"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "stage": {
      +                    "description": "Validation pipeline stage (1..5) that produced this finding.",
      +                    "maximum": 5,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "u_range": {
      +                    "additionalItems": false,
      +                    "description": "Inclusive [start_u, end_u] range where the issue occurs.",
      +                    "items": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      }
      +                    ],
      +                    "maxItems": 2,
      +                    "minItems": 2,
      +                    "type": "array"
      +                  }
      +                },
      +                "required": [
      +                  "code",
      +                  "severity",
      +                  "affected_instances",
      +                  "message",
      +                  "remediation_suggestions"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "mechanical_summary": {
      +              "additionalProperties": false,
      +              "description": "Aggregated mechanical mass, center of gravity, thermal BTU/hr, and acoustic dB(A) metrics.",
      +              "properties": {
      +                "airflow_profile": {
      +                  "default": "uniform-passive",
      +                  "description": "Rack-wide thermal airflow regime classification.",
      +                  "enum": [
      +                    "uniform-front-to-rear",
      +                    "uniform-passive",
      +                    "hybrid-active-passive",
      +                    "mixed-conflict"
      +                  ],
      +                  "type": "string"
      +                },
      +                "available_portal_u_positions": {
      +                  "description": "1-indexed U slots that allow front-to-rear cable pass-through (open U or brush panel).",
      +                  "items": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": -9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "type": "array"
      +                },
      +                "center_of_gravity_y_mm": {
      +                  "description": "Vertical Center of Gravity height from bottom of U1 in millimeters.",
      +                  "type": "number"
      +                },
      +                "combined_noise_db_a": {
      +                  "default": 0,
      +                  "description": "Logarithmic sum of acoustic noise emissions in dB(A) across all mounted devices.",
      +                  "type": "number"
      +                },
      +                "normalized_cog_y": {
      +                  "description": "Normalized vertical Center of Gravity ratio (0.0 = bottom, 1.0 = top; keep <= 0.50).",
      +                  "type": "number"
      +                },
      +                "total_thermal_btu_hr": {
      +                  "default": 0,
      +                  "description": "Total peak thermal dissipation in BTU/hr (1W = 3.41214 BTU/hr).",
      +                  "type": "number"
      +                },
      +                "total_weight_grams": {
      +                  "description": "Total mass of all mounted equipment in grams.",
      +                  "type": "number"
      +                }
      +              },
      +              "required": [
      +                "total_weight_grams",
      +                "center_of_gravity_y_mm",
      +                "normalized_cog_y",
      +                "available_portal_u_positions",
      +                "total_thermal_btu_hr",
      +                "combined_noise_db_a",
      +                "airflow_profile"
      +              ],
      +              "type": "object"
      +            },
      +            "power_summary": {
      +              "additionalProperties": false,
      +              "description": "Aggregated electrical and PoE DAG power analysis.",
      +              "properties": {
      +                "power_sources": {
      +                  "description": "Per-PDU and per-UPS electrical load breakdown.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "description": "Load and capacity summary for a mounted PDU or UPS unit.",
      +                    "properties": {
      +                      "capacity_watts": {
      +                        "description": "Maximum rated output capacity of the power source in watts.",
      +                        "type": "number"
      +                      },
      +                      "role": {
      +                        "description": "Electrical source classification (\"pdu\" or \"ups\").",
      +                        "enum": [
      +                          "pdu",
      +                          "ups"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "source_instance_id": {
      +                        "description": "Instance ID of the upstream PDU or UPS unit.",
      +                        "type": "string"
      +                      },
      +                      "total_load_watts": {
      +                        "description": "Cumulative downstream system and PoE load in watts.",
      +                        "type": "number"
      +                      },
      +                      "utilization_percent": {
      +                        "description": "Percentage of rated watt capacity consumed (0..100+).",
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "source_instance_id",
      +                      "role",
      +                      "capacity_watts",
      +                      "total_load_watts",
      +                      "utilization_percent"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "pse_budgets": {
      +                  "description": "Per-switch PoE budget utilization breakdown.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "description": "PoE budget utilization breakdown for a single PSE switch.",
      +                    "properties": {
      +                      "consumed_poe_watts": {
      +                        "description": "Total PoE power drawn by connected Powered Devices (PDs) in watts.",
      +                        "type": "number"
      +                      },
      +                      "downstream_devices": {
      +                        "description": "Instance or endpoint IDs of downstream PoE consumers powered by this switch.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "poe_budget_watts": {
      +                        "description": "Maximum rated PoE output power budget of the switch in watts.",
      +                        "type": "number"
      +                      },
      +                      "pse_instance_id": {
      +                        "description": "Instance ID of the PoE Power Sourcing Equipment (PSE) switch.",
      +                        "type": "string"
      +                      },
      +                      "remaining_poe_watts": {
      +                        "description": "Remaining available PoE power budget in watts (negative if overloaded).",
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "pse_instance_id",
      +                      "poe_budget_watts",
      +                      "consumed_poe_watts",
      +                      "remaining_poe_watts",
      +                      "downstream_devices"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "total_poe_watts": {
      +                  "description": "Total PoE power draw across all connected PoE devices and external drops in watts.",
      +                  "type": "number"
      +                },
      +                "total_system_watts": {
      +                  "description": "Total peak system power draw across all mounted equipment in watts.",
      +                  "type": "number"
      +                },
      +                "unpowered_active_instances": {
      +                  "description": "Active device instance IDs missing a valid AC, DC, USB-C, or PoE power input.",
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "total_system_watts",
      +                "total_poe_watts",
      +                "pse_budgets",
      +                "power_sources",
      +                "unpowered_active_instances"
      +              ],
      +              "type": "object"
      +            },
      +            "status": {
      +              "description": "Overall rack validation state (\"VALID\" when error_count is 0).",
      +              "enum": [
      +                "VALID",
      +                "INVALID"
      +              ],
      +              "type": "string"
      +            },
      +            "warning_count": {
      +              "description": "Total number of non-blocking WARNING diagnostics.",
      +              "maximum": 9007199254740991,
      +              "minimum": 0,
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "status",
      +            "is_valid",
      +            "error_count",
      +            "warning_count",
      +            "issues",
      +            "power_summary",
      +            "mechanical_summary"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "output_dir",
      +        "exported_files",
      +        "bom_summary",
      +        "validation"
      +      ],
      +      "type": "object"
      +    },
      +    "issues": {
      +      "description": "Structured diagnostic findings (ERROR, WARNING, INFO) with actionable remediation_suggestions.",
      +      "items": {
      +        "additionalProperties": false,
      +        "description": "Single validation finding with deterministic self-correction feedback.",
      +        "properties": {
      +          "affected_instances": {
      +            "description": "Device instance IDs involved in this diagnostic issue.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          "code": {
      +            "description": "Machine-readable deterministic validation diagnostic code.",
      +            "enum": [
      +              "CHASSIS_COLLISION",
      +              "PLUG_CLEARANCE_COLLISION",
      +              "FRONT_DOOR_COLLISION",
      +              "SLOT_DIMENSION_OVERFLOW",
      +              "SLOT_INCOMPATIBLE",
      +              "OUT_OF_RACK_BOUNDS",
      +              "BLUEPRINT_NOT_FOUND",
      +              "PORT_NOT_FOUND",
      +              "PORT_ALREADY_OCCUPIED",
      +              "CONNECTOR_INCOMPATIBLE",
      +              "SIGNAL_PROTOCOL_INCOMPATIBLE",
      +              "SPEED_MISMATCH",
      +              "POE_BUDGET_EXCEEDED",
      +              "POE_CLASS_EXCEEDED",
      +              "UPS_OVERLOAD",
      +              "UNPOWERED_DEVICE",
      +              "TOP_HEAVY_RACK",
      +              "NO_FRONT_TO_REAR_PORTAL",
      +              "THERMAL_AIRFLOW_CONFLICT",
      +              "THERMAL_HOTSPOT_STACKING",
      +              "ACOUSTIC_NOISE_HIGH"
      +            ],
      +            "type": "string"
      +          },
      +          "message": {
      +            "description": "Detailed engineering explanation with exact millimeter/watt figures.",
      +            "type": "string"
      +          },
      +          "remediation_actions": {
      +            "description": "Optional machine-actionable remediation descriptors.",
      +            "items": {
      +              "additionalProperties": false,
      +              "description": "Structured self-correction action for autonomous agent remediation.",
      +              "properties": {
      +                "action_type": {
      +                  "description": "Recommended self-correction operation category.",
      +                  "enum": [
      +                    "move_device",
      +                    "change_cable_type",
      +                    "connect_power",
      +                    "disconnect_cable",
      +                    "redistribute_poe",
      +                    "add_portal_gap",
      +                    "change_rack_depth"
      +                  ],
      +                  "type": "string"
      +                },
      +                "description": {
      +                  "description": "Human- and agent-readable explanation of the remediation step.",
      +                  "type": "string"
      +                },
      +                "suggested_cable_type": {
      +                  "description": "Suggested replacement cable_type (e.g. angled plug or higher speed grade).",
      +                  "type": "string"
      +                },
      +                "suggested_face": {
      +                  "description": "Mounting or port face relative to the rack or chassis.",
      +                  "enum": [
      +                    "front",
      +                    "rear"
      +                  ],
      +                  "type": "string"
      +                },
      +                "suggested_u_positions": {
      +                  "description": "Candidate 1-indexed U positions that resolve the spatial conflict.",
      +                  "items": {
      +                    "exclusiveMinimum": 0,
      +                    "maximum": 9007199254740991,
      +                    "type": "integer"
      +                  },
      +                  "type": "array"
      +                },
      +                "target_cable_id": {
      +                  "description": "Cable connection cable_id targeted by this remediation action.",
      +                  "type": "string"
      +                },
      +                "target_instance_id": {
      +                  "description": "Device instance_id targeted by this remediation action.",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "action_type",
      +                "description"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          "remediation_suggestions": {
      +            "description": "Actionable self-correction instructions for the calling LLM agent.",
      +            "items": {
      +              "type": "string"
      +            },
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "severity": {
      +            "description": "Severity level of the engineering constraint diagnostic.",
      +            "enum": [
      +              "ERROR",
      +              "WARNING",
      +              "INFO"
      +            ],
      +            "type": "string"
      +          },
      +          "stage": {
      +            "description": "Validation pipeline stage (1..5) that produced this finding.",
      +            "maximum": 5,
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "u_range": {
      +            "additionalItems": false,
      +            "description": "Inclusive [start_u, end_u] range where the issue occurs.",
      +            "items": [
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              },
      +              {
      +                "maximum": 9007199254740991,
      +                "minimum": -9007199254740991,
      +                "type": "integer"
      +              }
      +            ],
      +            "maxItems": 2,
      +            "minItems": 2,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "severity",
      +          "affected_instances",
      +          "message",
      +          "remediation_suggestions"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "status": {
      +      "description": "Deterministic execution outcome: \"VALID\" when the operation succeeded with 0 validation errors; \"INVALID\" when precondition or engineering validation errors are present in issues[].",
      +      "enum": [
      +        "VALID",
      +        "INVALID"
      +      ],
      +      "type": "string"
      +    },
      +    "summary": {
      +      "description": "Concise human- and agent-readable summary of the tool result and validation status.",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "summary",
      +    "data",
      +    "issues"
      +  ],
      +  "type": "object"
      +}
  4. Changed1 schema field changedv0.4.9
    • removedInput schema / additionalProperties
      Removed value: -false
  5. First observedv0.1.0

TDQS

A4.6/5.0
Behavior4/5

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

Goes well beyond the annotations: it discloses deterministic filenames, in-place overwrite of same-named files (which explains destructiveHint=true as file-level, not rack-level), per-carrier file emission including the zero-files case, output_dir resolution against the project directory, and the local-stdio vs hosted-remote difference (files on disk vs in-memory HTTPS URLs). It also clarifies that rack state and undo history are untouched, reconciling destructiveHint with idempotentHint. The only minor gap is that it doesn't say whether the deposit of files is transactional if one format fails.

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 dense paragraph that is front-loaded with what gets generated before moving to defaults, then path behavior, then mode differences, then alternatives. Every clause carries information, though the filename enumeration partially restates the conceptual list already given at the start.

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?

Although an output schema exists (so return values needn't be spelled out), the description still supplies the concrete output surface — file names and hosted download URLs — plus the zero-file edge case. For a two-parameter tool with full schema coverage, nothing an agent needs to invoke it correctly is 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?

Schema coverage is already 100%, so the baseline is 3, but the description adds genuine meaning beyond the schema: it states that omitting 'formats' yields all six, that carrier-scad/carrier-stl emit one file per carrier/cradle/cover and zero when none are mounted, and that output_dir accepts relative paths, creates missing folders, and is ignored on hosted servers. That last set of behaviors is absent from 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?

Opens with a specific verb ('Generate') and enumerates exactly the artifacts produced: 2D elevation and wiring SVGs, Markdown BOM, binary GLB scene, and OpenSCAD/STL print models for the active rack project. This is clearly distinguishable from every sibling, and it explicitly separates itself from validate_rack.

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?

States the precondition ('Use after validate_rack confirms a valid layout') and names the alternative plus the condition selecting it ('use validate_rack instead for read-only validation and ASCII elevation inspection without generating export files'). When-to-use, when-not-to-use, and the alternative are all explicit.

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