Skip to main content
Glama
Sign In

Rafid Intelligence Network

by io.github.iabdullahm
OverviewDiscussionsAdmin

shipping_cost_estimate

Read-onlyIdempotent

Estimate domestic or international shipping cost, chargeable weight, transit time and common shipping surcharges using shipment dimensions, weight, origin, destination and service level. Estimates are not guaranteed carrier quotes; duties and taxes are excluded. When: Use when an agent needs to estimate delivery cost for a physical shipment before purchasing, selling, importing, exporting or selecting a shipping option. Selection: primary; prefer for route and shipment cost estimation or chargeable-weight planning. Do not use for customs or tax determination or a guaranteed carrier quote. Input is a strict JSON object; see the schema. Price: $0.25 USD per call. A free preview is available through preview_capability before payment. Full execution is paid per call via x402; an unpaid MCP call returns payment instructions.

Input Schema

NameRequiredDescriptionDefault
originYes
currencyNoUSD
shipmentYes
destinationYes
serviceLevelNoauto
shippingModeNoauto

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "actualWeightKg": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "chargeableWeightKg": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "high",
+              "medium",
+              "low"
+            ],
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "level",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "costBreakdown": {
+        "additionalProperties": false,
+        "properties": {
+          "baseFreight": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "estimatedOtherFees": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "fuelSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "handling": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "oversizeSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "remoteAreaSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "baseFreight",
+          "fuelSurcharge",
+          "handling",
+          "remoteAreaSurcharge",
+          "oversizeSurcharge",
+          "estimatedOtherFees"
+        ],
+        "type": "object"
+      },
+      "dutiesAndTaxes": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedAmount": {
+            "type": "null"
+          },
+          "included": {
+            "const": false,
+            "type": "boolean"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "included",
+          "estimatedAmount",
+          "note"
+        ],
+        "type": "object"
+      },
+      "estimatedCost": {
+        "additionalProperties": false,
+        "properties": {
+          "currency": {
+            "type": "string"
+          },
+          "max": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "min": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "min",
+          "max",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "estimatedTransitDays": {
+        "additionalProperties": false,
+        "properties": {
+          "max": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "min": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "min",
+          "max"
+        ],
+        "type": "object"
+      },
+      "generatedAt": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+        "type": "string"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "estimatedCost": {
+              "additionalProperties": false,
+              "properties": {
+                "currency": {
+                  "type": "string"
+                },
+                "max": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "min": {
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "min",
+                "max",
+                "currency"
+              ],
+              "type": "object"
+            },
+            "estimatedTransitDays": {
+              "additionalProperties": false,
+              "properties": {
+                "max": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "min": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "type": "object"
+            },
+            "provider": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "rateSource": {
+              "enum": [
+                "live_carrier",
+                "internal_estimate",
+                "heuristic_estimate"
+              ],
+              "type": "string"
+            },
+            "serviceLevel": {
+              "enum": [
+                "economy",
+                "standard",
+                "express"
+              ],
+              "type": "string"
+            },
+            "shippingMode": {
+              "enum": [
+                "courier",
+                "air",
+                "sea",
+                "road",
+                "postal"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "shippingMode",
+            "serviceLevel",
+            "estimatedCost",
+            "estimatedTransitDays",
+            "rateSource",
+            "provider"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "provider": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rateSource": {
+        "enum": [
+          "live_carrier",
+          "internal_estimate",
+          "heuristic_estimate"
+        ],
+        "type": "string"
+      },
+      "recommendedEstimate": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "recommendedOptionReason": {
+        "anyOf": [
+          {
+            "enum": [
+              "lowest_estimated_cost",
+              "shortest_transit",
+              "balanced_cost_and_time"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "riskFlags": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "severity": {
+              "enum": [
+                "low",
+                "medium",
+                "high"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "severity",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "serviceLevel": {
+        "enum": [
+          "economy",
+          "standard",
+          "express"
+        ],
+        "type": "string"
+      },
+      "shippingMode": {
+        "enum": [
+          "courier",
+          "air",
+          "sea",
+          "road",
+          "postal"
+        ],
+        "type": "string"
+      },
+      "volumetricWeightKg": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "estimatedCost",
+      "recommendedEstimate",
+      "actualWeightKg",
+      "volumetricWeightKg",
+      "chargeableWeightKg",
+      "shippingMode",
+      "serviceLevel",
+      "estimatedTransitDays",
+      "costBreakdown",
+      "rateSource",
+      "provider",
+      "dutiesAndTaxes",
+      "confidence",
+      "assumptions",
+      "riskFlags",
+      "options",
+      "recommendedOptionReason",
+      "generatedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nextAction": {
+        "additionalProperties": false,
+        "properties": {
+          "instruction": {
+            "type": "string"
+          },
+          "target": {
+            "enum": [
+              "x402_endpoint",
+              "mcp_credits_endpoint",
+              "payment_endpoint",
+              "unavailable"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "pay_and_retry",
+              "authorize_and_use_mcp_credits",
+              "payment_unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "instruction"
+        ],
+        "type": "object"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "method": {
+            "const": "POST",
+            "type": "string"
+          },
+          "retrySameBody": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "endpoint",
+          "method",
+          "retrySameBody"
+        ],
+        "type": "object"
+      },
+      "paymentGuidance": {},
+      "preview": {
+        "additionalProperties": false,
+        "properties": {
+          "fullResultAvailable": {
+            "const": true,
+            "type": "boolean"
+          },
+          "inputAccepted": {
+            "const": true,
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "useCases": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "inputAccepted",
+          "fullResultAvailable",
+          "summary",
+          "useCases"
+        ],
+        "type": "object"
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "protocol": {
+            "enum": [
+              "x402",
+              "api_credits",
+              "subscription",
+              "l402",
+              "mpp",
+              "unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      "requestId": {
+        "type": "string"
+      },
+      "status": {
+        "const": "payment_required",
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "tool",
+      "requestId",
+      "price",
+      "preview",
+      "payment",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]
    • removedOutput schema / properties
      Removed value: -{
-  "actualWeightKg": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "assumptions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "chargeableWeightKg": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "confidence": {
-    "additionalProperties": false,
-    "properties": {
-      "level": {
-        "enum": [
-          "high",
-          "medium",
-          "low"
-        ],
-        "type": "string"
-      },
-      "reason": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "level",
-      "reason"
-    ],
-    "type": "object"
-  },
-  "costBreakdown": {
-    "additionalProperties": false,
-    "properties": {
-      "baseFreight": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "estimatedOtherFees": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "fuelSurcharge": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "handling": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "oversizeSurcharge": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "remoteAreaSurcharge": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "baseFreight",
-      "fuelSurcharge",
-      "handling",
-      "remoteAreaSurcharge",
-      "oversizeSurcharge",
-      "estimatedOtherFees"
-    ],
-    "type": "object"
-  },
-  "dutiesAndTaxes": {
-    "additionalProperties": false,
-    "properties": {
-      "estimatedAmount": {
-        "type": "null"
-      },
-      "included": {
-        "const": false,
-        "type": "boolean"
-      },
-      "note": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "included",
-      "estimatedAmount",
-      "note"
-    ],
-    "type": "object"
-  },
-  "estimatedCost": {
-    "additionalProperties": false,
-    "properties": {
-      "currency": {
-        "type": "string"
-      },
-      "max": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "min": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "min",
-      "max",
-      "currency"
-    ],
-    "type": "object"
-  },
-  "estimatedTransitDays": {
-    "additionalProperties": false,
-    "properties": {
-      "max": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "min": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "min",
-      "max"
-    ],
-    "type": "object"
-  },
-  "generatedAt": {
-    "format": "date-time",
-    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-    "type": "string"
-  },
-  "options": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "estimatedCost": {
-          "additionalProperties": false,
-          "properties": {
-            "currency": {
-              "type": "string"
-            },
-            "max": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "min": {
-              "minimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "min",
-            "max",
-            "currency"
-          ],
-          "type": "object"
-        },
-        "estimatedTransitDays": {
-          "additionalProperties": false,
-          "properties": {
-            "max": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "min": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "min",
-            "max"
-          ],
-          "type": "object"
-        },
-        "provider": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "rateSource": {
-          "enum": [
-            "live_carrier",
-            "internal_estimate",
-            "heuristic_estimate"
-          ],
-          "type": "string"
-        },
-        "serviceLevel": {
-          "enum": [
-            "economy",
-            "standard",
-            "express"
-          ],
-          "type": "string"
-        },
-        "shippingMode": {
-          "enum": [
-            "courier",
-            "air",
-            "sea",
-            "road",
-            "postal"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "shippingMode",
-        "serviceLevel",
-        "estimatedCost",
-        "estimatedTransitDays",
-        "rateSource",
-        "provider"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "provider": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "rateSource": {
-    "enum": [
-      "live_carrier",
-      "internal_estimate",
-      "heuristic_estimate"
-    ],
-    "type": "string"
-  },
-  "recommendedEstimate": {
-    "minimum": 0,
-    "type": "number"
-  },
-  "recommendedOptionReason": {
-    "anyOf": [
-      {
-        "enum": [
-          "lowest_estimated_cost",
-          "shortest_transit",
-          "balanced_cost_and_time"
-        ],
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "riskFlags": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "code": {
-          "type": "string"
-        },
-        "message": {
-          "type": "string"
-        },
-        "severity": {
-          "enum": [
-            "low",
-            "medium",
-            "high"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "code",
-        "severity",
-        "message"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "serviceLevel": {
-    "enum": [
-      "economy",
-      "standard",
-      "express"
-    ],
-    "type": "string"
-  },
-  "shippingMode": {
-    "enum": [
-      "courier",
-      "air",
-      "sea",
-      "road",
-      "postal"
-    ],
-    "type": "string"
-  },
-  "volumetricWeightKg": {
-    "minimum": 0,
-    "type": "number"
-  }
-}
    • removedOutput schema / required
      Removed value: -[
-  "estimatedCost",
-  "recommendedEstimate",
-  "actualWeightKg",
-  "volumetricWeightKg",
-  "chargeableWeightKg",
-  "shippingMode",
-  "serviceLevel",
-  "estimatedTransitDays",
-  "costBreakdown",
-  "rateSource",
-  "provider",
-  "dutiesAndTaxes",
-  "confidence",
-  "assumptions",
-  "riskFlags",
-  "options",
-  "recommendedOptionReason",
-  "generatedAt"
-]
  2. Changed4 schema fields changed
    • addedOutput schema / additionalProperties
      Added value: +false
    • removedOutput schema / anyOf
      Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "actualWeightKg": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "chargeableWeightKg": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "confidence": {
-        "additionalProperties": false,
-        "properties": {
-          "level": {
-            "enum": [
-              "high",
-              "medium",
-              "low"
-            ],
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "level",
-          "reason"
-        ],
-        "type": "object"
-      },
-      "costBreakdown": {
-        "additionalProperties": false,
-        "properties": {
-          "baseFreight": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "estimatedOtherFees": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "fuelSurcharge": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "handling": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "oversizeSurcharge": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "remoteAreaSurcharge": {
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "baseFreight",
-          "fuelSurcharge",
-          "handling",
-          "remoteAreaSurcharge",
-          "oversizeSurcharge",
-          "estimatedOtherFees"
-        ],
-        "type": "object"
-      },
-      "dutiesAndTaxes": {
-        "additionalProperties": false,
-        "properties": {
-          "estimatedAmount": {
-            "type": "null"
-          },
-          "included": {
-            "const": false,
-            "type": "boolean"
-          },
-          "note": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "included",
-          "estimatedAmount",
-          "note"
-        ],
-        "type": "object"
-      },
-      "estimatedCost": {
-        "additionalProperties": false,
-        "properties": {
-          "currency": {
-            "type": "string"
-          },
-          "max": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "min": {
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "min",
-          "max",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "estimatedTransitDays": {
-        "additionalProperties": false,
-        "properties": {
-          "max": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "min": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "min",
-          "max"
-        ],
-        "type": "object"
-      },
-      "generatedAt": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-        "type": "string"
-      },
-      "options": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "estimatedCost": {
-              "additionalProperties": false,
-              "properties": {
-                "currency": {
-                  "type": "string"
-                },
-                "max": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "min": {
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "min",
-                "max",
-                "currency"
-              ],
-              "type": "object"
-            },
-            "estimatedTransitDays": {
-              "additionalProperties": false,
-              "properties": {
-                "max": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "min": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "min",
-                "max"
-              ],
-              "type": "object"
-            },
-            "provider": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "rateSource": {
-              "enum": [
-                "live_carrier",
-                "internal_estimate",
-                "heuristic_estimate"
-              ],
-              "type": "string"
-            },
-            "serviceLevel": {
-              "enum": [
-                "economy",
-                "standard",
-                "express"
-              ],
-              "type": "string"
-            },
-            "shippingMode": {
-              "enum": [
-                "courier",
-                "air",
-                "sea",
-                "road",
-                "postal"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "shippingMode",
-            "serviceLevel",
-            "estimatedCost",
-            "estimatedTransitDays",
-            "rateSource",
-            "provider"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "provider": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "rateSource": {
-        "enum": [
-          "live_carrier",
-          "internal_estimate",
-          "heuristic_estimate"
-        ],
-        "type": "string"
-      },
-      "recommendedEstimate": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "recommendedOptionReason": {
-        "anyOf": [
-          {
-            "enum": [
-              "lowest_estimated_cost",
-              "shortest_transit",
-              "balanced_cost_and_time"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "riskFlags": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "severity": {
-              "enum": [
-                "low",
-                "medium",
-                "high"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "code",
-            "severity",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "serviceLevel": {
-        "enum": [
-          "economy",
-          "standard",
-          "express"
-        ],
-        "type": "string"
-      },
-      "shippingMode": {
-        "enum": [
-          "courier",
-          "air",
-          "sea",
-          "road",
-          "postal"
-        ],
-        "type": "string"
-      },
-      "volumetricWeightKg": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "estimatedCost",
-      "recommendedEstimate",
-      "actualWeightKg",
-      "volumetricWeightKg",
-      "chargeableWeightKg",
-      "shippingMode",
-      "serviceLevel",
-      "estimatedTransitDays",
-      "costBreakdown",
-      "rateSource",
-      "provider",
-      "dutiesAndTaxes",
-      "confidence",
-      "assumptions",
-      "riskFlags",
-      "options",
-      "recommendedOptionReason",
-      "generatedAt"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "nextAction": {
-        "additionalProperties": false,
-        "properties": {
-          "instruction": {
-            "type": "string"
-          },
-          "target": {
-            "enum": [
-              "x402_endpoint",
-              "mcp_credits_endpoint",
-              "payment_endpoint",
-              "unavailable"
-            ],
-            "type": "string"
-          },
-          "type": {
-            "enum": [
-              "pay_and_retry",
-              "authorize_and_use_mcp_credits",
-              "payment_unavailable"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "target",
-          "instruction"
-        ],
-        "type": "object"
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "endpoint": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "method": {
-            "const": "POST",
-            "type": "string"
-          },
-          "retrySameBody": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "endpoint",
-          "method",
-          "retrySameBody"
-        ],
-        "type": "object"
-      },
-      "paymentGuidance": {},
-      "preview": {
-        "additionalProperties": false,
-        "properties": {
-          "fullResultAvailable": {
-            "const": true,
-            "type": "boolean"
-          },
-          "inputAccepted": {
-            "const": true,
-            "type": "boolean"
-          },
-          "summary": {
-            "type": "string"
-          },
-          "useCases": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "inputAccepted",
-          "fullResultAvailable",
-          "summary",
-          "useCases"
-        ],
-        "type": "object"
-      },
-      "price": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "currency": {
-            "type": "string"
-          },
-          "protocol": {
-            "enum": [
-              "x402",
-              "api_credits",
-              "subscription",
-              "l402",
-              "mpp",
-              "unavailable"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency",
-          "protocol"
-        ],
-        "type": "object"
-      },
-      "requestId": {
-        "type": "string"
-      },
-      "status": {
-        "const": "payment_required",
-        "type": "string"
-      },
-      "tool": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "tool",
-      "requestId",
-      "price",
-      "preview",
-      "payment",
-      "nextAction"
-    ],
-    "type": "object"
-  }
-]
    • addedOutput schema / properties
      Added value: +{
+  "actualWeightKg": {
+    "exclusiveMinimum": 0,
+    "type": "number"
+  },
+  "assumptions": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "chargeableWeightKg": {
+    "exclusiveMinimum": 0,
+    "type": "number"
+  },
+  "confidence": {
+    "additionalProperties": false,
+    "properties": {
+      "level": {
+        "enum": [
+          "high",
+          "medium",
+          "low"
+        ],
+        "type": "string"
+      },
+      "reason": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "level",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "costBreakdown": {
+    "additionalProperties": false,
+    "properties": {
+      "baseFreight": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "estimatedOtherFees": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "fuelSurcharge": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "handling": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "oversizeSurcharge": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "remoteAreaSurcharge": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "baseFreight",
+      "fuelSurcharge",
+      "handling",
+      "remoteAreaSurcharge",
+      "oversizeSurcharge",
+      "estimatedOtherFees"
+    ],
+    "type": "object"
+  },
+  "dutiesAndTaxes": {
+    "additionalProperties": false,
+    "properties": {
+      "estimatedAmount": {
+        "type": "null"
+      },
+      "included": {
+        "const": false,
+        "type": "boolean"
+      },
+      "note": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "included",
+      "estimatedAmount",
+      "note"
+    ],
+    "type": "object"
+  },
+  "estimatedCost": {
+    "additionalProperties": false,
+    "properties": {
+      "currency": {
+        "type": "string"
+      },
+      "max": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "min": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "min",
+      "max",
+      "currency"
+    ],
+    "type": "object"
+  },
+  "estimatedTransitDays": {
+    "additionalProperties": false,
+    "properties": {
+      "max": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "min": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "min",
+      "max"
+    ],
+    "type": "object"
+  },
+  "generatedAt": {
+    "format": "date-time",
+    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+    "type": "string"
+  },
+  "options": {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "estimatedCost": {
+          "additionalProperties": false,
+          "properties": {
+            "currency": {
+              "type": "string"
+            },
+            "max": {
+              "minimum": 0,
+              "type": "number"
+            },
+            "min": {
+              "minimum": 0,
+              "type": "number"
+            }
+          },
+          "required": [
+            "min",
+            "max",
+            "currency"
+          ],
+          "type": "object"
+        },
+        "estimatedTransitDays": {
+          "additionalProperties": false,
+          "properties": {
+            "max": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            },
+            "min": {
+              "maximum": 9007199254740991,
+              "minimum": 0,
+              "type": "integer"
+            }
+          },
+          "required": [
+            "min",
+            "max"
+          ],
+          "type": "object"
+        },
+        "provider": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "rateSource": {
+          "enum": [
+            "live_carrier",
+            "internal_estimate",
+            "heuristic_estimate"
+          ],
+          "type": "string"
+        },
+        "serviceLevel": {
+          "enum": [
+            "economy",
+            "standard",
+            "express"
+          ],
+          "type": "string"
+        },
+        "shippingMode": {
+          "enum": [
+            "courier",
+            "air",
+            "sea",
+            "road",
+            "postal"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "shippingMode",
+        "serviceLevel",
+        "estimatedCost",
+        "estimatedTransitDays",
+        "rateSource",
+        "provider"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "provider": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "rateSource": {
+    "enum": [
+      "live_carrier",
+      "internal_estimate",
+      "heuristic_estimate"
+    ],
+    "type": "string"
+  },
+  "recommendedEstimate": {
+    "minimum": 0,
+    "type": "number"
+  },
+  "recommendedOptionReason": {
+    "anyOf": [
+      {
+        "enum": [
+          "lowest_estimated_cost",
+          "shortest_transit",
+          "balanced_cost_and_time"
+        ],
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "riskFlags": {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        },
+        "severity": {
+          "enum": [
+            "low",
+            "medium",
+            "high"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "code",
+        "severity",
+        "message"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "serviceLevel": {
+    "enum": [
+      "economy",
+      "standard",
+      "express"
+    ],
+    "type": "string"
+  },
+  "shippingMode": {
+    "enum": [
+      "courier",
+      "air",
+      "sea",
+      "road",
+      "postal"
+    ],
+    "type": "string"
+  },
+  "volumetricWeightKg": {
+    "minimum": 0,
+    "type": "number"
+  }
+}
    • addedOutput schema / required
      Added value: +[
+  "estimatedCost",
+  "recommendedEstimate",
+  "actualWeightKg",
+  "volumetricWeightKg",
+  "chargeableWeightKg",
+  "shippingMode",
+  "serviceLevel",
+  "estimatedTransitDays",
+  "costBreakdown",
+  "rateSource",
+  "provider",
+  "dutiesAndTaxes",
+  "confidence",
+  "assumptions",
+  "riskFlags",
+  "options",
+  "recommendedOptionReason",
+  "generatedAt"
+]
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "actualWeightKg": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "chargeableWeightKg": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "confidence": {
-        "additionalProperties": false,
-        "properties": {
-          "level": {
-            "enum": [
-              "high",
-              "medium",
-              "low"
-            ],
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "level",
-          "reason"
-        ],
-        "type": "object"
-      },
-      "costBreakdown": {
-        "additionalProperties": false,
-        "properties": {
-          "baseFreight": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "estimatedOtherFees": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "fuelSurcharge": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "handling": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "oversizeSurcharge": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "remoteAreaSurcharge": {
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "baseFreight",
-          "fuelSurcharge",
-          "handling",
-          "remoteAreaSurcharge",
-          "oversizeSurcharge",
-          "estimatedOtherFees"
-        ],
-        "type": "object"
-      },
-      "dutiesAndTaxes": {
-        "additionalProperties": false,
-        "properties": {
-          "estimatedAmount": {
-            "type": "null"
-          },
-          "included": {
-            "const": false,
-            "type": "boolean"
-          },
-          "note": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "included",
-          "estimatedAmount",
-          "note"
-        ],
-        "type": "object"
-      },
-      "estimatedCost": {
-        "additionalProperties": false,
-        "properties": {
-          "currency": {
-            "type": "string"
-          },
-          "max": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "min": {
-            "minimum": 0,
-            "type": "number"
-          }
-        },
-        "required": [
-          "min",
-          "max",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "estimatedTransitDays": {
-        "additionalProperties": false,
-        "properties": {
-          "max": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "min": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "min",
-          "max"
-        ],
-        "type": "object"
-      },
-      "generatedAt": {
-        "format": "date-time",
-        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-        "type": "string"
-      },
-      "options": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "estimatedCost": {
-              "additionalProperties": false,
-              "properties": {
-                "currency": {
-                  "type": "string"
-                },
-                "max": {
-                  "minimum": 0,
-                  "type": "number"
-                },
-                "min": {
-                  "minimum": 0,
-                  "type": "number"
-                }
-              },
-              "required": [
-                "min",
-                "max",
-                "currency"
-              ],
-              "type": "object"
-            },
-            "estimatedTransitDays": {
-              "additionalProperties": false,
-              "properties": {
-                "max": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "min": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                }
-              },
-              "required": [
-                "min",
-                "max"
-              ],
-              "type": "object"
-            },
-            "provider": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "rateSource": {
-              "enum": [
-                "live_carrier",
-                "internal_estimate",
-                "heuristic_estimate"
-              ],
-              "type": "string"
-            },
-            "serviceLevel": {
-              "enum": [
-                "economy",
-                "standard",
-                "express"
-              ],
-              "type": "string"
-            },
-            "shippingMode": {
-              "enum": [
-                "courier",
-                "air",
-                "sea",
-                "road",
-                "postal"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "shippingMode",
-            "serviceLevel",
-            "estimatedCost",
-            "estimatedTransitDays",
-            "rateSource",
-            "provider"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "provider": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "rateSource": {
-        "enum": [
-          "live_carrier",
-          "internal_estimate",
-          "heuristic_estimate"
-        ],
-        "type": "string"
-      },
-      "recommendedEstimate": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "recommendedOptionReason": {
-        "anyOf": [
-          {
-            "enum": [
-              "lowest_estimated_cost",
-              "shortest_transit",
-              "balanced_cost_and_time"
-            ],
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "riskFlags": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "severity": {
-              "enum": [
-                "low",
-                "medium",
-                "high"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "code",
-            "severity",
-            "message"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "serviceLevel": {
-        "enum": [
-          "economy",
-          "standard",
-          "express"
-        ],
-        "type": "string"
-      },
-      "shippingMode": {
-        "enum": [
-          "courier",
-          "air",
-          "sea",
-          "road",
-          "postal"
-        ],
-        "type": "string"
-      },
-      "volumetricWeightKg": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "estimatedCost",
-      "recommendedEstimate",
-      "actualWeightKg",
-      "volumetricWeightKg",
-      "chargeableWeightKg",
-      "shippingMode",
-      "serviceLevel",
-      "estimatedTransitDays",
-      "costBreakdown",
-      "rateSource",
-      "provider",
-      "dutiesAndTaxes",
-      "confidence",
-      "assumptions",
-      "riskFlags",
-      "options",
-      "recommendedOptionReason",
-      "generatedAt"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "nextAction": {
-        "additionalProperties": false,
-        "properties": {
-          "instruction": {
-            "type": "string"
-          },
-          "target": {
-            "const": "x402_endpoint",
-            "type": "string"
-          },
-          "type": {
-            "const": "pay_and_retry",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "target",
-          "instruction"
-        ],
-        "type": "object"
-      },
-      "payment": {
-        "additionalProperties": false,
-        "properties": {
-          "endpoint": {
-            "type": "string"
-          },
-          "method": {
-            "const": "POST",
-            "type": "string"
-          },
-          "retrySameBody": {
-            "const": true,
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "endpoint",
-          "method",
-          "retrySameBody"
-        ],
-        "type": "object"
-      },
-      "preview": {
-        "additionalProperties": false,
-        "properties": {
-          "fullResultAvailable": {
-            "const": true,
-            "type": "boolean"
-          },
-          "inputAccepted": {
-            "const": true,
-            "type": "boolean"
-          },
-          "summary": {
-            "type": "string"
-          },
-          "useCases": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "inputAccepted",
-          "fullResultAvailable",
-          "summary",
-          "useCases"
-        ],
-        "type": "object"
-      },
-      "price": {
-        "additionalProperties": false,
-        "properties": {
-          "amount": {
-            "minimum": 0,
-            "type": "number"
-          },
-          "currency": {
-            "type": "string"
-          },
-          "protocol": {
-            "const": "x402",
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency",
-          "protocol"
-        ],
-        "type": "object"
-      },
-      "requestId": {
-        "type": "string"
-      },
-      "status": {
-        "const": "payment_required",
-        "type": "string"
-      },
-      "tool": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "tool",
-      "requestId",
-      "price",
-      "preview",
-      "payment",
-      "nextAction"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "actualWeightKg": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "chargeableWeightKg": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "high",
+              "medium",
+              "low"
+            ],
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "level",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "costBreakdown": {
+        "additionalProperties": false,
+        "properties": {
+          "baseFreight": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "estimatedOtherFees": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "fuelSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "handling": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "oversizeSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "remoteAreaSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "baseFreight",
+          "fuelSurcharge",
+          "handling",
+          "remoteAreaSurcharge",
+          "oversizeSurcharge",
+          "estimatedOtherFees"
+        ],
+        "type": "object"
+      },
+      "dutiesAndTaxes": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedAmount": {
+            "type": "null"
+          },
+          "included": {
+            "const": false,
+            "type": "boolean"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "included",
+          "estimatedAmount",
+          "note"
+        ],
+        "type": "object"
+      },
+      "estimatedCost": {
+        "additionalProperties": false,
+        "properties": {
+          "currency": {
+            "type": "string"
+          },
+          "max": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "min": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "min",
+          "max",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "estimatedTransitDays": {
+        "additionalProperties": false,
+        "properties": {
+          "max": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "min": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "min",
+          "max"
+        ],
+        "type": "object"
+      },
+      "generatedAt": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+        "type": "string"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "estimatedCost": {
+              "additionalProperties": false,
+              "properties": {
+                "currency": {
+                  "type": "string"
+                },
+                "max": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "min": {
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "min",
+                "max",
+                "currency"
+              ],
+              "type": "object"
+            },
+            "estimatedTransitDays": {
+              "additionalProperties": false,
+              "properties": {
+                "max": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "min": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "type": "object"
+            },
+            "provider": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "rateSource": {
+              "enum": [
+                "live_carrier",
+                "internal_estimate",
+                "heuristic_estimate"
+              ],
+              "type": "string"
+            },
+            "serviceLevel": {
+              "enum": [
+                "economy",
+                "standard",
+                "express"
+              ],
+              "type": "string"
+            },
+            "shippingMode": {
+              "enum": [
+                "courier",
+                "air",
+                "sea",
+                "road",
+                "postal"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "shippingMode",
+            "serviceLevel",
+            "estimatedCost",
+            "estimatedTransitDays",
+            "rateSource",
+            "provider"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "provider": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rateSource": {
+        "enum": [
+          "live_carrier",
+          "internal_estimate",
+          "heuristic_estimate"
+        ],
+        "type": "string"
+      },
+      "recommendedEstimate": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "recommendedOptionReason": {
+        "anyOf": [
+          {
+            "enum": [
+              "lowest_estimated_cost",
+              "shortest_transit",
+              "balanced_cost_and_time"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "riskFlags": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "severity": {
+              "enum": [
+                "low",
+                "medium",
+                "high"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "severity",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "serviceLevel": {
+        "enum": [
+          "economy",
+          "standard",
+          "express"
+        ],
+        "type": "string"
+      },
+      "shippingMode": {
+        "enum": [
+          "courier",
+          "air",
+          "sea",
+          "road",
+          "postal"
+        ],
+        "type": "string"
+      },
+      "volumetricWeightKg": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "estimatedCost",
+      "recommendedEstimate",
+      "actualWeightKg",
+      "volumetricWeightKg",
+      "chargeableWeightKg",
+      "shippingMode",
+      "serviceLevel",
+      "estimatedTransitDays",
+      "costBreakdown",
+      "rateSource",
+      "provider",
+      "dutiesAndTaxes",
+      "confidence",
+      "assumptions",
+      "riskFlags",
+      "options",
+      "recommendedOptionReason",
+      "generatedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nextAction": {
+        "additionalProperties": false,
+        "properties": {
+          "instruction": {
+            "type": "string"
+          },
+          "target": {
+            "enum": [
+              "x402_endpoint",
+              "mcp_credits_endpoint",
+              "payment_endpoint",
+              "unavailable"
+            ],
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "pay_and_retry",
+              "authorize_and_use_mcp_credits",
+              "payment_unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "instruction"
+        ],
+        "type": "object"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "method": {
+            "const": "POST",
+            "type": "string"
+          },
+          "retrySameBody": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "endpoint",
+          "method",
+          "retrySameBody"
+        ],
+        "type": "object"
+      },
+      "paymentGuidance": {},
+      "preview": {
+        "additionalProperties": false,
+        "properties": {
+          "fullResultAvailable": {
+            "const": true,
+            "type": "boolean"
+          },
+          "inputAccepted": {
+            "const": true,
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "useCases": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "inputAccepted",
+          "fullResultAvailable",
+          "summary",
+          "useCases"
+        ],
+        "type": "object"
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "protocol": {
+            "enum": [
+              "x402",
+              "api_credits",
+              "subscription",
+              "l402",
+              "mpp",
+              "unavailable"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      "requestId": {
+        "type": "string"
+      },
+      "status": {
+        "const": "payment_required",
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "tool",
+      "requestId",
+      "price",
+      "preview",
+      "payment",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]
  4. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "actualWeightKg": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "chargeableWeightKg": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "confidence": {
+        "additionalProperties": false,
+        "properties": {
+          "level": {
+            "enum": [
+              "high",
+              "medium",
+              "low"
+            ],
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "level",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "costBreakdown": {
+        "additionalProperties": false,
+        "properties": {
+          "baseFreight": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "estimatedOtherFees": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "fuelSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "handling": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "oversizeSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "remoteAreaSurcharge": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "baseFreight",
+          "fuelSurcharge",
+          "handling",
+          "remoteAreaSurcharge",
+          "oversizeSurcharge",
+          "estimatedOtherFees"
+        ],
+        "type": "object"
+      },
+      "dutiesAndTaxes": {
+        "additionalProperties": false,
+        "properties": {
+          "estimatedAmount": {
+            "type": "null"
+          },
+          "included": {
+            "const": false,
+            "type": "boolean"
+          },
+          "note": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "included",
+          "estimatedAmount",
+          "note"
+        ],
+        "type": "object"
+      },
+      "estimatedCost": {
+        "additionalProperties": false,
+        "properties": {
+          "currency": {
+            "type": "string"
+          },
+          "max": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "min": {
+            "minimum": 0,
+            "type": "number"
+          }
+        },
+        "required": [
+          "min",
+          "max",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "estimatedTransitDays": {
+        "additionalProperties": false,
+        "properties": {
+          "max": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "min": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "min",
+          "max"
+        ],
+        "type": "object"
+      },
+      "generatedAt": {
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
+        "type": "string"
+      },
+      "options": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "estimatedCost": {
+              "additionalProperties": false,
+              "properties": {
+                "currency": {
+                  "type": "string"
+                },
+                "max": {
+                  "minimum": 0,
+                  "type": "number"
+                },
+                "min": {
+                  "minimum": 0,
+                  "type": "number"
+                }
+              },
+              "required": [
+                "min",
+                "max",
+                "currency"
+              ],
+              "type": "object"
+            },
+            "estimatedTransitDays": {
+              "additionalProperties": false,
+              "properties": {
+                "max": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                },
+                "min": {
+                  "maximum": 9007199254740991,
+                  "minimum": 0,
+                  "type": "integer"
+                }
+              },
+              "required": [
+                "min",
+                "max"
+              ],
+              "type": "object"
+            },
+            "provider": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "rateSource": {
+              "enum": [
+                "live_carrier",
+                "internal_estimate",
+                "heuristic_estimate"
+              ],
+              "type": "string"
+            },
+            "serviceLevel": {
+              "enum": [
+                "economy",
+                "standard",
+                "express"
+              ],
+              "type": "string"
+            },
+            "shippingMode": {
+              "enum": [
+                "courier",
+                "air",
+                "sea",
+                "road",
+                "postal"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "shippingMode",
+            "serviceLevel",
+            "estimatedCost",
+            "estimatedTransitDays",
+            "rateSource",
+            "provider"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "provider": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "rateSource": {
+        "enum": [
+          "live_carrier",
+          "internal_estimate",
+          "heuristic_estimate"
+        ],
+        "type": "string"
+      },
+      "recommendedEstimate": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "recommendedOptionReason": {
+        "anyOf": [
+          {
+            "enum": [
+              "lowest_estimated_cost",
+              "shortest_transit",
+              "balanced_cost_and_time"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "riskFlags": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            },
+            "severity": {
+              "enum": [
+                "low",
+                "medium",
+                "high"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "severity",
+            "message"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "serviceLevel": {
+        "enum": [
+          "economy",
+          "standard",
+          "express"
+        ],
+        "type": "string"
+      },
+      "shippingMode": {
+        "enum": [
+          "courier",
+          "air",
+          "sea",
+          "road",
+          "postal"
+        ],
+        "type": "string"
+      },
+      "volumetricWeightKg": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "estimatedCost",
+      "recommendedEstimate",
+      "actualWeightKg",
+      "volumetricWeightKg",
+      "chargeableWeightKg",
+      "shippingMode",
+      "serviceLevel",
+      "estimatedTransitDays",
+      "costBreakdown",
+      "rateSource",
+      "provider",
+      "dutiesAndTaxes",
+      "confidence",
+      "assumptions",
+      "riskFlags",
+      "options",
+      "recommendedOptionReason",
+      "generatedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "nextAction": {
+        "additionalProperties": false,
+        "properties": {
+          "instruction": {
+            "type": "string"
+          },
+          "target": {
+            "const": "x402_endpoint",
+            "type": "string"
+          },
+          "type": {
+            "const": "pay_and_retry",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target",
+          "instruction"
+        ],
+        "type": "object"
+      },
+      "payment": {
+        "additionalProperties": false,
+        "properties": {
+          "endpoint": {
+            "type": "string"
+          },
+          "method": {
+            "const": "POST",
+            "type": "string"
+          },
+          "retrySameBody": {
+            "const": true,
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "endpoint",
+          "method",
+          "retrySameBody"
+        ],
+        "type": "object"
+      },
+      "preview": {
+        "additionalProperties": false,
+        "properties": {
+          "fullResultAvailable": {
+            "const": true,
+            "type": "boolean"
+          },
+          "inputAccepted": {
+            "const": true,
+            "type": "boolean"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "useCases": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "inputAccepted",
+          "fullResultAvailable",
+          "summary",
+          "useCases"
+        ],
+        "type": "object"
+      },
+      "price": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "minimum": 0,
+            "type": "number"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "protocol": {
+            "const": "x402",
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency",
+          "protocol"
+        ],
+        "type": "object"
+      },
+      "requestId": {
+        "type": "string"
+      },
+      "status": {
+        "const": "payment_required",
+        "type": "string"
+      },
+      "tool": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "tool",
+      "requestId",
+      "price",
+      "preview",
+      "payment",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]
    • removedOutput schema / properties
      Removed value: -{
-  "actualWeightKg": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "assumptions": {
-    "items": {
-      "type": "string"
-    },
-    "type": "array"
-  },
-  "chargeableWeightKg": {
-    "exclusiveMinimum": 0,
-    "type": "number"
-  },
-  "confidence": {
-    "additionalProperties": false,
-    "properties": {
-      "level": {
-        "enum": [
-          "high",
-          "medium",
-          "low"
-        ],
-        "type": "string"
-      },
-      "reason": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "level",
-      "reason"
-    ],
-    "type": "object"
-  },
-  "costBreakdown": {
-    "additionalProperties": false,
-    "properties": {
-      "baseFreight": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "estimatedOtherFees": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "fuelSurcharge": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "handling": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "oversizeSurcharge": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "remoteAreaSurcharge": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "baseFreight",
-      "fuelSurcharge",
-      "handling",
-      "remoteAreaSurcharge",
-      "oversizeSurcharge",
-      "estimatedOtherFees"
-    ],
-    "type": "object"
-  },
-  "dutiesAndTaxes": {
-    "additionalProperties": false,
-    "properties": {
-      "estimatedAmount": {
-        "type": "null"
-      },
-      "included": {
-        "const": false,
-        "type": "boolean"
-      },
-      "note": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "included",
-      "estimatedAmount",
-      "note"
-    ],
-    "type": "object"
-  },
-  "estimatedCost": {
-    "additionalProperties": false,
-    "properties": {
-      "currency": {
-        "type": "string"
-      },
-      "max": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "min": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "min",
-      "max",
-      "currency"
-    ],
-    "type": "object"
-  },
-  "estimatedTransitDays": {
-    "additionalProperties": false,
-    "properties": {
-      "max": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "min": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "min",
-      "max"
-    ],
-    "type": "object"
-  },
-  "generatedAt": {
-    "format": "date-time",
-    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
-    "type": "string"
-  },
-  "options": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "estimatedCost": {
-          "additionalProperties": false,
-          "properties": {
-            "currency": {
-              "type": "string"
-            },
-            "max": {
-              "minimum": 0,
-              "type": "number"
-            },
-            "min": {
-              "minimum": 0,
-              "type": "number"
-            }
-          },
-          "required": [
-            "min",
-            "max",
-            "currency"
-          ],
-          "type": "object"
-        },
-        "estimatedTransitDays": {
-          "additionalProperties": false,
-          "properties": {
-            "max": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "min": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "min",
-            "max"
-          ],
-          "type": "object"
-        },
-        "provider": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "rateSource": {
-          "enum": [
-            "live_carrier",
-            "internal_estimate",
-            "heuristic_estimate"
-          ],
-          "type": "string"
-        },
-        "serviceLevel": {
-          "enum": [
-            "economy",
-            "standard",
-            "express"
-          ],
-          "type": "string"
-        },
-        "shippingMode": {
-          "enum": [
-            "courier",
-            "air",
-            "sea",
-            "road",
-            "postal"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "shippingMode",
-        "serviceLevel",
-        "estimatedCost",
-        "estimatedTransitDays",
-        "rateSource",
-        "provider"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "provider": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "rateSource": {
-    "enum": [
-      "live_carrier",
-      "internal_estimate",
-      "heuristic_estimate"
-    ],
-    "type": "string"
-  },
-  "recommendedEstimate": {
-    "minimum": 0,
-    "type": "number"
-  },
-  "recommendedOptionReason": {
-    "anyOf": [
-      {
-        "enum": [
-          "lowest_estimated_cost",
-          "shortest_transit",
-          "balanced_cost_and_time"
-        ],
-        "type": "string"
-      },
-      {
-        "type": "null"
-      }
-    ]
-  },
-  "riskFlags": {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "code": {
-          "type": "string"
-        },
-        "message": {
-          "type": "string"
-        },
-        "severity": {
-          "enum": [
-            "low",
-            "medium",
-            "high"
-          ],
-          "type": "string"
-        }
-      },
-      "required": [
-        "code",
-        "severity",
-        "message"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  "serviceLevel": {
-    "enum": [
-      "economy",
-      "standard",
-      "express"
-    ],
-    "type": "string"
-  },
-  "shippingMode": {
-    "enum": [
-      "courier",
-      "air",
-      "sea",
-      "road",
-      "postal"
-    ],
-    "type": "string"
-  },
-  "volumetricWeightKg": {
-    "minimum": 0,
-    "type": "number"
-  }
-}
    • removedOutput schema / required
      Removed value: -[
-  "estimatedCost",
-  "recommendedEstimate",
-  "actualWeightKg",
-  "volumetricWeightKg",
-  "chargeableWeightKg",
-  "shippingMode",
-  "serviceLevel",
-  "estimatedTransitDays",
-  "costBreakdown",
-  "rateSource",
-  "provider",
-  "dutiesAndTaxes",
-  "confidence",
-  "assumptions",
-  "riskFlags",
-  "options",
-  "recommendedOptionReason",
-  "generatedAt"
-]
  5. Added

TDQS

A4.6/5.0
Behavior5/5

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

Annotations already cover read-only, idempotent and non-destructive behavior. The description adds important operational context beyond that: estimates are not guaranteed quotes, duties/taxes are excluded, input must be strict JSON, cost is $0.25 per call via x402, unpaid calls return payment instructions, and a free preview exists through preview_capability.

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?

The description is front-loaded with what the tool does, then caveats, usage, input, and pricing. It is a bit long and has some redundancy between the estimate caveat and the 'Do not use' exclusion, but most sentences earn their place given the paid/preview flow.

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

Completeness5/5

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

An output schema exists, so return values need not be explained, and annotations cover the safety profile. The description completes the picture for a paid, nested-input tool by covering purpose, exclusions, when to use, input format, pricing, preview path, and payment behavior.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate for parameter meaning. It names the core inputs (shipment dimensions, weight, origin, destination, service level), which helps, but it omits currency, shippingMode, and nested shipment options such as quantity, category, and declaredValue, and gives no enum or unit semantics. It partially compensates but leaves clear gaps.

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

Purpose5/5

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

The description states a specific verb and resource ('Estimate ... shipping cost, chargeable weight, transit time and common shipping surcharges') and clarifies scope ('domestic or international'). It also distinguishes itself from adjacent cost tools by declaring itself 'primary' for route and shipment cost estimation and by excluding customs/tax and guaranteed quote use cases.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

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

The description has explicit 'When:' and 'Selection:' sections plus a 'Do not use for...' exclusion. It names an alternative paid flow via 'preview_capability' for a free preview before payment, so an agent knows both when to select this tool and how to avoid paying unnecessarily.

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

All Rafid Intelligence Network 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