Skip to main content
Glama
Sign In

STEADYWRK Agentic Readiness Probe, Store Guard and Dispatch

by app.steadywrk
OverviewDiscussionsAdmin

Estimate dispatch cost

dispatch.estimate
Read-onlyIdempotent

Public modeled field-service price estimate with cited BLS wage benchmarks. Returns customer hourly rates, line items, ranges and a total alongside geographic scope and source provenance. Model estimates are not observed transaction prices or binding quotes. Use dispatch.quote with an accepted credential to request a quote. No API key required.

Input Schema

NameRequiredDescriptionDefault
tradeYesTrade code: hvac, plumbing, electrical, general_maintenance, roofing, painting, carpentry or locksmith (see dispatch.index).
urgencyNoroutine
locationYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / trade / description
      Previous value: -"Trade code (plumbing, electrical, HVAC, etc.)"New value: +"Trade code: hvac, plumbing, electrical, general_maintenance, roofing, painting, carpentry or locksmith (see dispatch.index)."
  2. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "basis": {
-        "const": "modeled_customer_pricing",
-        "type": "string"
-      },
-      "billed_estimate": {
-        "additionalProperties": false,
-        "description": "Modeled customer hourly rates, billable hours, labor and trip line items, total and range. Not a binding quote.",
-        "properties": {
-          "billed_hourly_rate_cents": {
-            "type": "integer"
-          },
-          "billed_hourly_rate_routine_cents": {
-            "type": "integer"
-          },
-          "currency": {
-            "const": "USD",
-            "type": "string"
-          },
-          "labor_subtotal_cents": {
-            "type": "integer"
-          },
-          "minimum_billable_hours": {
-            "type": "number"
-          },
-          "range_high_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "range_low_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_cents": {
-            "type": "integer"
-          },
-          "total_usd": {
-            "type": "number"
-          },
-          "trip_fee_cents": {
-            "type": "integer"
-          },
-          "urgency": {
-            "enum": [
-              "emergency",
-              "urgent",
-              "routine",
-              "scheduled"
-            ],
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "disclosure": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "estimated": {
-        "const": true,
-        "type": "boolean"
-      },
-      "estimated_cost_cents": {
-        "description": "Alias of billed_estimate.total_cents.",
-        "type": "integer"
-      },
-      "location": {
-        "additionalProperties": false,
-        "properties": {
-          "city": {
-            "type": "string"
-          },
-          "state": {
-            "type": "string"
-          },
-          "zip": {
-            "type": "string"
-          }
-        },
-        "type": [
-          "object",
-          "null"
-        ]
-      },
-      "location_resolution": {
-        "additionalProperties": false,
-        "properties": {
-          "covered_metros": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "location_sensitive": {
-            "type": "boolean"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "requested": {
-            "additionalProperties": false,
-            "properties": {
-              "city": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "state": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "zip": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "resolved_metro": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "resolved_metro_label": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "scope": {
-            "enum": [
-              "metro_cited",
-              "national_baseline",
-              "mena_coverage_beta"
-            ],
-            "type": "string"
-          },
-          "zip_used": {
-            "const": false,
-            "type": "boolean"
-          }
-        },
-        "type": "object"
-      },
-      "measurement": {
-        "additionalProperties": false,
-        "properties": {
-          "billed_estimate": {
-            "const": "estimated",
-            "type": "string"
-          },
-          "explanation": {
-            "type": "string"
-          },
-          "wage_basis": {
-            "const": "estimated",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "rate_card": {
-        "additionalProperties": false,
-        "properties": {
-          "median_dollars": {
-            "type": "number"
-          },
-          "p25_dollars": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "p75_dollars": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "rate_model_version": {
-        "type": "string"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "trade": {
-        "type": "string"
-      },
-      "urgency": {
-        "enum": [
-          "emergency",
-          "urgent",
-          "routine",
-          "scheduled"
-        ],
-        "type": "string"
-      },
-      "wage_basis": {
-        "additionalProperties": false,
-        "description": "The cited hourly WAGE input — NOT the price.",
-        "properties": {
-          "annual_median_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "bls_occ_code": {
-            "type": "string"
-          },
-          "dataset": {
-            "type": "string"
-          },
-          "kind": {
-            "const": "hourly_wage",
-            "type": "string"
-          },
-          "median_cents": {
-            "type": "integer"
-          },
-          "note": {
-            "type": "string"
-          },
-          "p25_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "p75_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "period": {
-            "type": "string"
-          },
-          "release": {
-            "type": "string"
-          },
-          "sample_size": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "scope": {
-            "enum": [
-              "metro_cited",
-              "national_baseline",
-              "mena_coverage_beta"
-            ],
-            "type": "string"
-          },
-          "scope_label": {
-            "type": "string"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_url": {
-            "type": "string"
-          },
-          "trade_label": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "basis",
-      "rate_model_version",
-      "trade",
-      "urgency",
-      "location_resolution",
-      "wage_basis",
-      "billed_estimate",
-      "estimated_cost_cents",
-      "rate_card",
-      "disclosure"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "Trade was missing or not recognized. No number is fabricated.",
-    "properties": {
-      "error": {
-        "enum": [
-          "unknown_trade",
-          "trade_required"
-        ],
-        "type": "string"
-      },
-      "estimated": {
-        "const": false,
-        "type": "boolean"
-      },
-      "known_trades": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "trade": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "valid_trades": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "error",
-      "trade",
-      "valid_trades",
-      "known_trades"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "A provided location.state is not a US state or DC code, or a MENA coverage country code. No number is fabricated; an omitted state is priced at the national baseline.",
-    "properties": {
-      "error": {
-        "const": "invalid_state",
-        "type": "string"
-      },
-      "estimated": {
-        "const": false,
-        "type": "boolean"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "state": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "valid_country_codes": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "valid_states": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "error",
-      "state",
-      "valid_states",
-      "valid_country_codes"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "const": "modeled_customer_pricing",
+        "type": "string"
+      },
+      "billed_estimate": {
+        "additionalProperties": false,
+        "description": "Modeled customer hourly rates, billable hours, labor and trip line items, total and range. Not a binding quote.",
+        "properties": {
+          "billed_hourly_rate_cents": {
+            "type": "integer"
+          },
+          "billed_hourly_rate_routine_cents": {
+            "type": "integer"
+          },
+          "currency": {
+            "const": "USD",
+            "type": "string"
+          },
+          "labor_subtotal_cents": {
+            "type": "integer"
+          },
+          "minimum_billable_hours": {
+            "type": "number"
+          },
+          "range_high_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "range_low_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_cents": {
+            "type": "integer"
+          },
+          "total_usd": {
+            "type": "number"
+          },
+          "trip_fee_cents": {
+            "type": "integer"
+          },
+          "urgency": {
+            "enum": [
+              "emergency",
+              "urgent",
+              "routine",
+              "scheduled"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "binding": {
+        "const": false,
+        "type": "boolean"
+      },
+      "disclosure": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "estimate_basis": {
+        "const": "national_median_reference",
+        "description": "Present when no covered metro matched (for example, no city supplied): the figures are a non-binding national reference.",
+        "type": "string"
+      },
+      "estimated": {
+        "const": true,
+        "type": "boolean"
+      },
+      "estimated_cost_cents": {
+        "description": "Alias of billed_estimate.total_cents.",
+        "type": "integer"
+      },
+      "location": {
+        "additionalProperties": false,
+        "properties": {
+          "city": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          },
+          "zip": {
+            "type": "string"
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "location_resolution": {
+        "additionalProperties": false,
+        "properties": {
+          "covered_metros": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "location_sensitive": {
+            "type": "boolean"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "city": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "state": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "zip": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "resolved_metro": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "resolved_metro_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "scope": {
+            "enum": [
+              "metro_cited",
+              "national_baseline",
+              "mena_coverage_beta"
+            ],
+            "type": "string"
+          },
+          "zip_used": {
+            "const": false,
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "measurement": {
+        "additionalProperties": false,
+        "properties": {
+          "billed_estimate": {
+            "const": "estimated",
+            "type": "string"
+          },
+          "explanation": {
+            "type": "string"
+          },
+          "wage_basis": {
+            "const": "estimated",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "note": {
+        "type": "string"
+      },
+      "rate_card": {
+        "additionalProperties": false,
+        "properties": {
+          "median_dollars": {
+            "type": "number"
+          },
+          "p25_dollars": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "p75_dollars": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "rate_model_version": {
+        "type": "string"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "trade": {
+        "type": "string"
+      },
+      "urgency": {
+        "enum": [
+          "emergency",
+          "urgent",
+          "routine",
+          "scheduled"
+        ],
+        "type": "string"
+      },
+      "wage_basis": {
+        "additionalProperties": false,
+        "description": "The cited hourly WAGE input — NOT the price.",
+        "properties": {
+          "annual_median_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "bls_occ_code": {
+            "type": "string"
+          },
+          "dataset": {
+            "type": "string"
+          },
+          "kind": {
+            "const": "hourly_wage",
+            "type": "string"
+          },
+          "median_cents": {
+            "type": "integer"
+          },
+          "note": {
+            "type": "string"
+          },
+          "p25_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "p75_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "period": {
+            "type": "string"
+          },
+          "release": {
+            "type": "string"
+          },
+          "sample_size": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "scope": {
+            "enum": [
+              "metro_cited",
+              "national_baseline",
+              "mena_coverage_beta"
+            ],
+            "type": "string"
+          },
+          "scope_label": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_url": {
+            "type": "string"
+          },
+          "trade_label": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "basis",
+      "rate_model_version",
+      "trade",
+      "urgency",
+      "location_resolution",
+      "wage_basis",
+      "billed_estimate",
+      "estimated_cost_cents",
+      "rate_card",
+      "disclosure"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "Trade was missing or not recognized. No number is fabricated.",
+    "properties": {
+      "error": {
+        "enum": [
+          "unknown_trade",
+          "trade_required"
+        ],
+        "type": "string"
+      },
+      "estimated": {
+        "const": false,
+        "type": "boolean"
+      },
+      "known_trades": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "trade": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "valid_trades": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "error",
+      "trade",
+      "valid_trades",
+      "known_trades"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "A provided location.state is not a US state or DC code, or a MENA coverage country code. No number is fabricated; an omitted state is priced at the national baseline.",
+    "properties": {
+      "error": {
+        "const": "invalid_state",
+        "type": "string"
+      },
+      "estimated": {
+        "const": false,
+        "type": "boolean"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "state": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "valid_country_codes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "valid_states": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "error",
+      "state",
+      "valid_states",
+      "valid_country_codes"
+    ],
+    "type": "object"
+  }
+]
  3. Changed2 schema fields changed
    • changedOutput schema / description
      Previous value: -"Modeled customer pricing with wage benchmark provenance, or an unknown/missing trade error — never a fabricated number."New value: +"Modeled customer pricing with wage benchmark provenance, or an unknown/missing trade or invalid state error — never a fabricated number."
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "basis": {
-        "const": "modeled_customer_pricing",
-        "type": "string"
-      },
-      "billed_estimate": {
-        "additionalProperties": false,
-        "description": "Modeled customer hourly rates, billable hours, labor and trip line items, total and range. Not a binding quote.",
-        "properties": {
-          "billed_hourly_rate_cents": {
-            "type": "integer"
-          },
-          "billed_hourly_rate_routine_cents": {
-            "type": "integer"
-          },
-          "currency": {
-            "const": "USD",
-            "type": "string"
-          },
-          "labor_subtotal_cents": {
-            "type": "integer"
-          },
-          "minimum_billable_hours": {
-            "type": "number"
-          },
-          "range_high_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "range_low_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_cents": {
-            "type": "integer"
-          },
-          "total_usd": {
-            "type": "number"
-          },
-          "trip_fee_cents": {
-            "type": "integer"
-          },
-          "urgency": {
-            "enum": [
-              "emergency",
-              "urgent",
-              "routine",
-              "scheduled"
-            ],
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "disclosure": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "estimated": {
-        "const": true,
-        "type": "boolean"
-      },
-      "estimated_cost_cents": {
-        "description": "Alias of billed_estimate.total_cents.",
-        "type": "integer"
-      },
-      "location": {
-        "additionalProperties": false,
-        "properties": {
-          "city": {
-            "type": "string"
-          },
-          "state": {
-            "type": "string"
-          },
-          "zip": {
-            "type": "string"
-          }
-        },
-        "type": [
-          "object",
-          "null"
-        ]
-      },
-      "location_resolution": {
-        "additionalProperties": false,
-        "properties": {
-          "covered_metros": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "location_sensitive": {
-            "type": "boolean"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "requested": {
-            "additionalProperties": false,
-            "properties": {
-              "city": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "state": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "zip": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "resolved_metro": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "resolved_metro_label": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "scope": {
-            "enum": [
-              "metro_cited",
-              "national_baseline",
-              "mena_coverage_beta"
-            ],
-            "type": "string"
-          },
-          "zip_used": {
-            "const": false,
-            "type": "boolean"
-          }
-        },
-        "type": "object"
-      },
-      "measurement": {
-        "additionalProperties": false,
-        "properties": {
-          "billed_estimate": {
-            "const": "estimated",
-            "type": "string"
-          },
-          "explanation": {
-            "type": "string"
-          },
-          "wage_basis": {
-            "const": "estimated",
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "rate_card": {
-        "additionalProperties": false,
-        "properties": {
-          "median_dollars": {
-            "type": "number"
-          },
-          "p25_dollars": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "p75_dollars": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "rate_model_version": {
-        "type": "string"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "trade": {
-        "type": "string"
-      },
-      "urgency": {
-        "enum": [
-          "emergency",
-          "urgent",
-          "routine",
-          "scheduled"
-        ],
-        "type": "string"
-      },
-      "wage_basis": {
-        "additionalProperties": false,
-        "description": "The cited hourly WAGE input — NOT the price.",
-        "properties": {
-          "annual_median_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "bls_occ_code": {
-            "type": "string"
-          },
-          "dataset": {
-            "type": "string"
-          },
-          "kind": {
-            "const": "hourly_wage",
-            "type": "string"
-          },
-          "median_cents": {
-            "type": "integer"
-          },
-          "note": {
-            "type": "string"
-          },
-          "p25_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "p75_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "period": {
-            "type": "string"
-          },
-          "release": {
-            "type": "string"
-          },
-          "sample_size": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "scope": {
-            "enum": [
-              "metro_cited",
-              "national_baseline",
-              "mena_coverage_beta"
-            ],
-            "type": "string"
-          },
-          "scope_label": {
-            "type": "string"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_url": {
-            "type": "string"
-          },
-          "trade_label": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "basis",
-      "rate_model_version",
-      "trade",
-      "urgency",
-      "location_resolution",
-      "wage_basis",
-      "billed_estimate",
-      "estimated_cost_cents",
-      "rate_card",
-      "disclosure"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "Trade was missing or not recognized. No number is fabricated.",
-    "properties": {
-      "error": {
-        "enum": [
-          "unknown_trade",
-          "trade_required"
-        ],
-        "type": "string"
-      },
-      "estimated": {
-        "const": false,
-        "type": "boolean"
-      },
-      "known_trades": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "trade": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "valid_trades": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "error",
-      "trade",
-      "valid_trades",
-      "known_trades"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "const": "modeled_customer_pricing",
+        "type": "string"
+      },
+      "billed_estimate": {
+        "additionalProperties": false,
+        "description": "Modeled customer hourly rates, billable hours, labor and trip line items, total and range. Not a binding quote.",
+        "properties": {
+          "billed_hourly_rate_cents": {
+            "type": "integer"
+          },
+          "billed_hourly_rate_routine_cents": {
+            "type": "integer"
+          },
+          "currency": {
+            "const": "USD",
+            "type": "string"
+          },
+          "labor_subtotal_cents": {
+            "type": "integer"
+          },
+          "minimum_billable_hours": {
+            "type": "number"
+          },
+          "range_high_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "range_low_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_cents": {
+            "type": "integer"
+          },
+          "total_usd": {
+            "type": "number"
+          },
+          "trip_fee_cents": {
+            "type": "integer"
+          },
+          "urgency": {
+            "enum": [
+              "emergency",
+              "urgent",
+              "routine",
+              "scheduled"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "disclosure": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "estimated": {
+        "const": true,
+        "type": "boolean"
+      },
+      "estimated_cost_cents": {
+        "description": "Alias of billed_estimate.total_cents.",
+        "type": "integer"
+      },
+      "location": {
+        "additionalProperties": false,
+        "properties": {
+          "city": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          },
+          "zip": {
+            "type": "string"
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "location_resolution": {
+        "additionalProperties": false,
+        "properties": {
+          "covered_metros": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "location_sensitive": {
+            "type": "boolean"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "city": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "state": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "zip": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "resolved_metro": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "resolved_metro_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "scope": {
+            "enum": [
+              "metro_cited",
+              "national_baseline",
+              "mena_coverage_beta"
+            ],
+            "type": "string"
+          },
+          "zip_used": {
+            "const": false,
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "measurement": {
+        "additionalProperties": false,
+        "properties": {
+          "billed_estimate": {
+            "const": "estimated",
+            "type": "string"
+          },
+          "explanation": {
+            "type": "string"
+          },
+          "wage_basis": {
+            "const": "estimated",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "rate_card": {
+        "additionalProperties": false,
+        "properties": {
+          "median_dollars": {
+            "type": "number"
+          },
+          "p25_dollars": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "p75_dollars": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "rate_model_version": {
+        "type": "string"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "trade": {
+        "type": "string"
+      },
+      "urgency": {
+        "enum": [
+          "emergency",
+          "urgent",
+          "routine",
+          "scheduled"
+        ],
+        "type": "string"
+      },
+      "wage_basis": {
+        "additionalProperties": false,
+        "description": "The cited hourly WAGE input — NOT the price.",
+        "properties": {
+          "annual_median_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "bls_occ_code": {
+            "type": "string"
+          },
+          "dataset": {
+            "type": "string"
+          },
+          "kind": {
+            "const": "hourly_wage",
+            "type": "string"
+          },
+          "median_cents": {
+            "type": "integer"
+          },
+          "note": {
+            "type": "string"
+          },
+          "p25_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "p75_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "period": {
+            "type": "string"
+          },
+          "release": {
+            "type": "string"
+          },
+          "sample_size": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "scope": {
+            "enum": [
+              "metro_cited",
+              "national_baseline",
+              "mena_coverage_beta"
+            ],
+            "type": "string"
+          },
+          "scope_label": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_url": {
+            "type": "string"
+          },
+          "trade_label": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "basis",
+      "rate_model_version",
+      "trade",
+      "urgency",
+      "location_resolution",
+      "wage_basis",
+      "billed_estimate",
+      "estimated_cost_cents",
+      "rate_card",
+      "disclosure"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "Trade was missing or not recognized. No number is fabricated.",
+    "properties": {
+      "error": {
+        "enum": [
+          "unknown_trade",
+          "trade_required"
+        ],
+        "type": "string"
+      },
+      "estimated": {
+        "const": false,
+        "type": "boolean"
+      },
+      "known_trades": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "trade": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "valid_trades": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "error",
+      "trade",
+      "valid_trades",
+      "known_trades"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "A provided location.state is not a US state or DC code, or a MENA coverage country code. No number is fabricated; an omitted state is priced at the national baseline.",
+    "properties": {
+      "error": {
+        "const": "invalid_state",
+        "type": "string"
+      },
+      "estimated": {
+        "const": false,
+        "type": "boolean"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "state": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "valid_country_codes": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "valid_states": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "error",
+      "state",
+      "valid_states",
+      "valid_country_codes"
+    ],
+    "type": "object"
+  }
+]
  4. Changed2 schema fields changed
    • changedOutput schema / description
      Previous value: -"A full wage-to-billed-rate estimate, or an unknown/missing trade error — never a fabricated number."New value: +"Modeled customer pricing with wage benchmark provenance, or an unknown/missing trade error — never a fabricated number."
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "properties": {
-      "basis": {
-        "const": "wage_to_billed_rate_transform",
-        "type": "string"
-      },
-      "billed_estimate": {
-        "additionalProperties": true,
-        "description": "What a buyer pays — every component of the arithmetic, re-derivable via formula.",
-        "properties": {
-          "billed_hourly_rate_cents": {
-            "type": "integer"
-          },
-          "billed_hourly_rate_routine_cents": {
-            "type": "integer"
-          },
-          "currency": {
-            "const": "USD",
-            "type": "string"
-          },
-          "formula": {
-            "type": "string"
-          },
-          "labor_burden_multiplier": {
-            "type": "number"
-          },
-          "minimum_billable_hours": {
-            "type": "number"
-          },
-          "total_cents": {
-            "type": "integer"
-          },
-          "total_usd": {
-            "type": "number"
-          },
-          "trip_fee_cents": {
-            "type": "integer"
-          },
-          "urgency_multiplier": {
-            "type": "number"
-          }
-        },
-        "type": "object"
-      },
-      "disclosure": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "estimated": {
-        "const": true,
-        "type": "boolean"
-      },
-      "estimated_cost_cents": {
-        "description": "Alias of billed_estimate.total_cents.",
-        "type": "integer"
-      },
-      "location_resolution": {
-        "additionalProperties": true,
-        "properties": {
-          "location_sensitive": {
-            "type": "boolean"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "resolved_metro": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "resolved_metro_label": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "scope": {
-            "enum": [
-              "metro_cited",
-              "national_baseline",
-              "mena_coverage_beta"
-            ],
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "rate_card": {
-        "properties": {
-          "median_dollars": {
-            "type": "number"
-          },
-          "p25_dollars": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "p75_dollars": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "rate_model_version": {
-        "type": "string"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "trade": {
-        "type": "string"
-      },
-      "urgency": {
-        "enum": [
-          "emergency",
-          "urgent",
-          "routine",
-          "scheduled"
-        ],
-        "type": "string"
-      },
-      "wage_basis": {
-        "additionalProperties": true,
-        "description": "The cited hourly WAGE input — NOT the price.",
-        "properties": {
-          "bls_occ_code": {
-            "type": "string"
-          },
-          "kind": {
-            "const": "hourly_wage",
-            "type": "string"
-          },
-          "median_cents": {
-            "type": "integer"
-          },
-          "note": {
-            "type": "string"
-          },
-          "p25_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "p75_cents": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "scope_label": {
-            "type": "string"
-          },
-          "source_url": {
-            "type": "string"
-          },
-          "trade_label": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "basis",
-      "rate_model_version",
-      "trade",
-      "urgency",
-      "location_resolution",
-      "wage_basis",
-      "billed_estimate",
-      "estimated_cost_cents",
-      "rate_card",
-      "disclosure"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "Trade was missing or not recognized. No number is fabricated.",
-    "properties": {
-      "error": {
-        "enum": [
-          "unknown_trade",
-          "trade_required"
-        ],
-        "type": "string"
-      },
-      "estimated": {
-        "const": false,
-        "type": "boolean"
-      },
-      "known_trades": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "source": {
-        "const": "public_rate_card",
-        "type": "string"
-      },
-      "trade": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "valid_trades": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "estimated",
-      "source",
-      "error",
-      "trade",
-      "valid_trades",
-      "known_trades"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basis": {
+        "const": "modeled_customer_pricing",
+        "type": "string"
+      },
+      "billed_estimate": {
+        "additionalProperties": false,
+        "description": "Modeled customer hourly rates, billable hours, labor and trip line items, total and range. Not a binding quote.",
+        "properties": {
+          "billed_hourly_rate_cents": {
+            "type": "integer"
+          },
+          "billed_hourly_rate_routine_cents": {
+            "type": "integer"
+          },
+          "currency": {
+            "const": "USD",
+            "type": "string"
+          },
+          "labor_subtotal_cents": {
+            "type": "integer"
+          },
+          "minimum_billable_hours": {
+            "type": "number"
+          },
+          "range_high_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "range_low_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_cents": {
+            "type": "integer"
+          },
+          "total_usd": {
+            "type": "number"
+          },
+          "trip_fee_cents": {
+            "type": "integer"
+          },
+          "urgency": {
+            "enum": [
+              "emergency",
+              "urgent",
+              "routine",
+              "scheduled"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "disclosure": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "estimated": {
+        "const": true,
+        "type": "boolean"
+      },
+      "estimated_cost_cents": {
+        "description": "Alias of billed_estimate.total_cents.",
+        "type": "integer"
+      },
+      "location": {
+        "additionalProperties": false,
+        "properties": {
+          "city": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          },
+          "zip": {
+            "type": "string"
+          }
+        },
+        "type": [
+          "object",
+          "null"
+        ]
+      },
+      "location_resolution": {
+        "additionalProperties": false,
+        "properties": {
+          "covered_metros": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "location_sensitive": {
+            "type": "boolean"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "requested": {
+            "additionalProperties": false,
+            "properties": {
+              "city": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "state": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "zip": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "resolved_metro": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "resolved_metro_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "scope": {
+            "enum": [
+              "metro_cited",
+              "national_baseline",
+              "mena_coverage_beta"
+            ],
+            "type": "string"
+          },
+          "zip_used": {
+            "const": false,
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "measurement": {
+        "additionalProperties": false,
+        "properties": {
+          "billed_estimate": {
+            "const": "estimated",
+            "type": "string"
+          },
+          "explanation": {
+            "type": "string"
+          },
+          "wage_basis": {
+            "const": "estimated",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "rate_card": {
+        "additionalProperties": false,
+        "properties": {
+          "median_dollars": {
+            "type": "number"
+          },
+          "p25_dollars": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "p75_dollars": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "rate_model_version": {
+        "type": "string"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "trade": {
+        "type": "string"
+      },
+      "urgency": {
+        "enum": [
+          "emergency",
+          "urgent",
+          "routine",
+          "scheduled"
+        ],
+        "type": "string"
+      },
+      "wage_basis": {
+        "additionalProperties": false,
+        "description": "The cited hourly WAGE input — NOT the price.",
+        "properties": {
+          "annual_median_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "bls_occ_code": {
+            "type": "string"
+          },
+          "dataset": {
+            "type": "string"
+          },
+          "kind": {
+            "const": "hourly_wage",
+            "type": "string"
+          },
+          "median_cents": {
+            "type": "integer"
+          },
+          "note": {
+            "type": "string"
+          },
+          "p25_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "p75_cents": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "period": {
+            "type": "string"
+          },
+          "release": {
+            "type": "string"
+          },
+          "sample_size": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "scope": {
+            "enum": [
+              "metro_cited",
+              "national_baseline",
+              "mena_coverage_beta"
+            ],
+            "type": "string"
+          },
+          "scope_label": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_url": {
+            "type": "string"
+          },
+          "trade_label": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "basis",
+      "rate_model_version",
+      "trade",
+      "urgency",
+      "location_resolution",
+      "wage_basis",
+      "billed_estimate",
+      "estimated_cost_cents",
+      "rate_card",
+      "disclosure"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "Trade was missing or not recognized. No number is fabricated.",
+    "properties": {
+      "error": {
+        "enum": [
+          "unknown_trade",
+          "trade_required"
+        ],
+        "type": "string"
+      },
+      "estimated": {
+        "const": false,
+        "type": "boolean"
+      },
+      "known_trades": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "source": {
+        "const": "public_rate_card",
+        "type": "string"
+      },
+      "trade": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "valid_trades": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "estimated",
+      "source",
+      "error",
+      "trade",
+      "valid_trades",
+      "known_trades"
+    ],
+    "type": "object"
+  }
+]
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "description": "A full wage-to-billed-rate estimate, or an unknown/missing trade error — never a fabricated number.",
+  "oneOf": [
+    {
+      "properties": {
+        "basis": {
+          "const": "wage_to_billed_rate_transform",
+          "type": "string"
+        },
+        "billed_estimate": {
+          "additionalProperties": true,
+          "description": "What a buyer pays — every component of the arithmetic, re-derivable via formula.",
+          "properties": {
+            "billed_hourly_rate_cents": {
+              "type": "integer"
+            },
+            "billed_hourly_rate_routine_cents": {
+              "type": "integer"
+            },
+            "currency": {
+              "const": "USD",
+              "type": "string"
+            },
+            "formula": {
+              "type": "string"
+            },
+            "labor_burden_multiplier": {
+              "type": "number"
+            },
+            "minimum_billable_hours": {
+              "type": "number"
+            },
+            "total_cents": {
+              "type": "integer"
+            },
+            "total_usd": {
+              "type": "number"
+            },
+            "trip_fee_cents": {
+              "type": "integer"
+            },
+            "urgency_multiplier": {
+              "type": "number"
+            }
+          },
+          "type": "object"
+        },
+        "disclosure": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "estimated": {
+          "const": true,
+          "type": "boolean"
+        },
+        "estimated_cost_cents": {
+          "description": "Alias of billed_estimate.total_cents.",
+          "type": "integer"
+        },
+        "location_resolution": {
+          "additionalProperties": true,
+          "properties": {
+            "location_sensitive": {
+              "type": "boolean"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "resolved_metro": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "resolved_metro_label": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "scope": {
+              "enum": [
+                "metro_cited",
+                "national_baseline",
+                "mena_coverage_beta"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "rate_card": {
+          "properties": {
+            "median_dollars": {
+              "type": "number"
+            },
+            "p25_dollars": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "p75_dollars": {
+              "type": [
+                "number",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "rate_model_version": {
+          "type": "string"
+        },
+        "source": {
+          "const": "public_rate_card",
+          "type": "string"
+        },
+        "trade": {
+          "type": "string"
+        },
+        "urgency": {
+          "enum": [
+            "emergency",
+            "urgent",
+            "routine",
+            "scheduled"
+          ],
+          "type": "string"
+        },
+        "wage_basis": {
+          "additionalProperties": true,
+          "description": "The cited hourly WAGE input — NOT the price.",
+          "properties": {
+            "bls_occ_code": {
+              "type": "string"
+            },
+            "kind": {
+              "const": "hourly_wage",
+              "type": "string"
+            },
+            "median_cents": {
+              "type": "integer"
+            },
+            "note": {
+              "type": "string"
+            },
+            "p25_cents": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "p75_cents": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "scope_label": {
+              "type": "string"
+            },
+            "source_url": {
+              "type": "string"
+            },
+            "trade_label": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "required": [
+        "estimated",
+        "source",
+        "basis",
+        "rate_model_version",
+        "trade",
+        "urgency",
+        "location_resolution",
+        "wage_basis",
+        "billed_estimate",
+        "estimated_cost_cents",
+        "rate_card",
+        "disclosure"
+      ],
+      "type": "object"
+    },
+    {
+      "description": "Trade was missing or not recognized. No number is fabricated.",
+      "properties": {
+        "error": {
+          "enum": [
+            "unknown_trade",
+            "trade_required"
+          ],
+          "type": "string"
+        },
+        "estimated": {
+          "const": false,
+          "type": "boolean"
+        },
+        "known_trades": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "source": {
+          "const": "public_rate_card",
+          "type": "string"
+        },
+        "trade": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "valid_trades": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "estimated",
+        "source",
+        "error",
+        "trade",
+        "valid_trades",
+        "known_trades"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}
  6. Added

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, not open-world), but the description adds meaningful caveats beyond them: estimates are modeled, not observed transaction prices, and not binding quotes, plus the auth posture. It stops short of disclosing latency or rate-limit behavior, but the model-vs-quote limitation is exactly the context an agent needs.

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?

Five compact sentences, each carrying a distinct load: purpose, return contents, non-binding caveat, sibling routing, and auth. Front-loaded with the purpose; the only mild redundancy is listing return contents when an output schema already exists.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only estimator with an output schema and safety annotations, the description covers the critical unknowns: what is returned, that results are non-binding, and that no key is needed. The gap is parameter-level guidance (urgency meanings, location requirements) delegated to the sibling dispatch.index rather than restated here.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 33% (only 'trade' is documented; 'urgency' and the nested location fields are not), so the description would need to compensate. Instead it says nothing about the required location.state, acceptable urgency values/default, or trade codes, leaving undocumented parameters weaker than the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

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

States a specific verb and resource ('modeled field-service price estimate') and immediately differentiates itself from dispatch.quote by clarifying that estimates are not binding quotes. An agent can distinguish this read-only estimator from the quoting sibling without opening either schema.

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?

Explicitly routes the agent to the alternative ('Use dispatch.quote with an accepted credential to request a quote') and gives the condition that selects it (an accepted credential). It also states 'No API key required,' which tells the agent when this public estimator is callable.

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

All STEADYWRK Agentic Readiness Probe, Store Guard and Dispatch toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources