Skip to main content
Glama

Recommend a material

recommend_material
Read-onlyIdempotent

Run ply's material advisor ("Help me choose" on plyparts.com) for a part: it may ask up to 2 questions about how the part is used, then recommends a process, material, color and strength. Give either the part's ply path (a file) or its template and sizes (a built part).

Tool call template

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

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

Input Schema

NameRequiredDescriptionDefault
lidNobox: lid
useYesWhat the part is for, in the customer's words (where it's used, heat, water, loads, looks)
armANotslot-plate: holes along the first arm
armBNotslot-plate: holes along the second arm
keysNotslot-bracket/mount/panel: alignment keys that sit in the slot
legANobracket: base leg length (mm)
legBNobracket: upright leg length (mm)
pathNoA file's ply path from price_file
spanNotslot-bracket: one or two profiles wide
wallNobox: wall thickness (mm)
boardNoplate/tslot-mount: a circuit board whose mounting holes ply places from the maker's drawing (rpi5 = Raspberry Pi 5, rpi4b = Raspberry Pi 4 Model B, rpi3bplus = Raspberry Pi 3 Model B+, rpizero2w = Raspberry Pi Zero 2 W / Zero W, pico = Raspberry Pi Pico, rpicam = Raspberry Pi Camera Module 3 / v2, uno = Arduino Uno (R3 / R4), mega = Arduino Mega 2560, jetson-orin-nano = NVIDIA Jetson Orin Nano Developer Kit, esp32-devkitc = Espressif ESP32-DevKitC V4, esp32-s3-devkitc = Espressif ESP32-S3-DevKitC-1 (v1.1), xiao-esp32s3 = Seeed Studio XIAO ESP32-S3, heltec-v4 = Heltec WiFi LoRa 32 V4, heltec-v3 = Heltec WiFi LoRa 32 V3, esp32-cam = AI-Thinker ESP32-CAM, ipi-smarc-rb5 = ADLINK I-Pi SMARC RB5 (I-Pi SMARC Plus carrier), esp32-devkit-v1-30 = ESP32 DevKit V1, 30 pins (generic), esp32-38-wide = ESP32 38-pin board, wide with 4 holes (generic), esp32-38-narrow = ESP32 38-pin board, narrow (fits most copies)); also give width/depth (hole pattern + 12 mm), screw and, on tslot-mount, standoffHeight
depthNoplate: depth (mm)
drainNotray: drain holes through each compartment's floor
floorNotray: floor thickness (mm)
holesNotslot-bracket: bolts per leg (1–4)
reachNotslot-panel: overlap onto the panel (mm)
screwNoplate/bracket/tslot-mount: the screw the holes are for (ply sizes them; omit or custom = use holeDiameter)
shapeNospacer/washer: round or hex; tslot-plate: L, T, X, straight or gusset
widthNoplate/bracket: width (mm)
gussetNotslot-bracket: side gussets
heightNospacer: height; washer: thickness (mm)
holesANobracket: holes in the base leg
holesBNobracket: holes in the upright leg
lengthNotslot-cover: length (mm)
answersNoThe advisor's earlier questions and the customer's answers
patternNotray: design pressed into the outside walls
profileNoT-slot parts: the extrusion (8020-10 = 80/20 10 series 1 in, 8020-15 = 15 series 1.5 in, m20 = 20 mm / 2020)
dripTrayNotray: a drip tray it sits in (use with drain holes)
fileNameNoThe file's name, as in price_file (it can tell the advisor what the part is)
gridRowsNoplate, grid: hole rows
templateNoplate = flat plate with holes; bracket = L-bracket; spacer = spacer/standoff; washer; box = box with optional lift-off lid, sized by the inside; tray = open tray / bin / organizer sized by the OUTSIDE (width, depth, height), optional compartments; for T-slot aluminum extrusion (pick its profile): tslot-bracket = corner bracket, tslot-plate = joining plate, tslot-mount = mounting plate (bolts into a slot + the customer's own holes), tslot-cap = end cap / foot, tslot-cover = slot cover, tslot-panel = panel clip, tslot-cable = cable clip
holeInsetNoplate, corner holes: distance from each edge to the hole center (mm)
holeStyleNowith screw: plain hole, screw threads into the plastic, counterbored, countersunk (flat head), hex nut pocket, or heat-set insert
plugDepthNotslot-cap: plug length into the slots (mm)
slotHolesNotslot-mount: bolts into the slot
thicknessNoplate/bracket: thickness (mm)
centerHoleNotslot-cap: hole to reach the end bolt
dripHeightNotray: drip tray outside height (mm)
extraHolesNoplate: holes at exact spots, x/y = hole center in mm from the plate's center
innerDepthNobox: inside depth (mm)
innerWidthNobox: inside width (mm)
slotOffsetNotslot-mount: slot line from the plate's center, across (mm)
gridColumnsNoplate, grid: hole columns
holePatternNoplate: hole layout
innerHeightNobox: inside height (mm)
innerRadiusNobracket: inside corner radius (mm)
cornerRadiusNoplate: outside corner radius, 0 = square; box: inside corner radius (mm)
holeDiameterNoplate: diameter of the pattern holes; bracket: hole diameter (0 = no holes) (mm)
cableDiameterNotslot-cable: cable bundle diameter (mm)
compartmentsXNotray: compartments across (1 = none)
compartmentsYNotray: compartments front to back (1 = none)
drainDiameterNotray: drain hole size (mm)
innerDiameterNospacer/washer: hole diameter, 0 = solid spacer (mm)
outerDiameterNospacer/washer: outside diameter (hex: across the flats) (mm)
panelThicknessNotslot-panel: panel thickness (mm)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / board / description
      Previous value: -"plate/tslot-mount: a circuit board whose mounting holes ply places from the maker's drawing (rpi5 = Raspberry Pi 5, rpi4b = Raspberry Pi 4 Model B, rpi3bplus = Raspberry Pi 3 Model B+, rpizero2w = Raspberry Pi Zero 2 W / Zero W, pico = Raspberry Pi Pico, rpicam = Raspberry Pi Camera Module 3 / v2, uno = Arduino Uno (R3 / R4), mega = Arduino Mega 2560, jetson-orin-nano = NVIDIA Jetson Orin Nano Developer Kit, esp32-devkitc = Espressif ESP32-DevKitC V4, esp32-s3-devkitc = Espressif ESP32-S3-DevKitC-1 (v1.1), xiao-esp32s3 = Seeed Studio XIAO ESP32-S3, esp32-cam = AI-Thinker ESP32-CAM, ipi-smarc-rb5 = ADLINK I-Pi SMARC RB5 (I-Pi SMARC Plus carrier), esp32-devkit-v1-30 = ESP32 DevKit V1, 30 pins (generic), esp32-38-wide = ESP32 38-pin board, wide with 4 holes (generic), esp32-38-narrow = ESP32 38-pin board, narrow (fits most copies)); also give width/depth (hole pattern + 12 mm), screw and, on tslot-mount, standoffHeight"New value: +"plate/tslot-mount: a circuit board whose mounting holes ply places from the maker's drawing (rpi5 = Raspberry Pi 5, rpi4b = Raspberry Pi 4 Model B, rpi3bplus = Raspberry Pi 3 Model B+, rpizero2w = Raspberry Pi Zero 2 W / Zero W, pico = Raspberry Pi Pico, rpicam = Raspberry Pi Camera Module 3 / v2, uno = Arduino Uno (R3 / R4), mega = Arduino Mega 2560, jetson-orin-nano = NVIDIA Jetson Orin Nano Developer Kit, esp32-devkitc = Espressif ESP32-DevKitC V4, esp32-s3-devkitc = Espressif ESP32-S3-DevKitC-1 (v1.1), xiao-esp32s3 = Seeed Studio XIAO ESP32-S3, heltec-v4 = Heltec WiFi LoRa 32 V4, heltec-v3 = Heltec WiFi LoRa 32 V3, esp32-cam = AI-Thinker ESP32-CAM, ipi-smarc-rb5 = ADLINK I-Pi SMARC RB5 (I-Pi SMARC Plus carrier), esp32-devkit-v1-30 = ESP32 DevKit V1, 30 pins (generic), esp32-38-wide = ESP32 38-pin board, wide with 4 holes (generic), esp32-38-narrow = ESP32 38-pin board, narrow (fits most copies)); also give width/depth (hole pattern + 12 mm), screw and, on tslot-mount, standoffHeight"
    • changedInput schema / properties / board / enum
      Previous value: -[
      -  "none",
      -  "rpi5",
      -  "rpi4b",
      -  "rpi3bplus",
      -  "rpizero2w",
      -  "pico",
      -  "rpicam",
      -  "uno",
      -  "mega",
      -  "jetson-orin-nano",
      -  "esp32-devkitc",
      -  "esp32-s3-devkitc",
      -  "xiao-esp32s3",
      -  "esp32-cam",
      -  "ipi-smarc-rb5",
      -  "esp32-devkit-v1-30",
      -  "esp32-38-wide",
      -  "esp32-38-narrow"
      -]New value: +[
      +  "none",
      +  "rpi5",
      +  "rpi4b",
      +  "rpi3bplus",
      +  "rpizero2w",
      +  "pico",
      +  "rpicam",
      +  "uno",
      +  "mega",
      +  "jetson-orin-nano",
      +  "esp32-devkitc",
      +  "esp32-s3-devkitc",
      +  "xiao-esp32s3",
      +  "heltec-v4",
      +  "heltec-v3",
      +  "esp32-cam",
      +  "ipi-smarc-rb5",
      +  "esp32-devkit-v1-30",
      +  "esp32-38-wide",
      +  "esp32-38-narrow"
      +]
    • changedInput schema / properties / screw / enum
      Previous value: -[
      -  "custom",
      -  "M2",
      -  "M2.5",
      -  "M3",
      -  "M4",
      -  "M5",
      -  "M6",
      -  "M8",
      -  "M10",
      -  "M12",
      -  "#2",
      -  "#4",
      -  "#6",
      -  "#8",
      -  "#10",
      -  "1/4",
      -  "5/16",
      -  "3/8",
      -  "1/2"
      -]New value: +[
      +  "custom",
      +  "M1.6",
      +  "M2",
      +  "M2.5",
      +  "M3",
      +  "M4",
      +  "M5",
      +  "M6",
      +  "M8",
      +  "M10",
      +  "M12",
      +  "#2",
      +  "#4",
      +  "#6",
      +  "#8",
      +  "#10",
      +  "1/4",
      +  "5/16",
      +  "3/8",
      +  "1/2"
      +]
  2. Changed5 schema fields changed
    • addedInput schema / properties / drain
      Added value: +{
      +  "description": "tray: drain holes through each compartment's floor",
      +  "enum": [
      +    "none",
      +    "holes"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / drainDiameter
      Added value: +{
      +  "description": "tray: drain hole size (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / dripHeight
      Added value: +{
      +  "description": "tray: drip tray outside height (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / dripTray
      Added value: +{
      +  "description": "tray: a drip tray it sits in (use with drain holes)",
      +  "enum": [
      +    "none",
      +    "yes"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / pattern
      Added value: +{
      +  "description": "tray: design pressed into the outside walls",
      +  "enum": [
      +    "none",
      +    "fluted",
      +    "hex",
      +    "diamond"
      +  ],
      +  "type": "string"
      +}
  3. Changed3 schema fields changed
    • changedInput schema / properties / board / description
      Previous value: -"plate/tslot-mount: a circuit board whose mounting holes ply places from the maker's drawing (rpi5 = Raspberry Pi 5, rpi4b = Raspberry Pi 4 Model B, rpi3bplus = Raspberry Pi 3 Model B+, rpizero2w = Raspberry Pi Zero 2 W / Zero W, pico = Raspberry Pi Pico, rpicam = Raspberry Pi Camera Module 3 / v2, uno = Arduino Uno (R3 / R4), mega = Arduino Mega 2560); also give width/depth (hole pattern + 12 mm), screw and, on tslot-mount, standoffHeight"New value: +"plate/tslot-mount: a circuit board whose mounting holes ply places from the maker's drawing (rpi5 = Raspberry Pi 5, rpi4b = Raspberry Pi 4 Model B, rpi3bplus = Raspberry Pi 3 Model B+, rpizero2w = Raspberry Pi Zero 2 W / Zero W, pico = Raspberry Pi Pico, rpicam = Raspberry Pi Camera Module 3 / v2, uno = Arduino Uno (R3 / R4), mega = Arduino Mega 2560, jetson-orin-nano = NVIDIA Jetson Orin Nano Developer Kit, esp32-devkitc = Espressif ESP32-DevKitC V4, esp32-s3-devkitc = Espressif ESP32-S3-DevKitC-1 (v1.1), xiao-esp32s3 = Seeed Studio XIAO ESP32-S3, esp32-cam = AI-Thinker ESP32-CAM, ipi-smarc-rb5 = ADLINK I-Pi SMARC RB5 (I-Pi SMARC Plus carrier), esp32-devkit-v1-30 = ESP32 DevKit V1, 30 pins (generic), esp32-38-wide = ESP32 38-pin board, wide with 4 holes (generic), esp32-38-narrow = ESP32 38-pin board, narrow (fits most copies)); also give width/depth (hole pattern + 12 mm), screw and, on tslot-mount, standoffHeight"
    • changedInput schema / properties / board / enum
      Previous value: -[
      -  "none",
      -  "rpi5",
      -  "rpi4b",
      -  "rpi3bplus",
      -  "rpizero2w",
      -  "pico",
      -  "rpicam",
      -  "uno",
      -  "mega"
      -]New value: +[
      +  "none",
      +  "rpi5",
      +  "rpi4b",
      +  "rpi3bplus",
      +  "rpizero2w",
      +  "pico",
      +  "rpicam",
      +  "uno",
      +  "mega",
      +  "jetson-orin-nano",
      +  "esp32-devkitc",
      +  "esp32-s3-devkitc",
      +  "xiao-esp32s3",
      +  "esp32-cam",
      +  "ipi-smarc-rb5",
      +  "esp32-devkit-v1-30",
      +  "esp32-38-wide",
      +  "esp32-38-narrow"
      +]
    • changedInput schema / properties / template / enum
      Previous value: -[
      -  "plate",
      -  "bracket",
      -  "spacer",
      -  "washer",
      -  "box",
      -  "tray",
      -  "tslot-bracket",
      -  "tslot-plate",
      -  "tslot-mount",
      -  "tslot-cap",
      -  "tslot-cover",
      -  "tslot-panel",
      -  "tslot-cable"
      -]New value: +[
      +  "plate",
      +  "bracket",
      +  "spacer",
      +  "washer",
      +  "box",
      +  "tray",
      +  "enclosure",
      +  "tslot-bracket",
      +  "tslot-plate",
      +  "tslot-mount",
      +  "tslot-cap",
      +  "tslot-cover",
      +  "tslot-panel",
      +  "tslot-cable"
      +]
  4. Changed5 schema fields changed
    • addedInput schema / properties / compartmentsX
      Added value: +{
      +  "description": "tray: compartments across (1 = none)",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedInput schema / properties / compartmentsY
      Added value: +{
      +  "description": "tray: compartments front to back (1 = none)",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedInput schema / properties / floor
      Added value: +{
      +  "description": "tray: floor thickness (mm)",
      +  "type": "number"
      +}
    • changedInput schema / properties / template / description
      Previous value: -"plate = flat plate with holes; bracket = L-bracket; spacer = spacer/standoff; washer; box = box with optional lift-off lid; for T-slot aluminum extrusion (pick its profile): tslot-bracket = corner bracket, tslot-plate = joining plate, tslot-mount = mounting plate (bolts into a slot + the customer's own holes), tslot-cap = end cap / foot, tslot-cover = slot cover, tslot-panel = panel clip, tslot-cable = cable clip"New value: +"plate = flat plate with holes; bracket = L-bracket; spacer = spacer/standoff; washer; box = box with optional lift-off lid, sized by the inside; tray = open tray / bin / organizer sized by the OUTSIDE (width, depth, height), optional compartments; for T-slot aluminum extrusion (pick its profile): tslot-bracket = corner bracket, tslot-plate = joining plate, tslot-mount = mounting plate (bolts into a slot + the customer's own holes), tslot-cap = end cap / foot, tslot-cover = slot cover, tslot-panel = panel clip, tslot-cable = cable clip"
    • changedInput schema / properties / template / enum
      Previous value: -[
      -  "plate",
      -  "bracket",
      -  "spacer",
      -  "washer",
      -  "box",
      -  "tslot-bracket",
      -  "tslot-plate",
      -  "tslot-mount",
      -  "tslot-cap",
      -  "tslot-cover",
      -  "tslot-panel",
      -  "tslot-cable"
      -]New value: +[
      +  "plate",
      +  "bracket",
      +  "spacer",
      +  "washer",
      +  "box",
      +  "tray",
      +  "tslot-bracket",
      +  "tslot-plate",
      +  "tslot-mount",
      +  "tslot-cap",
      +  "tslot-cover",
      +  "tslot-panel",
      +  "tslot-cable"
      +]
  5. Changed3 schema fields changed
    • addedInput schema / properties / board
      Added value: +{
      +  "description": "plate/tslot-mount: a circuit board whose mounting holes ply places from the maker's drawing (rpi5 = Raspberry Pi 5, rpi4b = Raspberry Pi 4 Model B, rpi3bplus = Raspberry Pi 3 Model B+, rpizero2w = Raspberry Pi Zero 2 W / Zero W, pico = Raspberry Pi Pico, rpicam = Raspberry Pi Camera Module 3 / v2, uno = Arduino Uno (R3 / R4), mega = Arduino Mega 2560); also give width/depth (hole pattern + 12 mm), screw and, on tslot-mount, standoffHeight",
      +  "enum": [
      +    "none",
      +    "rpi5",
      +    "rpi4b",
      +    "rpi3bplus",
      +    "rpizero2w",
      +    "pico",
      +    "rpicam",
      +    "uno",
      +    "mega"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / holeStyle
      Added value: +{
      +  "description": "with screw: plain hole, screw threads into the plastic, counterbored, countersunk (flat head), hex nut pocket, or heat-set insert",
      +  "enum": [
      +    "clearance",
      +    "tap",
      +    "counterbore",
      +    "countersink",
      +    "nut",
      +    "insert"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / screw
      Added value: +{
      +  "description": "plate/bracket/tslot-mount: the screw the holes are for (ply sizes them; omit or custom = use holeDiameter)",
      +  "enum": [
      +    "custom",
      +    "M2",
      +    "M2.5",
      +    "M3",
      +    "M4",
      +    "M5",
      +    "M6",
      +    "M8",
      +    "M10",
      +    "M12",
      +    "#2",
      +    "#4",
      +    "#6",
      +    "#8",
      +    "#10",
      +    "1/4",
      +    "5/16",
      +    "3/8",
      +    "1/2"
      +  ],
      +  "type": "string"
      +}
  6. Changed19 schema fields changed
    • addedInput schema / properties / armA
      Added value: +{
      +  "description": "tslot-plate: holes along the first arm",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedInput schema / properties / armB
      Added value: +{
      +  "description": "tslot-plate: holes along the second arm",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedInput schema / properties / cableDiameter
      Added value: +{
      +  "description": "tslot-cable: cable bundle diameter (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / centerHole
      Added value: +{
      +  "description": "tslot-cap: hole to reach the end bolt",
      +  "enum": [
      +    "yes",
      +    "no"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / gusset
      Added value: +{
      +  "description": "tslot-bracket: side gussets",
      +  "enum": [
      +    "sides",
      +    "none"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / holes
      Added value: +{
      +  "description": "tslot-bracket: bolts per leg (1–4)",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedInput schema / properties / keys
      Added value: +{
      +  "description": "tslot-bracket/mount/panel: alignment keys that sit in the slot",
      +  "enum": [
      +    "yes",
      +    "no"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / length
      Added value: +{
      +  "description": "tslot-cover: length (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / panelThickness
      Added value: +{
      +  "description": "tslot-panel: panel thickness (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / plugDepth
      Added value: +{
      +  "description": "tslot-cap: plug length into the slots (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / profile
      Added value: +{
      +  "description": "T-slot parts: the extrusion (8020-10 = 80/20 10 series 1 in, 8020-15 = 15 series 1.5 in, m20 = 20 mm / 2020)",
      +  "enum": [
      +    "8020-10",
      +    "8020-15",
      +    "m20"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / reach
      Added value: +{
      +  "description": "tslot-panel: overlap onto the panel (mm)",
      +  "type": "number"
      +}
    • changedInput schema / properties / shape / description
      Previous value: -"spacer/washer shape"New value: +"spacer/washer: round or hex; tslot-plate: L, T, X, straight or gusset"
    • changedInput schema / properties / shape / enum
      Previous value: -[
      -  "round",
      -  "hex"
      -]New value: +[
      +  "round",
      +  "hex",
      +  "L",
      +  "T",
      +  "X",
      +  "straight",
      +  "gusset"
      +]
    • addedInput schema / properties / slotHoles
      Added value: +{
      +  "description": "tslot-mount: bolts into the slot",
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedInput schema / properties / slotOffset
      Added value: +{
      +  "description": "tslot-mount: slot line from the plate's center, across (mm)",
      +  "type": "number"
      +}
    • addedInput schema / properties / span
      Added value: +{
      +  "description": "tslot-bracket: one or two profiles wide",
      +  "enum": [
      +    "single",
      +    "double"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / template / description
      Previous value: -"plate = flat plate with holes; bracket = L-bracket; spacer = spacer/standoff; washer; box = box with optional lift-off lid"New value: +"plate = flat plate with holes; bracket = L-bracket; spacer = spacer/standoff; washer; box = box with optional lift-off lid; for T-slot aluminum extrusion (pick its profile): tslot-bracket = corner bracket, tslot-plate = joining plate, tslot-mount = mounting plate (bolts into a slot + the customer's own holes), tslot-cap = end cap / foot, tslot-cover = slot cover, tslot-panel = panel clip, tslot-cable = cable clip"
    • changedInput schema / properties / template / enum
      Previous value: -[
      -  "plate",
      -  "bracket",
      -  "spacer",
      -  "washer",
      -  "box"
      -]New value: +[
      +  "plate",
      +  "bracket",
      +  "spacer",
      +  "washer",
      +  "box",
      +  "tslot-bracket",
      +  "tslot-plate",
      +  "tslot-mount",
      +  "tslot-cap",
      +  "tslot-cover",
      +  "tslot-panel",
      +  "tslot-cable"
      +]
  7. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already cover the read-only, idempotent, non-destructive profile, but the description adds the multi-turn behavior an agent could not otherwise anticipate: the advisor "may ask up to 2 questions" and then returns a recommendation. This directly explains the `answers` parameter's role. It doesn't discuss cost, limits on repeated calls, or error cases.

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 what the tool does, its observable behavior, and the input contract. The parenthetical branding and the quoted UI label are compact and aid identification rather than padding.

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 55 parameters and no output schema, the description usefully enumerates the recommendation's contents (process, material, color, strength) and explains the two input shapes, which is enough to invoke correctly. It leaves the many template-specific parameters to the schema, which is reasonable at 100% coverage.

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 the baseline is 3; the description earns above that by clarifying the mutually exclusive input modes (`path` for a priced file vs `template` plus dimension parameters for an unsaved part), which is the single most consequential parameter decision here. It does not explain the `use` field or the `answers` contract in any further depth.

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?

States a specific verb and resource ("Run ply's material advisor") and names the concrete output (process, material, color and strength), plus the public-facing name "Help me choose" for grounding. It doesn't explicitly contrast with siblings like list_materials or make_part, so it stops short of 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 Guidelines4/5

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

Explicitly gives the two entry paths: an existing file's ply `path` or a `template` plus sizes for a built part. That is real when-to-use routing for the 55-param schema. It does not state exclusions or name a competing tool to use instead, so it misses the top band.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources