Voyscout MCP
An official MCP server providing historical flight and package price data for Czech origins. It exposes tools to list destinations, retrieve price history, compare current prices against historical baselines, find opportunities, and compare destinations, serving public data without authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://voyscout.com/mcpWhat its tools do
5 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to voyscout.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Retrieve historical price trends for specific travel destinations
- Compare current flight or package prices against measured baselines
- Identify travel opportunities based on price history analysis
- List available destinations tracked by the service
Source and maintenance
Protocol and capabilities
- Server
- voyscout-price-series 1.0.0
- MCP protocol negotiated in check
- 2024-11-05
- Tools
- 5 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
5 advertised
list_destinations — List destinations
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.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"currency",
"count",
"stale_rails",
"destinations",
"disclaimer"
],
"properties": {
"count": {
"type": "integer"
},
"schema": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"currency": {
"type": "string"
},
"disclaimer": {
"type": "string"
},
"stale_rails": {
"type": "object",
"required": [
"as_of",
"of",
"count",
"keys"
],
"properties": {
"of": {
"type": "integer"
},
"keys": {
"type": "array",
"items": {
"type": "string"
}
},
"as_of": {
"type": "string"
},
"count": {
"type": "integer"
},
"unknown": {
"type": "integer"
}
},
"description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague)."
},
"destinations": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"slug",
"title",
"url",
"generated",
"related",
"rails"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"rails": {
"type": "array",
"items": {
"type": "object",
"required": [
"rail",
"party",
"measured"
],
"properties": {
"rail": {
"enum": [
"flight",
"package"
],
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"resort": {
"type": "string"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"days": {
"type": "integer"
},
"from": {
"type": "string"
}
}
},
"resort_key": {
"type": "string"
}
}
},
"description": "one entry per rail; each carries its own `measured`, which is not the destination's"
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"country": {
"type": "string",
"description": "the one country page this city belongs to, where the catalogue names exactly one"
},
"related": {
"type": "array",
"items": {
"type": "string"
},
"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"
},
"generated": {
"type": "string"
},
"same_airport_as": {
"type": "array",
"items": {
"type": "string"
},
"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"
}
}
}
}
}
},
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "tool-level failure, returned with isError: true"
}
]
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}price_history — Price history
Use when the user asks how the price of one destination developed over time ("jak se vyvíjela cena letenek do Egypta?", "price history for Egypt"). 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. Each rail's `searched.stay_nights` is the trip length its points price, and a destination's flight and package rails can differ - state it when citing a number. In `series_sample.points`, `origin` is the departure airport of that day's cheapest fare, not a price from that airport: points from different days do not compare airports, and the sample holds no per-airport price for any day. A rail without `resort` covers the whole destination, so after `resolved_from` cite it under the destination's name, not the resort's. `other_parties_in_country` names the related pages that publish a party this destination does not (e.g. a solo series on a city): cite it instead of saying that party is not tracked. 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.
{
"type": "object",
"required": [
"destination"
],
"properties": {
"rail": {
"enum": [
"flight",
"package"
],
"type": "string",
"description": "optional: restrict to one rail"
},
"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, and the destination's own published name in English or Czech (e.g. 'thailand', 'Řecko') resolves to that same page."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"destination",
"url",
"currency",
"license",
"related",
"rails",
"disclaimer"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string",
"description": "present when the `rail` filter matched nothing published for this destination"
},
"rails": {
"type": "array",
"items": {
"type": "object",
"required": [
"rail",
"party",
"price_covers",
"measured",
"stats",
"series_sample"
],
"properties": {
"rail": {
"enum": [
"flight",
"package"
],
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"basis": {
"type": "string"
},
"latest": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
}
}
},
"resort": {
"type": "string"
},
"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"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"days": {
"type": "integer"
},
"from": {
"type": "string"
}
}
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under, and `stay_nights` {from, to}: how long a trip each point prices - the flight and package rails of one destination can differ"
},
"resort_key": {
"type": "string"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
},
"series_sample": {
"type": "object",
"required": [
"complete",
"points"
],
"properties": {
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"cheapest_total"
],
"properties": {
"date": {
"type": "string"
},
"origin": {
"type": "string",
"description": "In `series_sample.points`, `origin` is the departure airport of that day's cheapest fare, not a price from that airport: points from different days do not compare airports, and the sample holds no per-airport price for any day."
},
"return": {
"type": "string"
},
"departure": {
"type": "string"
},
"cheapest_total": {
"type": "number"
}
}
}
},
"complete": {
"type": "boolean"
}
},
"description": "a DOWNSAMPLED sample; `complete` says whether it is the whole series"
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
}
}
}
},
"schema": {
"type": "string"
},
"country": {
"type": "string",
"description": "the one country page this city belongs to, where the catalogue names exactly one"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"related": {
"type": "array",
"items": {
"type": "string"
},
"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"
},
"currency": {
"type": "string"
},
"generated": {
"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"
}
}
}
}
},
"resolved_from": {
"type": "object",
"required": [
"asked",
"resort_key",
"resort"
],
"properties": {
"asked": {
"type": "string"
},
"resort": {
"type": [
"string",
"null"
]
},
"resort_key": {
"type": "string"
}
},
"description": "Present when the caller named a RESORT key; the answer is its parent destination."
},
"same_airport_as": {
"type": "array",
"items": {
"type": "string"
},
"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"
},
"other_parties_in_country": {
"type": "array",
"items": {
"type": "object",
"required": [
"party",
"destinations"
],
"properties": {
"party": {
"type": "string"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"description": "parties a `related` page publishes and this destination does not - e.g. a solo series on a city of this country"
}
}
},
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "tool-level failure, returned with isError: true"
}
]
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}current_vs_history — Current price vs. history
Use when the user asks whether today's price for one destination is low or high against its own history ("je teď Egypt levný?", "is Egypt cheap right now?"). 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. A rail without `resort` covers the whole destination, so after `resolved_from` cite it under the destination's name, not the resort's. `other_parties_in_country` names the related pages that publish a party this destination does not (e.g. a solo series on a city): cite it instead of saying that party is not tracked. 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.
{
"type": "object",
"required": [
"destination"
],
"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, and the destination's own published name in English or Czech (e.g. 'thailand', 'Řecko') resolves to that same page."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"destination",
"url",
"currency",
"license",
"related",
"rails",
"disclaimer"
],
"properties": {
"url": {
"type": "string"
},
"rails": {
"type": "array",
"items": {
"type": "object",
"required": [
"rail",
"party",
"price_covers",
"measured",
"stats"
],
"properties": {
"rail": {
"enum": [
"flight",
"package"
],
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"basis": {
"type": "string"
},
"latest": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
}
}
},
"resort": {
"type": "string"
},
"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"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"days": {
"type": "integer"
},
"from": {
"type": "string"
}
}
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under, and `stay_nights` {from, to}: how long a trip each point prices - the flight and package rails of one destination can differ"
},
"resort_key": {
"type": "string"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
}
}
}
},
"schema": {
"type": "string"
},
"country": {
"type": "string",
"description": "the one country page this city belongs to, where the catalogue names exactly one"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"related": {
"type": "array",
"items": {
"type": "string"
},
"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"
},
"currency": {
"type": "string"
},
"generated": {
"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"
}
}
}
}
},
"resolved_from": {
"type": "object",
"required": [
"asked",
"resort_key",
"resort"
],
"properties": {
"asked": {
"type": "string"
},
"resort": {
"type": [
"string",
"null"
]
},
"resort_key": {
"type": "string"
}
},
"description": "Present when the caller named a RESORT key; the answer is its parent destination."
},
"same_airport_as": {
"type": "array",
"items": {
"type": "string"
},
"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"
},
"other_parties_in_country": {
"type": "array",
"items": {
"type": "object",
"required": [
"party",
"destinations"
],
"properties": {
"party": {
"type": "string"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"description": "parties a `related` page publishes and this destination does not - e.g. a solo series on a city of this country"
}
}
},
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "tool-level failure, returned with isError: true"
}
]
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}find_opportunities — Find opportunities
Use when the user asks where it is unusually cheap right now without naming a destination ("kde je teď levně?", "where is it cheap right now?"). 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. Each row is ONE rail, so a destination with several rails can appear once per rail with different numbers: name the rail when you cite a row. Read `searched` before interpreting a price: it is the TRIP the series was collected for (the search mode, and the fixed travel dates where there are any - a Christmas series is not the price of a summer trip), while `measured` is when we observed it; `price_covers` says what the money buys and `origins` the departure-airport cluster. 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. 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.
{
"type": "object",
"properties": {
"rail": {
"enum": [
"flight",
"package"
],
"type": "string",
"description": "optional: restrict to one rail"
},
"sort": {
"enum": [
"cheapest_vs_history",
"most_below_median"
],
"type": "string",
"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"
},
"limit": {
"type": "integer",
"minimum": 0,
"description": "optional (default 10): how many rows to return; 'matched' reports the count before the cap"
},
"party": {
"type": "string",
"pattern": "^(0|[1-9]\\d*)-(0|[1-9]\\d*)$",
"description": "optional: '<adults>-<children>', e.g. '2-2' - the same A-C shape the price streams are keyed on. A well-formed party no rail carries returns `no_coverage` with the parties that exist"
},
"min_history_days": {
"type": "integer",
"minimum": 0,
"description": "optional (default 30): rails measured for fewer days are listed under 'excluded'"
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"sort",
"min_history_days",
"matched",
"stale_rails",
"opportunities",
"excluded",
"disclaimer"
],
"properties": {
"sort": {
"enum": [
"cheapest_vs_history",
"most_below_median"
],
"type": "string"
},
"schema": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"matched": {
"type": "integer",
"description": "rows before the `limit` cap"
},
"currency": {
"type": "string"
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"rail",
"reason",
"history_days"
],
"properties": {
"rail": {
"enum": [
"flight",
"package"
],
"type": "string"
},
"reason": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"destination": {
"type": "string"
},
"history_days": {
"type": "integer"
}
}
}
},
"generated": {
"type": [
"string",
"null"
],
"description": "the OLDEST `generated` among the rows returned"
},
"disclaimer": {
"type": "string"
},
"no_coverage": {
"type": "object",
"required": [
"party",
"rail",
"available_parties",
"message"
],
"properties": {
"rail": {
"type": "string"
},
"party": {
"type": "string"
},
"message": {
"type": "string"
},
"available_parties": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "present only when NO published rail carries the requested party: a coverage limit, distinct from an empty ranking"
},
"stale_rails": {
"type": "object",
"required": [
"as_of",
"of",
"count",
"keys"
],
"properties": {
"of": {
"type": "integer"
},
"keys": {
"type": "array",
"items": {
"type": "string"
}
},
"as_of": {
"type": "string"
},
"count": {
"type": "integer"
},
"unknown": {
"type": "integer"
}
},
"description": "How many of the rails in scope are past their own freshness boundary on `as_of` (Europe/Prague)."
},
"opportunities": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"title",
"url",
"rail",
"party",
"price_covers",
"measured",
"stats",
"latest",
"median",
"min",
"cheaper_than_pct",
"latest_cheaper_than_pct_of_days",
"is_series_min",
"history_days",
"measured",
"generated"
],
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string"
},
"rail": {
"enum": [
"flight",
"package"
],
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"basis": {
"type": "string"
},
"latest": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"latest": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"resort": {
"type": "string"
},
"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"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"days": {
"type": "integer"
},
"from": {
"type": "string"
}
}
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under, and `stay_nights` {from, to}: how long a trip each point prices - the flight and package rails of one destination can differ"
},
"generated": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"destination": {
"type": "string"
},
"history_days": {
"type": "integer"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"is_series_min": {
"type": "boolean"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
},
"latest_cheaper_than_pct_of_days": {
"type": [
"number",
"null"
]
}
}
}
},
"min_history_days": {
"type": "integer"
}
}
},
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "tool-level failure, returned with isError: true"
}
]
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}compare_destinations — Compare destinations
Use when the user names two or more destinations and wants their prices side by side ("porovnej Egypt a Maltu", "compare Malta and Madeira"). 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, and with `available_in_country` when a page of the same country does publish that party. A flight row and a package row can price DIFFERENT trip lengths (`searched.stay_nights`, e.g. 28-31-night flights beside the cheapest 5-14-night package): `stay_comparison` says so per destination - say the lengths when you put the two side by side, and never present the gap as the price of accommodation. 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.
{
"type": "object",
"required": [
"destinations"
],
"properties": {
"rail": {
"enum": [
"flight",
"package",
"both"
],
"type": "string",
"description": "optional (default both): restrict to one rail"
},
"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. A well-formed party no rail carries returns `no_coverage` with the parties that exist"
},
"destinations": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 8,
"minItems": 2,
"description": "2-8 destination slugs, or each destination's own published name in English or Czech (e.g. 'turkey', 'Bulharsko'); resort keys are not accepted here; the answer keeps this order"
},
"min_history_days": {
"type": "integer",
"minimum": 0,
"description": "optional (default 30): rails measured for fewer days are listed under 'excluded'"
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"schema",
"generated",
"party",
"rail",
"min_history_days",
"comparison_rows",
"comparison",
"excluded",
"disclaimer"
],
"properties": {
"rail": {
"enum": [
"flight",
"package",
"both"
],
"type": "string"
},
"party": {
"type": "string"
},
"schema": {
"type": "string"
},
"license": {
"type": "object",
"required": [
"id",
"url",
"attribution"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"attribution": {
"type": "string"
}
}
},
"currency": {
"type": "string"
},
"excluded": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"reason"
],
"properties": {
"rail": {
"enum": [
"flight",
"package",
"both"
],
"type": "string"
},
"party": {
"type": "string"
},
"reason": {
"type": "string"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"days": {
"type": "integer"
},
"from": {
"type": "string"
}
}
},
"generated": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"destination": {
"type": "string"
},
"available_parties": {
"type": "array",
"items": {
"type": "string"
},
"description": "on `no_rail_for_selection`: the parties this destination does publish for the rail asked"
},
"available_in_country": {
"type": "array",
"items": {
"type": "string"
},
"description": "on `no_rail_for_selection`: pages in the same country that do publish the party asked"
}
}
}
},
"generated": {
"type": [
"string",
"null"
],
"description": "the OLDEST `generated` among the rows and dated exclusions"
},
"comparison": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"title",
"url",
"generated",
"rail",
"party",
"price_covers",
"measured",
"stats"
],
"properties": {
"url": {
"type": "string"
},
"rail": {
"enum": [
"flight",
"package"
],
"type": "string"
},
"party": {
"type": "object",
"required": [
"adults",
"children"
],
"properties": {
"adults": {
"type": "integer"
},
"children": {
"type": "integer"
}
}
},
"stats": {
"type": "object",
"required": [
"basis"
],
"properties": {
"min": {
"type": [
"number",
"null"
]
},
"basis": {
"type": "string"
},
"latest": {
"type": [
"number",
"null"
]
},
"median": {
"type": [
"number",
"null"
]
},
"is_series_max": {
"type": "boolean"
},
"is_series_min": {
"type": "boolean"
},
"cheaper_than_pct": {
"type": [
"number",
"null"
]
}
}
},
"title": {
"type": "object",
"required": [
"cs",
"en"
],
"properties": {
"cs": {
"type": "string"
},
"en": {
"type": "string"
}
}
},
"resort": {
"type": "string"
},
"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"
},
"measured": {
"type": "object",
"required": [
"days",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"days": {
"type": "integer"
},
"from": {
"type": "string"
}
}
},
"searched": {
"type": "object",
"description": "the search mode (and fixed dates, where there are any) the series was collected under, and `stay_nights` {from, to}: how long a trip each point prices - the flight and package rails of one destination can differ"
},
"generated": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"destination": {
"type": "string"
},
"price_covers": {
"type": "object",
"description": "what the money buys - airfare only, or a package as offered"
},
"regime_breaks": {
"type": "array",
"description": "[from, to] date spans where the series was not comparable"
},
"latest_stale_after_days": {
"type": "number",
"description": "this rail's own freshness boundary, in days after measured.to"
}
}
}
},
"disclaimer": {
"type": "string"
},
"no_coverage": {
"type": "object",
"required": [
"party",
"rail",
"available_parties",
"message"
],
"properties": {
"rail": {
"type": "string"
},
"party": {
"type": "string"
},
"message": {
"type": "string"
},
"available_parties": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "present only when NO published rail carries the requested party: a coverage limit, distinct from an empty ranking"
},
"comparison_rows": {
"type": "integer",
"description": "rows, not destinations - a dual-rail destination contributes two"
},
"stay_comparison": {
"type": "array",
"items": {
"type": "object",
"required": [
"destination",
"flight_stay_nights",
"package_stay_nights",
"stay_comparable"
],
"properties": {
"note": {
"type": "string"
},
"resort_key": {
"type": "string"
},
"destination": {
"type": "string"
},
"stay_comparable": {
"type": "boolean"
},
"flight_stay_nights": {
"type": "object"
},
"package_stay_nights": {
"type": "object"
}
}
},
"description": "per destination with both a flight and a package row: the trip length each series prices, and whether the two ranges overlap (`stay_comparable`); a `note` when they do not"
},
"min_history_days": {
"type": "integer"
}
}
},
{
"type": "object",
"required": [
"error"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "tool-level failure, returned with isError: true"
}
]
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 509 ms
- 95th percentile latency
- 509 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 509 ms · metadata changed · 5 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http voyscout-mcp https://voyscout.com/mcpCodex
codex mcp add voyscout-mcp --url https://voyscout.com/mcpCursor
{
"mcpServers": {
"voyscout-mcp": {
"url": "https://voyscout.com/mcp"
}
}
}Cline
{
"mcpServers": {
"voyscout-mcp": {
"type": "streamableHttp",
"url": "https://voyscout.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"voyscout-mcp": {
"type": "http",
"url": "https://voyscout.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http voyscout-mcp https://voyscout.com/mcpClaude Desktop
https://voyscout.com/mcpWindsurf
{
"mcpServers": {
"voyscout-mcp": {
"serverUrl": "https://voyscout.com/mcp"
}
}
}Let your agent find its tools
Find servers like Voyscout MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Voyscout MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.