Voyscout Price History
Historical flight and package price series for Czech origins. Honest stats, no verdicts. CC BY 4.0
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"price-history": {
"url": "https://voyscout.com/mcp"
}
}
}Remote-Endpunkte
https://voyscout.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (5)
🟢list_destinations
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. Historical observations only.
Eingabe-Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"currency",
"count",
"stale_rails",
"destinations",
"disclaimer"
],
"properties": {
"schema": {
"type": "string"
},
"currency": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"count": {
"type": "integer"
},
"stale_rails": {
"type": "object",
"description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
"required": [
"as_of",
"of",
"count",
"keys"
],
"properties": {
"as_of": {
"type": "string"
},
"of": {
"type": "integer"
},
"count": {
"type": "integer"
},
"unknown": {
"type": "integer"
},
"keys": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"destinations": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"slug",
"title",
"url",
"generated",
"rails"
],
"properties": {
"key": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"url": {
"type": "string"
},
"generated": {
"type": "string"
},
"rails": {
"type": "array",
"items": {
"type": "object",
"required": [
"rail",
"party",
"measured"
],
"properties": {
"rail": {
"type": "string",
"enum": [
"flight",
"package"
]
},
"resort": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"days": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
}
}
}
}
}
}
},
"disclaimer": {
"type": "string"
}
}
},
{
"type": "object",
"description": "tool-level failure, returned with isError: true",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
}
}
]
}🟢price_history(destination, rail)
Price series for one destination: measured span, stats, a downsampled sample of points and any regime breaks. Historical observations only, never a live quote or a recommendation.
Eingabe-Schema
{
"type": "object",
"properties": {
"destination": {
"type": "string",
"description": "destination slug, as returned by list_destinations. A RESORT key read off a rail (e.g. 'hurghada') also resolves, to its parent destination, and the answer then carries `resolved_from`; underscores and hyphens are interchangeable."
},
"rail": {
"type": "string",
"enum": [
"flight",
"package"
],
"description": "optional: restrict to one rail"
}
},
"required": [
"destination"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"destination",
"url",
"currency",
"license",
"rails",
"disclaimer"
],
"properties": {
"schema": {
"type": "string"
},
"generated": {
"type": "string"
},
"currency": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"disclaimer": {
"type": "string"
},
"destination": {
"type": "object",
"required": [
"key",
"slug",
"title"
],
"properties": {
"key": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"url": {
"type": "string"
},
"resolved_from": {
"type": "object",
"description": "Present when the caller named a RESORT key; the answer is its parent destination.",
"required": [
"asked",
"resort_key",
"resort"
],
"properties": {
"asked": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"resort": {
"type": [
"string",
"null"
]
}
}
},
"rails": {
"type": "array",
"items": {
"type": "object",
"required": [
"rail",
"party",
"price_covers",
"measured",
"stats",
"series_sample"
],
"properties": {
"rail": {
"type": "string",
"enum": [
"flight",
"package"
]
},
"resort": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"origins": {
"type": "object",
"description": "departure-airport CLUSTER; covers_all_published_prices is false"
},
"arrivals": {
"type": "object",
"description": "arrival airports RECORDED; covers_all_published_prices is false"
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"days": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"basis": {
"type": "string"
},
"min": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"latest": {
"type": [
"number",
"null"
]
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
}
}
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
},
"series_sample": {
"type": "object",
"description": "a DOWNSAMPLED sample; `complete` says whether it is the whole series",
"required": [
"complete",
"points"
],
"properties": {
"complete": {
"type": "boolean"
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"cheapest_total"
],
"properties": {
"date": {
"type": "string"
},
"cheapest_total": {
"type": "number"
},
"origin": {
"type": "string"
},
"departure": {
"type": "string"
},
"return": {
"type": "string"
}
}
}
}
}
}
}
}
},
"note": {
"type": "string",
"description": "present when the `rail` filter matched nothing published for this destination"
}
}
},
{
"type": "object",
"description": "tool-level failure, returned with isError: true",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
}
}
]
}🟢current_vs_history(destination)
Stats for one destination (min, median, and what share of the TRACKED DAYS were dearer than the last measurement) without the sample points. Percentages are over observed days, not over the calendar span. Descriptive only: it does not say whether to buy.
Eingabe-Schema
{
"type": "object",
"properties": {
"destination": {
"type": "string",
"description": "destination slug, as returned by list_destinations. A RESORT key read off a rail (e.g. 'hurghada') also resolves, to its parent destination, and the answer then carries `resolved_from`; underscores and hyphens are interchangeable."
}
},
"required": [
"destination"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"destination",
"url",
"currency",
"license",
"rails",
"disclaimer"
],
"properties": {
"schema": {
"type": "string"
},
"generated": {
"type": "string"
},
"currency": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"disclaimer": {
"type": "string"
},
"destination": {
"type": "object",
"required": [
"key",
"slug",
"title"
],
"properties": {
"key": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
}
}
},
"url": {
"type": "string"
},
"resolved_from": {
"type": "object",
"description": "Present when the caller named a RESORT key; the answer is its parent destination.",
"required": [
"asked",
"resort_key",
"resort"
],
"properties": {
"asked": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"resort": {
"type": [
"string",
"null"
]
}
}
},
"rails": {
"type": "array",
"items": {
"type": "object",
"required": [
"rail",
"party",
"price_covers",
"measured",
"stats"
],
"properties": {
"rail": {
"type": "string",
"enum": [
"flight",
"package"
]
},
"resort": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"origins": {
"type": "object",
"description": "departure-airport CLUSTER; covers_all_published_prices is false"
},
"arrivals": {
"type": "object",
"description": "arrival airports RECORDED; covers_all_published_prices is false"
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"days": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"basis": {
"type": "string"
},
"min": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"latest": {
"type": [
"number",
"null"
]
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
}
}
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
}
}
}
}
}
},
{
"type": "object",
"description": "tool-level failure, returned with isError: true",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
}
}
]
}🟢find_opportunities(rail, party, min_history_days, limit, sort)
Rank every published rail by how its LAST measurement compares with its own tracked history, so a caller can ask 'where is it unusually cheap right now?' in one call instead of one call per destination. Percentages are over observed days, not the calendar span. `latest_cheaper_than_pct_of_days` is the same number as `cheaper_than_pct` under a name that states its direction (higher = cheaper than more of the tracked days). `stale_rails` says how many of the rails THIS call matched are past their own freshness boundary today, with the day it was judged (`as_of`), so the caller need not subtract dates per row. Descriptive only: it ranks observations and gives no verdict. Rails with too little history are returned under `excluded`, never dropped silently.
Eingabe-Schema
{
"type": "object",
"properties": {
"rail": {
"type": "string",
"enum": [
"flight",
"package"
],
"description": "optional: restrict to one rail"
},
"party": {
"type": "string",
"description": "optional: '<adults>-<children>', e.g. '2-2' - the same A-C shape the price streams are keyed on"
},
"min_history_days": {
"type": "integer",
"minimum": 0,
"description": "optional (default 30): rails measured for fewer days are listed under 'excluded'"
},
"limit": {
"type": "integer",
"minimum": 0,
"description": "optional (default 10): how many rows to return; 'matched' reports the count before the cap"
},
"sort": {
"type": "string",
"enum": [
"cheapest_vs_history",
"most_below_median"
],
"description": "optional (default cheapest_vs_history): 'cheapest_vs_history' ranks by the share of tracked days that were dearer; 'most_below_median' ranks by how far the last measurement sits below the median, relatively"
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"sort",
"min_history_days",
"matched",
"stale_rails",
"opportunities",
"excluded",
"disclaimer"
],
"properties": {
"schema": {
"type": "string"
},
"generated": {
"type": [
"string",
"null"
],
"description": "the OLDEST `generated` among the rows returned"
},
"currency": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"disclaimer": {
"type": "string"
},
"sort": {
"type": "string",
"enum": [
"cheapest_vs_history",
"most_below_median"
]
},
"min_history_days": {
"type": "integer"
},
"matched": {
"type": "integer",
"description": "rows before the `limit` cap"
},
"stale_rails": {
"type": "object",
"description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague).",
"required": [
"as_of",
"of",
"count",
"keys"
],
"properties": {
"as_of": {
"type": "string"
},
"of": {
"type": "integer"
},
"count": {
"type": "integer"
},
"unknown": {
"type": "integer"
},
"keys": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"opportunities": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"title",
"url",
"rail",
"party",
"latest",
"median",
"min",
"cheaper_than_pct",
"latest_cheaper_than_pct_of_days",
"is_series_min",
"history_days",
"measured",
"generated"
],
"properties": {
"destination": {
"type": "string"
},
"rail": {
"type": "string",
"enum": [
"flight",
"package"
]
},
"resort_key": {
"type": "string"
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"url": {
"type": "string"
},
"resort": {
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"latest": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"min": {
"type": [
"number",
"null"
]
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
},
"latest_cheaper_than_pct_of_days": {
"type": [
"number",
"null"
]
},
"is_series_min": {
"type": "boolean"
},
"history_days": {
"type": "integer"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"days": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
},
"latest_stale_after_days": {
"type": "number"
},
"generated": {
"type": "string"
}
}
}
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"rail",
"reason",
"history_days"
],
"properties": {
"destination": {
"type": "string"
},
"rail": {
"type": "string",
"enum": [
"flight",
"package"
]
},
"resort_key": {
"type": "string"
},
"reason": {
"type": "string"
},
"history_days": {
"type": "integer"
}
}
}
}
}
},
{
"type": "object",
"description": "tool-level failure, returned with isError: true",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
}
}
]
}🟢compare_destinations(destinations, party, rail, min_history_days)
Put 2-8 named destinations side by side on the same snapshot, each with the stats current_vs_history reports (last measurement, median, min, share of TRACKED DAYS that were dearer). Numbers are for the WHOLE party, not per person, and percentages are over observed days rather than the calendar span. Rows come back in the order you asked for - it does not rank, and gives no verdict; use find_opportunities to rank. A destination that yields no row is returned under `excluded` with the reason.
Eingabe-Schema
{
"type": "object",
"properties": {
"destinations": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"maxItems": 8,
"description": "2-8 destination slugs; the answer keeps this order"
},
"party": {
"type": "string",
"pattern": "^(0|[1-9]\\d*)-(0|[1-9]\\d*)$",
"description": "optional (default '2-2'): '<adults>-<children>', the same A-C shape the price streams are keyed on"
},
"rail": {
"type": "string",
"enum": [
"flight",
"package",
"both"
],
"description": "optional (default both): restrict to one rail"
},
"min_history_days": {
"type": "integer",
"minimum": 0,
"description": "optional (default 30): rails measured for fewer days are listed under 'excluded'"
}
},
"required": [
"destinations"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"party",
"rail",
"min_history_days",
"comparison_rows",
"comparison",
"excluded",
"disclaimer"
],
"properties": {
"schema": {
"type": "string"
},
"generated": {
"type": [
"string",
"null"
],
"description": "the OLDEST `generated` among the rows and dated exclusions"
},
"currency": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"disclaimer": {
"type": "string"
},
"party": {
"type": "string"
},
"rail": {
"type": "string",
"enum": [
"flight",
"package",
"both"
]
},
"min_history_days": {
"type": "integer"
},
"comparison_rows": {
"type": "integer",
"description": "rows, not destinations - a dual-rail destination contributes two"
},
"comparison": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"title",
"url",
"generated",
"rail",
"party",
"price_covers",
"measured",
"stats"
],
"properties": {
"destination": {
"type": "string"
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"url": {
"type": "string"
},
"generated": {
"type": "string"
},
"rail": {
"type": "string",
"enum": [
"flight",
"package"
]
},
"resort": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"origins": {
"type": "object",
"description": "departure-airport CLUSTER; covers_all_published_prices is false"
},
"arrivals": {
"type": "object",
"description": "arrival airports RECORDED; covers_all_published_prices is false"
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"days": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"basis": {
"type": "string"
},
"min": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"latest": {
"type": [
"number",
"null"
]
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
}
}
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
}
}
}
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"reason"
],
"properties": {
"destination": {
"type": "string"
},
"reason": {
"type": "string"
},
"rail": {
"type": "string",
"enum": [
"flight",
"package",
"both"
]
},
"resort_key": {
"type": "string"
},
"party": {
"type": "string"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"days": {
"type": "integer"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
}
},
"generated": {
"type": "string"
}
}
}
}
}
},
{
"type": "object",
"description": "tool-level failure, returned with isError: true",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
}
}
]
}Community
Nachweis