Skip to main content
Glama
Sign In

Voyscout Price History

by com.voyscout
OverviewDiscussionsAdmin

List destinations

list_destinations
Read-only

Use when the user asks which destinations are tracked or how long a price history is ("co sledujete?", "what do you track?"), or when another tool needs a slug you do not know. List every destination with a published price series, with how many days each rail was actually measured and the calendar span those measurements fall in. A destination can have several rails (e.g. flights and packages), each with its OWN measured days and span: history depth is a property of the rail, not of the destination, so when you report it, name the rail or give each one. A city names its country under country, and related lists the other tracked pages of the same country (a country lists its cities): a party or rail missing on one page may be published on another, so check related before saying something is not tracked. same_airport_as marks pages that fly to the same airport from a different departure cluster - their prices differ because origins differ. Historical observations only. When you answer from this, say where the latest price sits in its own history and stop there: do not tell the reader to buy, book, wait, avoid or which destination to pick - the series carries no trend, volatility or live availability, so that judgement stays the reader's.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "count": {
-        "type": "integer"
-      },
-      "currency": {
-        "type": "string"
-      },
-      "destinations": {
-        "items": {
-          "properties": {
-            "generated": {
-              "type": "string"
-            },
-            "key": {
-              "type": "string"
-            },
-            "rails": {
-              "description": "one entry per rail; each carries its own `measured`, which is not the destination's",
-              "items": {
-                "properties": {
-                  "measured": {
-                    "properties": {
-                      "days": {
-                        "type": "integer"
-                      },
-                      "from": {
-                        "type": "string"
-                      },
-                      "to": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "days",
-                      "from",
-                      "to"
-                    ],
-                    "type": "object"
-                  },
-                  "party": {
-                    "properties": {
-                      "adults": {
-                        "type": "integer"
-                      },
-                      "children": {
-                        "type": "integer"
-                      }
-                    },
-                    "required": [
-                      "adults",
-                      "children"
-                    ],
-                    "type": "object"
-                  },
-                  "rail": {
-                    "enum": [
-                      "flight",
-                      "package"
-                    ],
-                    "type": "string"
-                  },
-                  "resort": {
-                    "type": "string"
-                  },
-                  "resort_key": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "rail",
-                  "party",
-                  "measured"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "slug": {
-              "type": "string"
-            },
-            "title": {
-              "properties": {
-                "cs": {
-                  "type": "string"
-                },
-                "en": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "cs",
-                "en"
-              ],
-              "type": "object"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "key",
-            "slug",
-            "title",
-            "url",
-            "generated",
-            "rails"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "disclaimer": {
-        "type": "string"
-      },
-      "license": {
-        "properties": {
-          "attribution": {
-            "type": "string"
-          },
-          "id": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "url",
-          "attribution"
-        ],
-        "type": "object"
-      },
-      "schema": {
-        "type": "string"
-      },
-      "stale_rails": {
-        "description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
-        "properties": {
-          "as_of": {
-            "type": "string"
-          },
-          "count": {
-            "type": "integer"
-          },
-          "keys": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "of": {
-            "type": "integer"
-          },
-          "unknown": {
-            "type": "integer"
-          }
-        },
-        "required": [
-          "as_of",
-          "of",
-          "count",
-          "keys"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "schema",
-      "currency",
-      "count",
-      "stale_rails",
-      "destinations",
-      "disclaimer"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "tool-level failure, returned with isError: true",
-    "properties": {
-      "error": {
-        "additionalProperties": true,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "count": {
+        "type": "integer"
+      },
+      "currency": {
+        "type": "string"
+      },
+      "destinations": {
+        "items": {
+          "properties": {
+            "country": {
+              "description": "the one country page this city belongs to, where the catalogue names exactly one",
+              "type": "string"
+            },
+            "generated": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            },
+            "rails": {
+              "description": "one entry per rail; each carries its own `measured`, which is not the destination's",
+              "items": {
+                "properties": {
+                  "measured": {
+                    "properties": {
+                      "days": {
+                        "type": "integer"
+                      },
+                      "from": {
+                        "type": "string"
+                      },
+                      "to": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "days",
+                      "from",
+                      "to"
+                    ],
+                    "type": "object"
+                  },
+                  "party": {
+                    "properties": {
+                      "adults": {
+                        "type": "integer"
+                      },
+                      "children": {
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "adults",
+                      "children"
+                    ],
+                    "type": "object"
+                  },
+                  "rail": {
+                    "enum": [
+                      "flight",
+                      "package"
+                    ],
+                    "type": "string"
+                  },
+                  "resort": {
+                    "type": "string"
+                  },
+                  "resort_key": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "rail",
+                  "party",
+                  "measured"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "related": {
+              "description": "the other tracked pages in the same country (a country lists its cities); a party or rail missing here may exist on one of them",
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "same_airport_as": {
+              "description": "pages whose flight rail lands at an airport this one records - measured from a different departure cluster (see `origins`), so their numbers differ for a reason",
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "slug": {
+              "type": "string"
+            },
+            "title": {
+              "properties": {
+                "cs": {
+                  "type": "string"
+                },
+                "en": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "cs",
+                "en"
+              ],
+              "type": "object"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "key",
+            "slug",
+            "title",
+            "url",
+            "generated",
+            "related",
+            "rails"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "disclaimer": {
+        "type": "string"
+      },
+      "license": {
+        "properties": {
+          "attribution": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "url",
+          "attribution"
+        ],
+        "type": "object"
+      },
+      "schema": {
+        "type": "string"
+      },
+      "stale_rails": {
+        "description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
+        "properties": {
+          "as_of": {
+            "type": "string"
+          },
+          "count": {
+            "type": "integer"
+          },
+          "keys": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "of": {
+            "type": "integer"
+          },
+          "unknown": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "as_of",
+          "of",
+          "count",
+          "keys"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "schema",
+      "currency",
+      "count",
+      "stale_rails",
+      "destinations",
+      "disclaimer"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "tool-level failure, returned with isError: true",
+    "properties": {
+      "error": {
+        "additionalProperties": true,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "count": {
-        "type": "integer"
-      },
-      "currency": {
-        "type": "string"
-      },
-      "destinations": {
-        "items": {
-          "properties": {
-            "generated": {
-              "type": "string"
-            },
-            "key": {
-              "type": "string"
-            },
-            "rails": {
-              "items": {
-                "properties": {
-                  "measured": {
-                    "properties": {
-                      "days": {
-                        "type": "integer"
-                      },
-                      "from": {
-                        "type": "string"
-                      },
-                      "to": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "days",
-                      "from",
-                      "to"
-                    ],
-                    "type": "object"
-                  },
-                  "party": {
-                    "properties": {
-                      "adults": {
-                        "type": "integer"
-                      },
-                      "children": {
-                        "type": "integer"
-                      }
-                    },
-                    "required": [
-                      "adults",
-                      "children"
-                    ],
-                    "type": "object"
-                  },
-                  "rail": {
-                    "enum": [
-                      "flight",
-                      "package"
-                    ],
-                    "type": "string"
-                  },
-                  "resort": {
-                    "type": "string"
-                  },
-                  "resort_key": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "rail",
-                  "party",
-                  "measured"
-                ],
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "slug": {
-              "type": "string"
-            },
-            "title": {
-              "properties": {
-                "cs": {
-                  "type": "string"
-                },
-                "en": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "cs",
-                "en"
-              ],
-              "type": "object"
-            },
-            "url": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "key",
-            "slug",
-            "title",
-            "url",
-            "generated",
-            "rails"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "disclaimer": {
-        "type": "string"
-      },
-      "license": {
-        "properties": {
-          "attribution": {
-            "type": "string"
-          },
-          "id": {
-            "type": "string"
-          },
-          "url": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "url",
-          "attribution"
-        ],
-        "type": "object"
-      },
-      "schema": {
-        "type": "string"
-      },
-      "stale_rails": {
-        "description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
-        "properties": {
-          "as_of": {
-            "type": "string"
-          },
-          "count": {
-            "type": "integer"
-          },
-          "keys": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "of": {
-            "type": "integer"
-          },
-          "unknown": {
-            "type": "integer"
-          }
-        },
-        "required": [
-          "as_of",
-          "of",
-          "count",
-          "keys"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "schema",
-      "currency",
-      "count",
-      "stale_rails",
-      "destinations",
-      "disclaimer"
-    ],
-    "type": "object"
-  },
-  {
-    "description": "tool-level failure, returned with isError: true",
-    "properties": {
-      "error": {
-        "additionalProperties": true,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "count": {
+        "type": "integer"
+      },
+      "currency": {
+        "type": "string"
+      },
+      "destinations": {
+        "items": {
+          "properties": {
+            "generated": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            },
+            "rails": {
+              "description": "one entry per rail; each carries its own `measured`, which is not the destination's",
+              "items": {
+                "properties": {
+                  "measured": {
+                    "properties": {
+                      "days": {
+                        "type": "integer"
+                      },
+                      "from": {
+                        "type": "string"
+                      },
+                      "to": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "days",
+                      "from",
+                      "to"
+                    ],
+                    "type": "object"
+                  },
+                  "party": {
+                    "properties": {
+                      "adults": {
+                        "type": "integer"
+                      },
+                      "children": {
+                        "type": "integer"
+                      }
+                    },
+                    "required": [
+                      "adults",
+                      "children"
+                    ],
+                    "type": "object"
+                  },
+                  "rail": {
+                    "enum": [
+                      "flight",
+                      "package"
+                    ],
+                    "type": "string"
+                  },
+                  "resort": {
+                    "type": "string"
+                  },
+                  "resort_key": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "rail",
+                  "party",
+                  "measured"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "slug": {
+              "type": "string"
+            },
+            "title": {
+              "properties": {
+                "cs": {
+                  "type": "string"
+                },
+                "en": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "cs",
+                "en"
+              ],
+              "type": "object"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "key",
+            "slug",
+            "title",
+            "url",
+            "generated",
+            "rails"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "disclaimer": {
+        "type": "string"
+      },
+      "license": {
+        "properties": {
+          "attribution": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "url",
+          "attribution"
+        ],
+        "type": "object"
+      },
+      "schema": {
+        "type": "string"
+      },
+      "stale_rails": {
+        "description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
+        "properties": {
+          "as_of": {
+            "type": "string"
+          },
+          "count": {
+            "type": "integer"
+          },
+          "keys": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "of": {
+            "type": "integer"
+          },
+          "unknown": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "as_of",
+          "of",
+          "count",
+          "keys"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "schema",
+      "currency",
+      "count",
+      "stale_rails",
+      "destinations",
+      "disclaimer"
+    ],
+    "type": "object"
+  },
+  {
+    "description": "tool-level failure, returned with isError: true",
+    "properties": {
+      "error": {
+        "additionalProperties": true,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  }
+]
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "anyOf": [
+    {
+      "properties": {
+        "count": {
+          "type": "integer"
+        },
+        "currency": {
+          "type": "string"
+        },
+        "destinations": {
+          "items": {
+            "properties": {
+              "generated": {
+                "type": "string"
+              },
+              "key": {
+                "type": "string"
+              },
+              "rails": {
+                "items": {
+                  "properties": {
+                    "measured": {
+                      "properties": {
+                        "days": {
+                          "type": "integer"
+                        },
+                        "from": {
+                          "type": "string"
+                        },
+                        "to": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "days",
+                        "from",
+                        "to"
+                      ],
+                      "type": "object"
+                    },
+                    "party": {
+                      "properties": {
+                        "adults": {
+                          "type": "integer"
+                        },
+                        "children": {
+                          "type": "integer"
+                        }
+                      },
+                      "required": [
+                        "adults",
+                        "children"
+                      ],
+                      "type": "object"
+                    },
+                    "rail": {
+                      "enum": [
+                        "flight",
+                        "package"
+                      ],
+                      "type": "string"
+                    },
+                    "resort": {
+                      "type": "string"
+                    },
+                    "resort_key": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "rail",
+                    "party",
+                    "measured"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "title": {
+                "properties": {
+                  "cs": {
+                    "type": "string"
+                  },
+                  "en": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "cs",
+                  "en"
+                ],
+                "type": "object"
+              },
+              "url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "key",
+              "slug",
+              "title",
+              "url",
+              "generated",
+              "rails"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "disclaimer": {
+          "type": "string"
+        },
+        "license": {
+          "properties": {
+            "attribution": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "id",
+            "url",
+            "attribution"
+          ],
+          "type": "object"
+        },
+        "schema": {
+          "type": "string"
+        },
+        "stale_rails": {
+          "description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
+          "properties": {
+            "as_of": {
+              "type": "string"
+            },
+            "count": {
+              "type": "integer"
+            },
+            "keys": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "of": {
+              "type": "integer"
+            },
+            "unknown": {
+              "type": "integer"
+            }
+          },
+          "required": [
+            "as_of",
+            "of",
+            "count",
+            "keys"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "schema",
+        "currency",
+        "count",
+        "stale_rails",
+        "destinations",
+        "disclaimer"
+      ],
+      "type": "object"
+    },
+    {
+      "description": "tool-level failure, returned with isError: true",
+      "properties": {
+        "error": {
+          "additionalProperties": true,
+          "properties": {
+            "code": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "error"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}
  4. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Annotations already cover the safety profile (readOnly, non-destructive, closed-world), yet the description layers on substantive behavior: per-rail measurement semantics, country/related cross-page structure, same_airport_as origins differences, the 'historical observations only' scope, and the explicit no-recommendation guardrail. It even tells the agent how to phrase an answer, which annotations cannot convey.

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?

Trigger conditions are front-loaded and every sentence carries distinct information, but it is delivered as one dense, unstructured paragraph mixing invocation guidance, output semantics, and response-authoring rules. A few line breaks or ordering cues would make the same content easier to scan.

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?

Even though an output schema exists, the description supplies the interpretive layer the schema cannot (rail-level granularity, related-page coverage, same_airport_as meaning, historical-only scope). For a parameterless reference tool with sibling analysis tools, nothing an agent needs to call and correctly report it is missing.

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

Parameters4/5

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

The tool takes zero parameters (schema coverage 100%), so per the scoring baseline this starts at 4. The description spends its detail on output fields (rails, measured days, span, country, related, same_airport_as) rather than inputs, which is appropriate but means no parameter semantics are added.

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 opens with a concrete verb+resource (list every destination with a published price series) and adds the distinguishing detail that history depth is per-rail, not per-destination. It also implicitly separates this enumeration/reference tool from the analysis-oriented siblings (price_history, compare_destinations) by framing itself as the place to resolve an unknown slug.

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?

It gives explicit trigger conditions ('use when the user asks which destinations are tracked', 'when another tool needs a slug you do not know') including sample user phrasings, and adds a pre-condition for authoring answers ('check `related` before saying something is not tracked'). This is well beyond implied usage.

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

All Voyscout Price History 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