Skip to main content
Glama
Sign In

Rafid Intelligence Network

by io.github.iabdullahm
OverviewDiscussionsAdmin

trip_cost_estimate

Read-onlyIdempotent

Estimate flight and hotel trip cost from current provider offers, with explicit missing components and assumptions. When: Use when an agent needs trip cost estimate from current travel offers. Selection: primary; prefer for Use when an agent needs trip cost estimate from current travel offers.. 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
sortNoprice
hotelNo
limitNo
adultsNo
originYes
infantsNoInfant pricing is not supported by this adapter.
childrenNo
currencyNoUSD
maxStopsNo
strategyNobalanced
childAgesNo
cabinClassNoeconomy
returnDateYes
destinationYes
nationalityNo
departureDateYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added
  2. Removed
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "assumptions": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "confidence": {
-        "enum": [
-          "complete_search_coverage",
-          "partial_search_coverage"
-        ],
-        "type": "string"
-      },
-      "cost": {
-        "additionalProperties": false,
-        "properties": {
-          "currency": {
-            "type": "string"
-          },
-          "estimatedSubtotal": {
-            "type": "number"
-          },
-          "estimatedTotal": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "flight": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "hotel": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "flight",
-          "hotel",
-          "estimatedSubtotal",
-          "estimatedTotal",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "dataFreshness": {
-        "additionalProperties": false,
-        "properties": {
-          "flight": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "hotel": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "flight",
-          "hotel"
-        ],
-        "type": "object"
-      },
-      "dataMode": {
-        "const": "live",
-        "type": "string"
-      },
-      "dates": {
-        "additionalProperties": false,
-        "properties": {
-          "departure": {
-            "type": "string"
-          },
-          "nights": {
-            "type": "number"
-          },
-          "return": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "departure",
-          "return",
-          "nights"
-        ],
-        "type": "object"
-      },
-      "partial": {
-        "type": "boolean"
-      },
-      "route": {
-        "additionalProperties": false,
-        "properties": {
-          "destination": {
-            "type": "string"
-          },
-          "origin": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "origin",
-          "destination"
-        ],
-        "type": "object"
-      },
-      "searchedAt": {
-        "type": "string"
-      },
-      "selected": {
-        "additionalProperties": false,
-        "properties": {
-          "flight": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "airlines": {
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "arrivalAt": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "baggage": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "departureAt": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "durationMinutes": {
-                    "anyOf": [
-                      {
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "id": {
-                    "type": "string"
-                  },
-                  "price": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "amount": {
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      "currency": {
-                        "pattern": "^[A-Z]{3}$",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "amount",
-                      "currency"
-                    ],
-                    "type": "object"
-                  },
-                  "provider": {
-                    "const": "letsfg",
-                    "type": "string"
-                  },
-                  "refundable": {
-                    "type": [
-                      "boolean",
-                      "null"
-                    ]
-                  },
-                  "reliability": {
-                    "anyOf": [
-                      {
-                        "maximum": 1,
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "segments": {
-                    "items": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "airline": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "arrivalAt": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "departureAt": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "destination": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "origin": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        }
-                      },
-                      "required": [
-                        "origin",
-                        "destination",
-                        "departureAt",
-                        "arrivalAt",
-                        "airline"
-                      ],
-                      "type": "object"
-                    },
-                    "type": "array"
-                  },
-                  "selfTransfer": {
-                    "type": "boolean"
-                  },
-                  "splitTicket": {
-                    "type": "boolean"
-                  },
-                  "stops": {
-                    "anyOf": [
-                      {
-                        "maximum": 9007199254740991,
-                        "minimum": 0,
-                        "type": "integer"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "transferProtection": {
-                    "anyOf": [
-                      {
-                        "enum": [
-                          "protected",
-                          "unprotected"
-                        ],
-                        "type": "string"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  }
-                },
-                "required": [
-                  "id",
-                  "price",
-                  "airlines",
-                  "segments",
-                  "stops",
-                  "durationMinutes",
-                  "departureAt",
-                  "arrivalAt",
-                  "reliability",
-                  "refundable",
-                  "baggage",
-                  "splitTicket",
-                  "selfTransfer",
-                  "provider"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "hotel": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "id": {
-                    "type": "string"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "offers": {
-                    "items": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "cancellationPolicy": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "freeCancellationUntil": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "id": {
-                          "type": "string"
-                        },
-                        "price": {
-                          "additionalProperties": false,
-                          "properties": {
-                            "amount": {
-                              "minimum": 0,
-                              "type": "number"
-                            },
-                            "currency": {
-                              "pattern": "^[A-Z]{3}$",
-                              "type": "string"
-                            }
-                          },
-                          "required": [
-                            "amount",
-                            "currency"
-                          ],
-                          "type": "object"
-                        },
-                        "provider": {
-                          "const": "letsfg",
-                          "type": "string"
-                        },
-                        "refundable": {
-                          "type": [
-                            "boolean",
-                            "null"
-                          ]
-                        },
-                        "roomName": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        }
-                      },
-                      "required": [
-                        "id",
-                        "roomName",
-                        "price",
-                        "refundable",
-                        "freeCancellationUntil",
-                        "cancellationPolicy",
-                        "provider"
-                      ],
-                      "type": "object"
-                    },
-                    "type": "array"
-                  },
-                  "stars": {
-                    "anyOf": [
-                      {
-                        "maximum": 5,
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  }
-                },
-                "required": [
-                  "id",
-                  "name",
-                  "stars",
-                  "offers"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "hotelOffer": {
-            "anyOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "cancellationPolicy": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "freeCancellationUntil": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "id": {
-                    "type": "string"
-                  },
-                  "price": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "amount": {
-                        "minimum": 0,
-                        "type": "number"
-                      },
-                      "currency": {
-                        "pattern": "^[A-Z]{3}$",
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "amount",
-                      "currency"
-                    ],
-                    "type": "object"
-                  },
-                  "provider": {
-                    "const": "letsfg",
-                    "type": "string"
-                  },
-                  "refundable": {
-                    "type": [
-                      "boolean",
-                      "null"
-                    ]
-                  },
-                  "roomName": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  }
-                },
-                "required": [
-                  "id",
-                  "roomName",
-                  "price",
-                  "refundable",
-                  "freeCancellationUntil",
-                  "cancellationPolicy",
-                  "provider"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "flight",
-          "hotel",
-          "hotelOffer"
-        ],
-        "type": "object"
-      },
-      "unavailableComponents": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "component": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "component",
-            "code"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "route",
-      "dates",
-      "selected",
-      "cost",
-      "partial",
-      "unavailableComponents",
-      "confidence",
-      "assumptions",
-      "dataFreshness",
-      "searchedAt",
-      "dataMode"
-    ],
-    "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": {
+      "assumptions": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "confidence": {
+        "enum": [
+          "complete_search_coverage",
+          "partial_search_coverage"
+        ],
+        "type": "string"
+      },
+      "cost": {
+        "additionalProperties": false,
+        "properties": {
+          "currency": {
+            "type": "string"
+          },
+          "estimatedSubtotal": {
+            "type": "number"
+          },
+          "estimatedTotal": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "flight": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "hotel": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "flight",
+          "hotel",
+          "estimatedSubtotal",
+          "estimatedTotal",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "dataFreshness": {
+        "additionalProperties": false,
+        "properties": {
+          "flight": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "hotel": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "flight",
+          "hotel"
+        ],
+        "type": "object"
+      },
+      "dataMode": {
+        "const": "live",
+        "type": "string"
+      },
+      "dates": {
+        "additionalProperties": false,
+        "properties": {
+          "departure": {
+            "type": "string"
+          },
+          "nights": {
+            "type": "number"
+          },
+          "return": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "departure",
+          "return",
+          "nights"
+        ],
+        "type": "object"
+      },
+      "partial": {
+        "type": "boolean"
+      },
+      "route": {
+        "additionalProperties": false,
+        "properties": {
+          "destination": {
+            "type": "string"
+          },
+          "origin": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "origin",
+          "destination"
+        ],
+        "type": "object"
+      },
+      "searchedAt": {
+        "type": "string"
+      },
+      "selected": {
+        "additionalProperties": false,
+        "properties": {
+          "flight": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "airlines": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "arrivalAt": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "baggage": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "departureAt": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "durationMinutes": {
+                    "anyOf": [
+                      {
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "price": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "amount": {
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      "currency": {
+                        "pattern": "^[A-Z]{3}$",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "amount",
+                      "currency"
+                    ],
+                    "type": "object"
+                  },
+                  "provider": {
+                    "const": "letsfg",
+                    "type": "string"
+                  },
+                  "refundable": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
+                  },
+                  "reliability": {
+                    "anyOf": [
+                      {
+                        "maximum": 1,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "segments": {
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "airline": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "arrivalAt": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "departureAt": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "destination": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "origin": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "origin",
+                        "destination",
+                        "departureAt",
+                        "arrivalAt",
+                        "airline"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "selfTransfer": {
+                    "type": "boolean"
+                  },
+                  "splitTicket": {
+                    "type": "boolean"
+                  },
+                  "stops": {
+                    "anyOf": [
+                      {
+                        "maximum": 9007199254740991,
+                        "minimum": 0,
+                        "type": "integer"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "transferProtection": {
+                    "anyOf": [
+                      {
+                        "enum": [
+                          "protected",
+                          "unprotected"
+                        ],
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "price",
+                  "airlines",
+                  "segments",
+                  "stops",
+                  "durationMinutes",
+                  "departureAt",
+                  "arrivalAt",
+                  "reliability",
+                  "refundable",
+                  "baggage",
+                  "splitTicket",
+                  "selfTransfer",
+                  "provider"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "hotel": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "offers": {
+                    "items": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "cancellationPolicy": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "freeCancellationUntil": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "id": {
+                          "type": "string"
+                        },
+                        "price": {
+                          "additionalProperties": false,
+                          "properties": {
+                            "amount": {
+                              "minimum": 0,
+                              "type": "number"
+                            },
+                            "currency": {
+                              "pattern": "^[A-Z]{3}$",
+                              "type": "string"
+                            }
+                          },
+                          "required": [
+                            "amount",
+                            "currency"
+                          ],
+                          "type": "object"
+                        },
+                        "provider": {
+                          "const": "letsfg",
+                          "type": "string"
+                        },
+                        "refundable": {
+                          "type": [
+                            "boolean",
+                            "null"
+                          ]
+                        },
+                        "roomName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "roomName",
+                        "price",
+                        "refundable",
+                        "freeCancellationUntil",
+                        "cancellationPolicy",
+                        "provider"
+                      ],
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  "stars": {
+                    "anyOf": [
+                      {
+                        "maximum": 5,
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "name",
+                  "stars",
+                  "offers"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "hotelOffer": {
+            "anyOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "cancellationPolicy": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "freeCancellationUntil": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "id": {
+                    "type": "string"
+                  },
+                  "price": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "amount": {
+                        "minimum": 0,
+                        "type": "number"
+                      },
+                      "currency": {
+                        "pattern": "^[A-Z]{3}$",
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "amount",
+                      "currency"
+                    ],
+                    "type": "object"
+                  },
+                  "provider": {
+                    "const": "letsfg",
+                    "type": "string"
+                  },
+                  "refundable": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
+                  },
+                  "roomName": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "id",
+                  "roomName",
+                  "price",
+                  "refundable",
+                  "freeCancellationUntil",
+                  "cancellationPolicy",
+                  "provider"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "flight",
+          "hotel",
+          "hotelOffer"
+        ],
+        "type": "object"
+      },
+      "unavailableComponents": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "component": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "component",
+            "code"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "route",
+      "dates",
+      "selected",
+      "cost",
+      "partial",
+      "unavailableComponents",
+      "confidence",
+      "assumptions",
+      "dataFreshness",
+      "searchedAt",
+      "dataMode"
+    ],
+    "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. Added

TDQS

C2.9/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds genuinely non-structured behavior: $0.25 USD per call, a free preview path via preview_capability, x402 payment flow, and that unpaid calls return payment instructions rather than failing silently. It even signals output behavior ("explicit missing components and assumptions").

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The key facts are front-loaded, but the "When" and "Selection" sentences are duplicated near-verbatim (including a stray double period), which is pure filler. Pricing and payment routing earn their space; the selection boilerplate does not.

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

Completeness3/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 described, and annotations cover the safety profile. The description usefully covers cost/payment mechanics and the assumptions-disclosure behavior, but with 16 parameters it leaves the caller without any narrative for the many non-obvious inputs.

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

Parameters1/5

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

With 16 parameters, a nested hotel object and only 6% schema description coverage, the description carries the burden of explaining parameter meaning and adds nothing beyond "Input is a strict JSON object; see the schema." Unclear fields such as strategy, limit, maxStops, nationality, childAges and hotel.destination receive no explanation anywhere.

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

Purpose4/5

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

The opening sentence names a specific verb and resource: "Estimate flight and hotel trip cost from current provider offers," which is clearly distinct from single-domain siblings like flight_search or hotel_search in intent. It stops short of explicitly naming those siblings, but the combined flight+hotel scope is stated plainly.

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

Usage Guidelines2/5

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

The "When:" clause merely restates the purpose ("Use when an agent needs trip cost estimate from current travel offers"), and the "Selection:" field is broken template text that repeats the same sentence verbatim. No when-not conditions and no named alternatives (flight_search, hotel_search, flight_compare) are given.

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