← The evidence ledger
Evidence row 1227654
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint bff46626-e052-46f3-8784-1727e3478516
- Recorded
- Previous row
- None: the first of its kind about this subject
- Body SHA-256
- 9a3ca167d45a3f0d550e2f4464e300999c10d26295ee4c44453c8ba692d4edec
- Leaf
- 0xb2432609e6f4c1ffc757953729936d0584730d65f667376f062aca7e86b28c53
What was observed
{
"count": 12,
"tools": [
{
"description": "Connect or update a batch of up to 128 power and network cables between mounted device ports in the active rack, computing 3D Catmull-Rom splines, commercial length bins, and PoE or power budgets. Each entry in 'cables[]' upserts in place by 'cable_id' while leaving all other cables and mounted equipment untouched, pushes a recoverable undo snapshot, and persists rack.yaml atomically; port, speed, PoE, or clearance violations return status 'INVALID' with remediation_suggestions instead of throwing. Within each cable, endpoint 'face' is required only on pass-through couplers such as patch panels exposing identical 'port_id' values on both faces, 'preferred_portal_u' applies only to front-to-rear transitions, and 'vlan_id' or 'ip_cidr' annotate logical network links. Use when both endpoint devices are mounted inside the rack; use disconnect_cables to remove cables, or plan_external_endpoints to terminate incoming building cable drops on a patch panel.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cables": {
"description": "Batch of one or more cable connections to upsert by cable_id, route in 3D, and validate (max 128 per call).",
"items": {
"description": "Point-to-point physical cable connection between two ports.",
"properties": {
"cable_id": {
"description": "Unique identifier for the cable connection.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"cable_type": {
"description": "Standardized physical cable and connector assembly type.",
"enum": [
"cat6a",
"cat6a-angled",
"cat6",
"cat6-angled",
"cat5e",
"cat5e-angled",
"sfp-plus-dac",
"sfp-plus-dac-angled",
"fiber-lc-duplex",
"fiber-lc-duplex-angled",
"rj45-serial-rollover",
"rj45-serial-rollover-angled",
"power-c13-c14",
"power-c13-c14-angled",
"power-schuko-c13",
"power-schuko-c13-angled",
"power-dc-5525",
"power-dc-5525-angled",
"power-usb-c",
"power-usb-c-angled"
],
"type": "string"
},
"color_hex": {
"default": "#3B82F6",
"description": "Hex color code for 2D/3D cable visualization.",
"pattern": "^#[0-9A-Fa-f]{6}$",
"type": "string"
},
"from": {
"description": "Source or destination port endpoint of a physical cable.",
"properties": {
"face": {
"description": "Explicit rack face selector (used to distinguish front vs rear connections on passthrough couplers).",
"enum": [
"front",
"rear"
],
"type": "string"
},
"instance_id": {
"description": "Target device instance_id (top-level or child sub-module).",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"port_id": {
"description": "Target port_id on the device.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"instance_id",
"port_id"
],
"type": "object"
},
"ip_cidr": {
"description": "Optional IPv4/IPv6 subnet or interface CIDR annotation (e.g. \"10.10.20.0/24\").",
"maxLength": 64,
"type": "string"
},
"label": {
"description": "Optional cable label or circuit tag.",
"maxLength": 240,
"type": "string"
},
"preferred_portal_u": {
"description": "Optional 1-indexed U hint for front-to-rear cable portal routing.",
"exclusiveMinimum": 0,
"maximum": 60,
"type": "integer"
},
"routing_mode": {
"default": "shortest-direct",
"description": "Optional routing strategy override: defaults to shortest-direct (shortest collision-free path); set to left-duct or right-duct only when the user explicitly requests routing via a side cable duct.",
"enum": [
"shortest-direct",
"left-duct",
"right-duct"
],
"type": "string"
},
"to": {
"description": "Source or destination port endpoint of a physical cable.",
"properties": {
"face": {
"description": "Explicit rack face selector (used to distinguish front vs rear connections on passthrough couplers).",
"enum": [
"front",
"rear"
],
"type": "string"
},
"instance_id": {
"description": "Target device instance_id (top-level or child sub-module).",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"port_id": {
"description": "Target port_id on the device.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"instance_id",
"port_id"
],
"type": "object"
},
"vlan_id": {
"description": "Optional IEEE 802.1Q primary VLAN ID carried on this link (1..4094).",
"maximum": 4094,
"minimum": 1,
"type": "integer"
}
},
"required": [
"cable_id",
"from",
"to",
"cable_type"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
}
},
"required": [
"cables"
],
"type": "object"
},
"name": "connect_cables"
},
{
"description": "Validate and register a custom hardware blueprint into the active catalog so unlisted equipment can be mounted. Pass the entire specification inside the top-level 'blueprint' object: 'blueprint.slug' must use lowercase kebab-case, ports may combine explicit 'ports[]' with repeating 'port_groups[]' macros whose coordinates fit strictly within 'blueprint.geometry' without overlapping, and 'slots[]' applies only when 'mount_type' is 'modular-carrier' whereas 'slot_compatibility' applies to 'sub-module'. Persists YAML to the local custom-catalog folder in stdio mode or session memory on remote servers, overwrites same-slug custom entries without touching mounted rack state or undo history, and returns status 'INVALID' instead of throwing on validation errors. Use only after search_catalog confirms hardware is unlisted; use mount_equipment instead to place an already registered blueprint into the rack.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"blueprint": {
"description": "Complete custom hardware blueprint specification; ports may be defined via explicit ports[], repeating port_groups[] macros, or both.",
"properties": {
"category": {
"description": "Primary functional category of the hardware unit.",
"enum": [
"switch",
"router",
"compute-node",
"mini-pc",
"sbc",
"nas",
"patch-panel",
"pdu",
"ups",
"modular-carrier",
"brush-panel",
"blanking-panel",
"blank-panel",
"shelf",
"keystone-module"
],
"type": "string"
},
"description": {
"description": "Human-readable explanation of what the device is, its role in the rack, and its physical mounting method (e.g. native rack ears vs. 3D-printed carrier/cradle).",
"maxLength": 2000,
"type": "string"
},
"geometry": {
"description": "Physical 3D bounding dimensions and mass specification.",
"properties": {
"depth_mm": {
"description": "Physical chassis depth in millimeters along the Z-axis (max 2000mm).",
"exclusiveMinimum": 0,
"maximum": 2000,
"type": "number"
},
"ear_mount_style": {
"default": "flush-front",
"description": "Mounting ear geometry relative to the vertical rack rails.",
"enum": [
"included-19inch-ears",
"included-10inch-ears",
"included-6inch-ears",
"flush-front",
"recessed-20mm",
"sub-module-clip",
"rear-rail-mount",
"none"
],
"type": "string"
},
"front_protrusion_mm": {
"default": 0,
"description": "Protrusion in front of Z=0 (handles, ears, knobs) in mm.",
"maximum": 500,
"minimum": 0,
"type": "number"
},
"has_cable_pass_through": {
"description": "True if cables can pass front-to-rear through this unit.",
"type": "boolean"
},
"height_mm": {
"description": "Physical chassis height in millimeters (max 3000mm).",
"exclusiveMinimum": 0,
"maximum": 3000,
"type": "number"
},
"rear_protrusion_mm": {
"default": 0,
"description": "Protrusion behind depth_mm (fans, PSU handles) in mm.",
"maximum": 500,
"minimum": 0,
"type": "number"
},
"u_height": {
"description": "Nominal height in Rack Units (1U = 44.45mm, max 60U).",
"maximum": 60,
"minimum": 0,
"type": "number"
},
"weight_grams": {
"default": 0,
"description": "Total device mass in grams for Center of Gravity calculation.",
"maximum": 500000,
"minimum": 0,
"type": "number"
},
"width_mm": {
"description": "Physical chassis body width in millimeters (max 1000mm).",
"exclusiveMinimum": 0,
"maximum": 1000,
"type": "number"
}
},
"required": [
"u_height",
"width_mm",
"height_mm",
"depth_mm"
],
"type": "object"
},
"is_passthrough_coupler": {
"description": "True if the entire unit acts as a passive front-to-rear feedthrough patch panel.",
"type": "boolean"
},
"manufacturer": {
"description": "Hardware manufacturer name.",
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"model": {
"description": "Hardware model name or part number.",
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"mount_type": {
"description": "Physical form factor and mounting mechanism.",
"enum": [
"rackmount-19",
"rackmount-10",
"rackmount-6",
"sub-module",
"shelf-standing"
],
"type": "string"
},
"port_groups": {
"default": [],
"description": "Optional repeating port grid macros expanded into flat ports[] upon registration.",
"items": {
"description": "Declarative port matrix macro expanded into flat PortDefinition items on load.",
"properties": {
"capabilities": {
"default": [],
"description": "Capabilities assigned to every port generated by this group.",
"items": {
"description": "Supported electrical, optical, or PoE protocol capability.",
"enum": [
"100base-tx",
"1000base-t",
"2500base-t",
"5gbase-t",
"10gbase-t",
"10gbase-sr",
"10gbase-lr",
"10gbase-dac",
"25gbase-dac",
"poe-out",
"poe+",
"poe-out-af",
"poe-out-at",
"poe-out-bt-type3",
"poe-out-bt-type4",
"poe-in-af",
"poe-in-at",
"poe-in-bt-type3",
"poe-in-bt-type4",
"ac-mains",
"dc-power",
"usb-pd",
"usb-3.0",
"usb-3.1",
"audio-analog",
"serial-rs232",
"passthrough-coupler"
],
"type": "string"
},
"maxItems": 32,
"type": "array"
},
"connector_type": {
"description": "Physical connector interface type.",
"enum": [
"rj45",
"rj45-serial-console",
"sfp-plus",
"iec-c13",
"iec-c14",
"schuko-cee7",
"dc-5525",
"usb-c",
"usb-a",
"audio-35mm"
],
"type": "string"
},
"count": {
"description": "Total number of ports to generate in this group (1..128).",
"exclusiveMinimum": 0,
"maximum": 128,
"type": "integer"
},
"direction": {
"description": "Signal or electrical power flow direction.",
"enum": [
"input",
"output",
"bidirectional"
],
"type": "string"
},
"face": {
"description": "Mounting or port face relative to the rack or chassis.",
"enum": [
"front",
"rear"
],
"type": "string"
},
"grid": {
"description": "2D grid layout parameters for automatic port matrix expansion.",
"properties": {
"columns": {
"description": "Number of horizontal port columns in the matrix (1..64).",
"exclusiveMinimum": 0,
"maximum": 64,
"type": "integer"
},
"origin_x_mm": {
"description": "X coordinate of the first port (column 0) in mm.",
"maximum": 2000,
"minimum": -2000,
"type": "number"
},
"origin_y_mm": {
"description": "Y coordinate of the first port (row 0) in mm.",
"maximum": 3000,
"minimum": -3000,
"type": "number"
},
"pitch_x_mm": {
"description": "Horizontal center-to-center spacing between adjacent columns in mm.",
"maximum": 500,
"minimum": -500,
"type": "number"
},
"pitch_y_mm": {
"description": "Vertical center-to-center spacing between adjacent rows in mm.",
"maximum": 500,
"minimum": -500,
"type": "number"
},
"rows": {
"description": "Number of vertical port rows in the matrix (1..16).",
"exclusiveMinimum": 0,
"maximum": 16,
"type": "integer"
}
},
"required": [
"origin_x_mm",
"origin_y_mm",
"columns",
"rows",
"pitch_x_mm",
"pitch_y_mm"
],
"type": "object"
},
"id_prefix": {
"description": "Prefix for generated port_id values (e.g. \"eth\").",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"is_passthrough_coupler": {
"description": "True if generated ports are passive front-to-rear couplers.",
"type": "boolean"
},
"label_prefix": {
"description": "Prefix for generated human-readable labels.",
"maxLength": 96,
"type": "string"
},
"orientation": {
"default": "upright",
"description": "Physical orientation of the connector latch/keyway.",
"enum": [
"upright",
"inverted",
"left",
"right"
],
"type": "string"
},
"start_index": {
"default": 1,
"description": "Starting numeric suffix for generated port IDs (default: 1).",
"maximum": 10000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"id_prefix",
"count",
"face",
"connector_type",
"direction",
"grid"
],
"type": "object"
},
"maxItems": 16,
"type": "array"
},
"ports": {
"default": [],
"description": "Explicit physical ports with local face millimeter coordinates.",
"items": {
"description": "Explicit physical port definition with local millimeter coordinates.",
"properties": {
"capabilities": {
"default": [],
"description": "Electrical, optical, or PoE capabilities supported by this port.",
"items": {
"description": "Supported electrical, optical, or PoE protocol capability.",
"enum": [
"100base-tx",
"1000base-t",
"2500base-t",
"5gbase-t",
"10gbase-t",
"10gbase-sr",
"10gbase-lr",
"10gbase-dac",
"25gbase-dac",
"poe-out",
"poe+",
"poe-out-af",
"poe-out-at",
"poe-out-bt-type3",
"poe-out-bt-type4",
"poe-in-af",
"poe-in-at",
"poe-in-bt-type3",
"poe-in-bt-type4",
"ac-mains",
"dc-power",
"usb-pd",
"usb-3.0",
"usb-3.1",
"audio-analog",
"serial-rs232",
"passthrough-coupler"
],
"type": "string"
},
"maxItems": 32,
"type": "array"
},
"connector_type": {
"description": "Physical connector interface type.",
"enum": [
"rj45",
"rj45-serial-console",
"sfp-plus",
"iec-c13",
"iec-c14",
"schuko-cee7",
"dc-5525",
"usb-c",
"usb-a",
"audio-35mm"
],
"type": "string"
},
"coordinates": {
"description": "Local 2D coordinates on the device face in millimeters.",
"properties": {
"orientation": {
"default": "upright",
"description": "Physical orientation of the connector latch/keyway.",
"enum": [
"upright",
"inverted",
"left",
"right"
],
"type": "string"
},
"x_mm": {
"description": "Horizontal offset in mm from the bottom-left corner of the face.",
"type": "number"
},
"y_mm": {
"description": "Vertical offset in mm from the bottom-left corner of the face.",
"type": "number"
}
},
"required": [
"x_mm",
"y_mm"
],
"type": "object"
},
"direction": {
"description": "Signal or electrical power flow direction.",
"enum": [
"input",
"output",
"bidirectional"
],
"type": "string"
},
"face": {
"description": "Mounting or port face relative to the rack or chassis.",
"enum": [
"front",
"rear"
],
"type": "string"
},
"is_passthrough_coupler": {
"description": "True if this port is a passive front-to-rear feedthrough coupler.",
"type": "boolean"
},
"label": {
"description": "Human-readable silk-screened port label.",
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"port_id": {
"description": "Unique identifier of the port within the device.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"port_id",
"label",
"face",
"connector_type",
"direction",
"coordinates"
],
"type": "object"
},
"maxItems": 256,
"type": "array"
},
"power_and_thermal": {
"description": "Electrical power consumption, PoE budget, thermal airflow, and acoustic dB(A) characteristics.",
"properties": {
"airflow": {
"default": "passive-convection",
"description": "Primary thermal airflow path through the device chassis.",
"enum": [
"front-to-rear",
"rear-to-front",
"side-to-side",
"passive-convection",
"none"
],
"type": "string"
},
"electrical_role": {
"description": "Role in the electrical and PoE Directed Acyclic Graph (DAG).",
"enum": [
"consumer",
"pse-switch",
"pdu",
"ups",
"passive"
],
"type": "string"
},
"idle_watts": {
"default": 0,
"description": "Idle power draw in watts.",
"minimum": 0,
"type": "number"
},
"max_system_watts": {
"default": 0,
"description": "Peak own system power consumption in watts (excluding PoE output).",
"minimum": 0,
"type": "number"
},
"noise_db_a": {
"description": "Acoustic noise emission in dB(A) at 1 meter distance.",
"minimum": 0,
"type": "number"
},
"pdu_capacity_watts": {
"description": "Maximum output load capacity in watts for PDU units.",
"exclusiveMinimum": 0,
"type": "number"
},
"poe_budget_watts": {
"description": "Maximum total PoE output power budget in watts for PSE switches.",
"minimum": 0,
"type": "number"
},
"ups_capacity_watts": {
"description": "Maximum output load capacity in watts for UPS units.",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"electrical_role"
],
"type": "object"
},
"printable_metadata": {
"anyOf": [
{
"properties": {
"fasteners": {
"description": "Optional specification of required mounting screws and cage nuts.",
"maxLength": 256,
"type": "string"
},
"filament_grams": {
"description": "Estimated filament mass in grams.",
"maximum": 50000,
"minimum": 0,
"type": "number"
},
"heat_set_inserts": {
"description": "Optional specification of required brass heat-set inserts.",
"maxLength": 256,
"type": "string"
},
"material_recommendation": {
"default": "PETG",
"description": "Recommended 3D printing filament material (e.g. \"PETG\", \"ABS\", \"ASA\").",
"maxLength": 128,
"type": "string"
},
"printables_url": {
"description": "Optional HTTPS reference URL to an upstream 3D model repository.",
"maxLength": 512,
"pattern": "^https?:\\/\\/",
"type": "string"
}
},
"required": [
"filament_grams"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "3D printing fabrication metadata for printable modular carriers."
},
"slot_compatibility": {
"description": "Slot compatibility token when mount_type is \"sub-module\".",
"maxLength": 100,
"type": "string"
},
"slots": {
"default": [],
"description": "Sub-module carrier bays when mount_type is \"modular-carrier\".",
"items": {
"description": "Sub-U carrier bay specification for modular child devices.",
"properties": {
"accepted_slot_type": {
"description": "Required child slot_compatibility token (e.g. \"mini-pc-1liter\").",
"minLength": 1,
"type": "string"
},
"max_dimensions_mm": {
"description": "Maximum internal bounding dimensions of a carrier slot in mm.",
"properties": {
"depth": {
"description": "Maximum allowed child depth in mm.",
"exclusiveMinimum": 0,
"type": "number"
},
"height": {
"description": "Maximum allowed child height in mm.",
"exclusiveMinimum": 0,
"type": "number"
},
"width": {
"description": "Maximum allowed child width in mm.",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"width",
"height",
"depth"
],
"type": "object"
},
"offset_mm": {
"description": "Local 3D offset of a sub-module slot relative to its parent carrier.",
"properties": {
"x": {
"description": "Local X offset from carrier origin in mm.",
"type": "number"
},
"y": {
"description": "Local Y offset from carrier origin in mm.",
"type": "number"
},
"z": {
"default": 0,
"description": "Local Z offset from carrier origin in mm.",
"type": "number"
}
},
"required": [
"x",
"y"
],
"type": "object"
},
"slot_id": {
"description": "Unique slot identifier within the carrier.",
"minLength": 1,
"type": "string"
}
},
"required": [
"slot_id",
"accepted_slot_type",
"offset_mm",
"max_dimensions_mm"
],
"type": "object"
},
"maxItems": 32,
"type": "array"
},
"slug": {
"description": "Unique lowercase kebab-case hardware identifier (vendor-model-variant).",
"maxLength": 100,
"minLength": 1,
"pattern": "^[a-z0-9-]+$",
"type": "string"
},
"visuals": {
"default": {
"chassis_color_hex": "#E5E7EB",
"has_oled_display": false,
"material_preset": "matte-black-steel",
"stl_mesh_path": null
},
"description": "Visual rendering metadata for 2D SVG and 3D WebGL pipelines.",
"properties": {
"chassis_color_hex": {
"default": "#E5E7EB",
"description": "Primary chassis hex color code.",
"pattern": "^#[0-9A-Fa-f]{6}$",
"type": "string"
},
"has_oled_display": {
"default": false,
"description": "True if the front panel includes a status OLED screen.",
"type": "boolean"
},
"material_preset": {
"default": "matte-black-steel",
"description": "Surface material shader preset for 3D procedural rendering.",
"enum": [
"matte-black-steel",
"coated-aluminum",
"3d-printed-petg",
"3d-printed-abs",
"polycarbonate"
],
"type": "string"
},
"stl_mesh_path": {
"default": null,
"description": "Optional relative path to custom 3D mesh (.stl/.glb).",
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
"required": [
"slug",
"manufacturer",
"model",
"category",
"mount_type",
"geometry",
"power_and_thermal"
],
"type": "object"
}
},
"required": [
"blueprint"
],
"type": "object"
},
"name": "define_custom_blueprint"
},
{
"description": "Remove specific cables by identifier or strip all cables attached to a mounted device or modular carrier from the active rack, then re-evaluate PoE budgets and plug clearances. Supply a non-empty 'cable_ids' list, 'instance_id', or both to disconnect their union; 'instance_id' matches both 'from' and 'to' endpoints across a carrier and its child sub-modules while leaving external patch-panel drops intact, whereas omitting both or passing only an empty list returns status 'INVALID' with a PORT_NOT_FOUND issue and zero mutations. Valid calls push an undo snapshot, persist rack.yaml atomically, and return removed IDs, remaining cable count, and updated validation results, succeeding idempotently when targeted IDs are already absent. Use when rewiring ports while keeping hardware mounted; use connect_cables to add or replace cables, or modify_equipment with action 'remove' to delete a device and its cables.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cable_ids": {
"description": "Specific cable_id values to disconnect (can be combined with instance_id; at least one of cable_ids or instance_id must be provided).",
"items": {
"type": "string"
},
"type": "array"
},
"instance_id": {
"description": "Mounted device or modular-carrier instance_id whose attached cables (including child sub-module cables) should all be disconnected.",
"type": "string"
}
},
"type": "object"
},
"name": "disconnect_cables"
},
{
"description": "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 and creates missing folders. Local stdio execution writes deterministic filenames—elevation.svg, wiring-schematic.svg, BOM.md, rack-scene.glb, and <slug>.scad or <slug>.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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"formats": {
"default": [
"elevation-svg",
"wiring-svg",
"bom-md",
"scene-glb",
"carrier-scad",
"carrier-stl"
],
"description": "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).",
"items": {
"enum": [
"elevation-svg",
"wiring-svg",
"bom-md",
"scene-glb",
"carrier-scad",
"carrier-stl"
],
"type": "string"
},
"type": "array"
},
"output_dir": {
"description": "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).",
"type": "string"
}
},
"type": "object"
},
"name": "export_deliverables"
},
{
"description": "Retrieve the complete hardware specification, millimeter port coordinates, electrical and PoE ratings, and carrier slot geometry for a single catalog blueprint. The 'slug' parameter requires a case-sensitive exact match in lowercase kebab-case vendor-model-variant format against the built-in or session custom catalog; partial substrings or uppercase characters do not match. Returns the full blueprint in one unpaginated payload with repeating port_groups pre-expanded into up to 256 flat ports[] entries, or returns status 'INVALID' with a BLUEPRINT_NOT_FOUND issue and candidate slugs instead of throwing. Use when you already know the target slug and need exact port_id or slot_id values for mount_equipment or connect_cables; use search_catalog instead to discover unknown slugs by criteria.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"slug": {
"description": "Exact lowercase kebab-case hardware catalog blueprint slug to retrieve (discoverable via search_catalog).",
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_device_blueprint"
},
{
"description": "Initialize a new rack project and destructively reset the active rack.yaml state to an empty enclosure with the specified width standard, U height, and rail depth. Overwrites the current enclosure and clears all mounted devices, child sub-modules, cables, and external endpoints, while pushing the previous project state onto the in-memory undo stack for recovery via undo_redo. 'project_name' sets the title used in exported schematics and BOMs, 'rail_depth_mm' plus 'rear_clearance_mm' bounds total +Z chassis and rear plug depth before wall collision, and 'front_door_clearance_mm' is enforced only when 'enclosure_type' has a closed front door. Use when starting a rack design from scratch or changing enclosure dimensions; use validate_rack to inspect the current rack, or modify_equipment to move or remove individual devices.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"enclosure_type": {
"default": "open-frame",
"description": "Enclosure door style (\"open-frame\", \"closed-glass-front\", or \"closed-vented-front\").",
"enum": [
"open-frame",
"closed-glass-front",
"closed-vented-front"
],
"type": "string"
},
"front_door_clearance_mm": {
"default": 45,
"description": "Available clearance in millimeters between front mounting rails (Z=0) and a closed front door.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"project_name": {
"default": "Rack Project",
"description": "Human-readable project name stored in rack.yaml.",
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"rail_depth_mm": {
"description": "Front-to-rear mounting rail depth in millimeters along the Z-axis (max 2000mm).",
"exclusiveMinimum": 0,
"maximum": 2000,
"type": "number"
},
"rear_clearance_mm": {
"default": 40,
"description": "Available clearance in millimeters behind the rear mounting rails (Z=rail_depth_mm) for power plugs and bending radii.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"standard": {
"description": "Mechanical rack width standard (\"19inch\" = 482.6mm, \"10inch\" = 254.0mm, \"6inch\" = 152.4mm).",
"enum": [
"19inch",
"10inch",
"6inch"
],
"type": "string"
},
"u_height": {
"description": "Total usable vertical rack height in Rack Units (1U = 44.45mm, 1..60U).",
"exclusiveMinimum": 0,
"maximum": 60,
"type": "integer"
}
},
"required": [
"standard",
"u_height",
"rail_depth_mm"
],
"type": "object"
},
"name": "init_rack"
},
{
"description": "Move, rename, or destructively remove an existing mounted device or child sub-module in the active rack, recalculate 3D cable splines, and re-run 5-stage validation. 'instance_id' resolves across top-level devices and carrier sub-modules, and required fields depend on 'action': 'move' updates 'u_position' and 'face' on rackmount gear or 'slot_id' and optional 'parent_carrier_id' across carriers for sub-modules with primary fields taking precedence over 'new_*' aliases, 'rename' updates or clears 'hostname', and 'remove' cascades to child sub-modules plus attached cables and external endpoints when 'remove_connected_cables' is true. Pushes the prior state onto the undo stack and updates rack.yaml atomically, or returns status 'INVALID' without mutating state when 'instance_id' or a target carrier is unknown. Use to update or delete a mounted instance; use mount_equipment to add new hardware, or disconnect_cables to remove cables while keeping devices mounted.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"action": {
"description": "Modification operation: \"move\" relocates a device, \"rename\" updates its hostname, and \"remove\" deletes the device instance.",
"enum": [
"move",
"rename",
"remove"
],
"type": "string"
},
"face": {
"description": "New mounting face (\"front\" or \"rear\") when action is \"move\" on a rackmount device (takes precedence over new_face).",
"enum": [
"front",
"rear"
],
"type": "string"
},
"hostname": {
"description": "New logical hostname when action is \"rename\" (takes precedence over new_hostname).",
"minLength": 1,
"type": "string"
},
"instance_id": {
"description": "Existing mounted device or child sub-module instance_id to modify.",
"minLength": 1,
"type": "string"
},
"new_face": {
"description": "Optional alias for face when action is \"move\".",
"enum": [
"front",
"rear"
],
"type": "string"
},
"new_hostname": {
"description": "Optional alias for hostname when action is \"rename\".",
"minLength": 1,
"type": "string"
},
"new_u_position": {
"description": "Optional alias for u_position when action is \"move\".",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"parent_carrier_id": {
"description": "Target parent carrier instance_id when action is \"move\" on a child sub-module.",
"minLength": 1,
"type": "string"
},
"remove_connected_cables": {
"default": true,
"description": "When action is \"remove\", whether to automatically disconnect all cables and external endpoints attached to the removed device (default: true).",
"type": "boolean"
},
"slot_id": {
"description": "Target slot_id inside parent_carrier_id when action is \"move\" on a child sub-module.",
"minLength": 1,
"type": "string"
},
"u_position": {
"description": "New 1-indexed U position when action is \"move\" on a direct rackmount device (takes precedence over new_u_position).",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"instance_id",
"action"
],
"type": "object"
},
"name": "modify_equipment"
},
{
"description": "Mount a new hardware device instance onto a rack unit or into a modular carrier bay in the active rack.yaml project and run 5-stage validation. 'instance_id' must be unique across both top-level devices and nested sub-modules, 'blueprint_slug' must reference an existing catalog or custom slug, and placement uses two mutually exclusive modes: 'u_position' with optional 'face' where the device's full U span fits within 1..u_height, or 'parent_carrier_id' plus a compatible 'slot_id' for sub-modules. Precondition errors such as duplicate 'instance_id', unknown 'blueprint_slug', or missing carriers return status 'INVALID' without mutating state, whereas 3D collision or PoE issues persist the mount, push an undo snapshot, and return remediation_suggestions. Use to add a new device instance; use modify_equipment to move, rename, or remove an existing instance, or plan_external_endpoints for off-rack room cable drops.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"blueprint_slug": {
"description": "Catalog or custom hardware blueprint slug to instantiate.",
"minLength": 1,
"type": "string"
},
"face": {
"default": "front",
"description": "Target rack mounting face (\"front\" or \"rear\") for direct rackmount equipment.",
"enum": [
"front",
"rear"
],
"type": "string"
},
"hostname": {
"description": "Optional logical hostname or display label shown in elevations and schematics.",
"type": "string"
},
"instance_id": {
"description": "Unique project-wide instance identifier for this mounted device (e.g., \"ups-u1\", \"sw-core-01\").",
"minLength": 1,
"type": "string"
},
"parent_carrier_id": {
"description": "Mounted parent modular-carrier instance_id when mounting a sub-module (requires slot_id; mutually exclusive with u_position).",
"type": "string"
},
"slot_id": {
"description": "Target bay slot_id inside parent_carrier_id when mounting a sub-module (e.g., \"left-bay\", \"keystone-1\").",
"type": "string"
},
"u_position": {
"description": "1-indexed lowest Rack Unit (U) when mounting directly onto the rack rails (mutually exclusive with parent_carrier_id/slot_id).",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"instance_id",
"blueprint_slug"
],
"type": "object"
},
"name": "mount_equipment"
},
{
"description": "Terminate external building or room cable drops onto the rear RJ45 ports of a mounted patch panel without consuming rack U slots, and optionally auto-create labeled Cat6A front patch cables to a mounted switch. 'groups[]' batch-generates drops first—with 'custom_labels[]' overriding numbered 'label_prefix' entries per index—followed by 'endpoints[]', allocating sequential free rear ports from 'start_port_number' and sequential free switch RJ45 ports from 'auto_connect_switch_start_port'. Setting 'clear_existing' destructively removes prior external drops on 'patch_panel_instance_id' and their front patch cables before allocation, while unmounted patch-panel or switch IDs return status 'INVALID' without mutating state. Use for off-rack building wiring entering the enclosure; never mount room endpoints via mount_equipment, and use connect_cables for purely internal rack-to-rack links.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"auto_connect_switch_instance_id": {
"description": "Optional switch instance_id to automatically patch from the front of the patch panel using labeled Cat6A cables.",
"minLength": 1,
"type": "string"
},
"auto_connect_switch_start_port": {
"default": 1,
"description": "1-indexed starting Ethernet port number on auto_connect_switch_instance_id (e.g., 1 for eth1).",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"clear_existing": {
"default": false,
"description": "If true, destructively clears existing external_endpoints (and their front patch cables) on patch_panel_instance_id before planning.",
"type": "boolean"
},
"endpoints": {
"description": "Individual external building/room drops to terminate on the rear of the patch panel.",
"items": {
"properties": {
"category": {
"default": "other-lan",
"description": "Physical category of an external building or room drop entering the rack from outside.",
"enum": [
"poe-camera",
"wifi-ap",
"wall-outlet-pc",
"projector-media",
"workstation-dock",
"iot-controller",
"isp-wan-uplink",
"other-lan"
],
"type": "string"
},
"color_hex": {
"description": "Optional hex color code for this drop and its front patch cable.",
"pattern": "^#[0-9A-Fa-f]{6}$",
"type": "string"
},
"endpoint_id": {
"description": "Optional explicit endpoint_id (auto-generated if omitted).",
"minLength": 1,
"type": "string"
},
"label": {
"description": "Human-readable label for this room/device drop (e.g., \"Kamera 1 – Einfahrt\").",
"minLength": 1,
"type": "string"
},
"notes": {
"description": "Optional installation notes.",
"type": "string"
},
"patch_panel_port_id": {
"description": "Optional explicit patch panel port_id (e.g., \"p1\"); auto-assigned sequentially if omitted.",
"minLength": 1,
"type": "string"
},
"poe_draw_watts": {
"default": 0,
"description": "Required PoE power draw in watts (0 for non-PoE LAN).",
"minimum": 0,
"type": "number"
},
"required_speed": {
"default": "1gbe",
"description": "Required Ethernet link speed for the external room/device drop.",
"enum": [
"100m",
"1gbe",
"2.5gbe",
"10gbe"
],
"type": "string"
},
"room_or_zone": {
"description": "Optional building zone or room name.",
"type": "string"
},
"vlan_id": {
"description": "Optional VLAN ID (1..4094).",
"maximum": 4094,
"minimum": 1,
"type": "integer"
}
},
"required": [
"label"
],
"type": "object"
},
"maxItems": 128,
"type": "array"
},
"entry_position": {
"default": "top-rear",
"description": "Rear building cable conduit entry point into the rack frame.",
"enum": [
"top-rear",
"bottom-rear"
],
"type": "string"
},
"groups": {
"description": "Batch groups of external drops (e.g., 10x PoE cameras, 5x Wi-Fi APs, 5x room LAN outlets).",
"items": {
"properties": {
"category": {
"default": "other-lan",
"description": "Physical category of an external building or room drop entering the rack from outside.",
"enum": [
"poe-camera",
"wifi-ap",
"wall-outlet-pc",
"projector-media",
"workstation-dock",
"iot-controller",
"isp-wan-uplink",
"other-lan"
],
"type": "string"
},
"color_hex": {
"description": "Hex color code for this group of cables (defaults to category color if omitted).",
"pattern": "^#[0-9A-Fa-f]{6}$",
"type": "string"
},
"count": {
"default": 1,
"description": "Number of external cable drops in this group (1..96).",
"exclusiveMinimum": 0,
"maximum": 96,
"type": "integer"
},
"custom_labels": {
"description": "Optional per-item custom labels overriding numbered prefix (e.g., [\"Büro – PC\", \"Heimkino – Beamer\", \"Studio – Workstation\"]).",
"items": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"maxItems": 96,
"type": "array"
},
"id_prefix": {
"description": "Optional ID prefix for generated endpoints (e.g., \"cam\", \"ap\", \"room\").",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"label_prefix": {
"description": "Human-readable label prefix (e.g., \"Kamera\", \"WLAN Access Point\", \"Raum LAN\").",
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"poe_draw_watts": {
"default": 0,
"description": "PoE power draw in watts per drop (0 for standard LAN; e.g., 9 for PoE camera, 18 for Wi-Fi AP).",
"minimum": 0,
"type": "number"
},
"required_speed": {
"default": "1gbe",
"description": "Required Ethernet link speed for the external room/device drop.",
"enum": [
"100m",
"1gbe",
"2.5gbe",
"10gbe"
],
"type": "string"
},
"room_or_zone": {
"description": "Building zone or room name (e.g., \"Außenbereich\", \"EG Wohnzimmer\", \"Wohnräume\").",
"maxLength": 160,
"type": "string"
},
"vlan_id": {
"description": "Optional IEEE 802.1Q VLAN ID assigned to this group.",
"maximum": 4094,
"minimum": 1,
"type": "integer"
}
},
"required": [
"label_prefix"
],
"type": "object"
},
"maxItems": 24,
"type": "array"
},
"patch_panel_instance_id": {
"description": "Mounted patch panel instance_id whose rear ports receive the incoming building cable drops.",
"minLength": 1,
"type": "string"
},
"start_port_number": {
"description": "1-indexed starting port number on the patch panel (defaults to next free rear port or 1).",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"patch_panel_instance_id"
],
"type": "object"
},
"name": "plan_external_endpoints"
},
{
"description": "Search and filter the local hardware catalog to discover compatible rackmount devices, modular carriers, and sub-modules before mounting. All supplied filters combine with logical AND: 'form_factor' and its alias 'mount_type' accept width shorthands '10inch', '19inch', and '6inch' that match both direct rackmount gear and modular carriers, 'accepted_slot_type' matches both carrier bays and compatible sub-modules, and 'max_depth_mm' bounds chassis depth excluding plug clearance. Returns all matches from the bounded catalog in one unpaginated response sorted in deterministic registration order, with built-in blueprints followed by custom blueprints. Call with no arguments to list the full catalog; use get_device_blueprint to inspect expanded port coordinates for a known slug, or define_custom_blueprint to register unlisted hardware.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"accepted_slot_type": {
"description": "Sub-module slot compatibility token matching either a sub-module slot_compatibility or a carrier slot accepted_slot_type (e.g., \"mini-pc-1liter\", \"sbc-rpi5\", \"standard-keystone\").",
"minLength": 1,
"type": "string"
},
"category": {
"description": "Functional hardware category filter (e.g., \"switch\", \"router\", \"ups\", \"pdu\", \"patch-panel\", \"modular-carrier\", \"mini-pc\", \"sbc\").",
"enum": [
"switch",
"router",
"compute-node",
"mini-pc",
"sbc",
"nas",
"patch-panel",
"pdu",
"ups",
"modular-carrier",
"brush-panel",
"blanking-panel",
"blank-panel",
"shelf",
"keystone-module"
],
"type": "string"
},
"form_factor": {
"description": "Primary rack width or mounting form-factor filter (shorthands \"10inch\", \"19inch\", and \"6inch\" match both direct rackmount equipment and modular carriers of that width).",
"enum": [
"rackmount-19",
"rackmount-10",
"rackmount-6",
"sub-module",
"shelf-standing",
"10inch",
"19inch",
"6inch"
],
"type": "string"
},
"max_depth_mm": {
"description": "Maximum allowed chassis depth in millimeters (inclusive upper bound).",
"exclusiveMinimum": 0,
"type": "number"
},
"min_poe_budget_watts": {
"description": "Minimum required PSE PoE output power budget in watts (inclusive lower bound).",
"minimum": 0,
"type": "number"
},
"mount_type": {
"description": "Optional alias for form_factor to filter by physical mounting style (\"rackmount-10\", \"rackmount-19\", \"rackmount-6\", \"sub-module\", or \"shelf-standing\"); combined with logical AND if both are provided.",
"enum": [
"rackmount-19",
"rackmount-10",
"rackmount-6",
"sub-module",
"shelf-standing",
"10inch",
"19inch",
"6inch"
],
"type": "string"
},
"query": {
"description": "Optional case-insensitive substring filter matching slug, manufacturer, or model name (omit to match all).",
"type": "string"
}
},
"type": "object"
},
"name": "search_catalog"
},
{
"description": "Traverse the per-project in-memory history ring buffer of up to 50 snapshots to revert the latest rack mutation or reapply a reverted mutation, updating rack.yaml atomically. Setting 'action' to 'undo' steps backward across rack-state mutations—excluding catalog-only define_custom_blueprint calls and read-only tools—and pushes the displaced state onto the redo stack, whereas 'redo' is available only immediately after 'undo' because any new rack mutation flushes the redo stack. Calling either action when its target stack is empty is a safe no-op returning applied=false without throwing. Use to roll back an unintended batch change or accidental init_rack reset; use modify_equipment or disconnect_cables instead to edit specific items without reverting intermediate steps.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"action": {
"description": "History traversal direction: \"undo\" reverts the most recent state mutation, \"redo\" reapplies a reverted mutation.",
"enum": [
"undo",
"redo"
],
"type": "string"
}
},
"required": [
"action"
],
"type": "object"
},
"name": "undo_redo"
},
{
"description": "Inspect the active rack.yaml state and run all 5 deterministic validation stages covering mechanical bounds, 3D depth and plug clearances, PoE and power budgets, cable compatibility, and thermal limits. Takes no parameters, performs zero state or undo-stack mutations, and returns the ASCII front and rear elevation diagram, power utilization summary, and all diagnostic issues with remediation_suggestions. Sets status to 'INVALID' instead of throwing whenever any validation ERROR is present. Use to inspect currently mounted equipment or verify zero errors before exporting; use export_deliverables instead to generate SVG, BOM, GLB, or 3D-print files.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "validate_rack"
}
]
}What the leaf hashes
{"body":"9a3ca167d45a3f0d550e2f4464e300999c10d26295ee4c44453c8ba692d4edec","id":1227654,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793335510446916,"prev":null,"subject":"bff46626-e052-46f3-8784-1727e3478516","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (243099 rows).
- 0xb2445fdc935fda738b0e00c6e0516a189e56507efb293a9aff6151f7399299b0
- 0xa29a3db4eb6bdf7992453c7b0530e2eb0b5b55ef641b1ab628dd715fb66433f4
- 0xde8ceb9edc1b857b228cab6b2be060396067404dd8cd3dbf96f4e42674525f0d
- 0x83beb84e2b001aea9e0c9b3c46ad95ccc7ceb8b0ee738b9eda721b6e8cf80628
- 0x4de1d10ad5a743ce83e07ecddd411d5f9c074873f610cfdd2fbb3e96bc1b8717
- 0x231768ad623530f24889e78ea30f0276c1b061cf602c34207881b57bb5dce20a
- 0x56c16d1f77e5e17dea3d1e3d49746bc1786915fee1c705eb9331d8611bcb135e
- 0xc0e5635b73faeebf8d36da8724f9afd996fc9b0e5f66952cceb742873b7e1d74
- 0x487f699dab667ffc05d3c8922c8bcdd73b6b9175c5c2dca57153e43b47a23ea0
- 0xd3be005ce2a5a51fb04e64f787d4351941f269bfa6f0950d6ad0f738cc1ac67f
- 0x8d6a53db2692d6121ad4e77a4589a4370d18d45ca5eaed8b890f3973d1096f97
- 0x7f6238372befa4ac7fc9670d71ad8b303cd8241e1a520ad04cf9afba84923d67
- 0x6d3f5dcc69c62fa01ce1c449d5b1e64f9183cf6457008284fb115d3a05c4b11f
- 0x4943cf5368ac3124a50a8845e933556cda4f3f7ee527441ef6351afbceee79d8
- 0xa0b1f6bc1eecfaf70581673c1a7f638b96d1769a5c578c460337f7db0dbe963e
- 0x0c59b8770d2782eb535aefbb9b2f6810bab4757f51b37e00f5147713a1de9481
- 0x61ef83255d34604cb052882568ca1d1386ac3cfb8284509715bc1734cff77831
- 0x0c43c73b62a5d49ee1444b5dc4195fc5b16b141d3f4458e2e9fbd5fd6ecb367d
- Day root
- 0x0826c7ad6039e06a2360ca0a4a3a4fe7f2626c6dc19f71a37599386f78b39875
- Chained
- 0x36b4c8a1063758f0b8765fa1bdf75fa92fb543cc183add3e261880ee2bd1f822
- Published
- On Arc Testnet, block 69923247: 0x8704744146c6967c8abc9e9a99de4db7283b29e840922ea83a69b6fe776e6861