# io.github.dimabalony/whentofly (remote · whentofly.io)

whentofly: flight search for AI agents — cheapest flexible-date round-trips + buy/wait verdict

- Trust score: 67/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `whentofly.io`: 67/100 (this document), [markdown](https://verifymcp.io/servers/dimabalony-whentofly/whentofly.md), [page](https://verifymcp.io/servers/dimabalony-whentofly/whentofly)

## Channel facts

- Endpoint: `https://whentofly.io/mcp?ch=mcp-registry`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 42/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1072 tokens (~536/item across 2 items; 2 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 93% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http dimabalony-whentofly https://whentofly.io/mcp?ch=mcp-registry
```

### Codex

```toml
[mcp_servers.dimabalony-whentofly]
url = "https://whentofly.io/mcp?ch=mcp-registry"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dimabalony-whentofly": {
      "type": "remote",
      "url": "https://whentofly.io/mcp?ch=mcp-registry",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dimabalony-whentofly --url https://whentofly.io/mcp?ch=mcp-registry --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  dimabalony-whentofly:
    url: "https://whentofly.io/mcp?ch=mcp-registry"
```

### Other

```json
{
  "mcpServers": {
    "dimabalony-whentofly": {
      "type": "http",
      "url": "https://whentofly.io/mcp?ch=mcp-registry"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 67, +4)

- [security] Tool “search_flights” rewrote its description, which is the text the model reads
- [functional regression] Tool coverage: 100% → 93%
- [functional improvement] Schema quality: 936 → 536
- [functional] Schema quality: fair → good
- [functional] New tool “search_locations”
- [cosmetic] “search_flights” reworded the description of “from”
- [cosmetic] “search_flights” reworded the description of “to”

### 2026-08-01 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 62, +4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 58, −6)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 63, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 62)

First indexed and scored.

## MCP tools (2)

### `search_locations` (~88 tokens)

Resolve a city or airport name or code before searching flights. Returns typed values such as city:SHA to search every catalog airport in Shanghai or airport:SHA for Hongqiao only. Pass the selected value unchanged to search_flights. Ask the traveler when multiple results are plausible.

Input parameters:

- `limit` (integer)
- `q` (string, required): Airport/city name or 3-letter code prefix.

### `search_flights` (~984 tokens)

Find the cheapest round-trip across a FLEXIBLE multi-month date window with a min/max trip length — e.g. "10–15 days, anytime Sep–Nov". Search a broad date window rather than requiring the traveler to choose exact dates first. First call the search_locations MCP tool for city or airport names, then pass each returned airport:AAA or city:AAA value unchanged as origin/destination (explicit legacy IATA codes remain supported). Add an earliest/latest date window and min/max trip duration; get back a ranked list of the cheapest fares (with booking links) plus a price verdict — an honest read of whether the cheapest fare is low, typical, or high versus the route's usual price, or unknown when we lack a usable typical-price band (a price-level read, not a buy-now-or-wait timing prediction). Non-economy requests may return representative Google Flights route-price evidence in metadata.route_price_check, but that evidence stays outside ranked results until it carries an exact seller booking action. Use it for any flight question where the dates are flexible or the user wants the cheapest time to fly. If metadata.refresh_hint is present, you may repeat the same call after the suggested delay to inspect a separate same-route/date/cabin price check. If you can wait longer for that best-effort cross-check, set verify=full. It uses a longer ~35s budget, but never treats a different airline, itinerary, gate, or booking URL as verification of the displayed offer. Provider failure, unavailability, or a spend cap can still return only cached indicators; always inspect metadata.freshness and metadata.route_price_check.

Input parameters:

- `cabin` (string): Cabin class: economy (default), premium_economy, business, or first. The bookable Travelpayouts calendar currently covers economy only. For a non-economy request, Google Flights may return representa…
- `ch` (string): Acquisition channel tag (e.g. web, mcp, a campaign name). Encoded with the route into the affiliate link's sub_id so a future commission can be attributed to this channel in the Travelpayouts dashboa…
- `currency` (string): Result currency, 3-letter ISO code UPPERCASE.
- `earliest` (string): Earliest acceptable departure date (ISO YYYY-MM-DD). Required for a specific route; ignored in anywhere mode.
- `from` (string, required): Origin location. Use a legacy 3-letter code (SHA), an exact airport (airport:SHA), or an all-airports city (city:SHA). Required for every search, including to=anywhere.
- `latest` (string): Latest acceptable return date for round-trip, or latest acceptable departure for one-way (ISO YYYY-MM-DD). Window from earliest must be ≤365 days. Required for a specific route; ignored in anywhere m…
- `max_days` (integer): Maximum round-trip duration in days (return - departure); ignored for one-way and anywhere mode.
- `max_transfers` (integer): Maximum number of transfers/layovers per leg. 0 = nonstop only, 1 = up to 1 stop, etc. Omit for no filter.
- `min_days` (integer): Minimum round-trip duration in days (return - departure); ignored for one-way and anywhere mode.
- `one_way` (boolean): If true, search one-way flights; return_date and duration_days will be null.
- `to` (string): Destination location: a legacy code, airport:AAA, or city:AAA. Pass `anywhere` (or omit) to get the cheapest destinations from the origin instead of a specific route.
- `top_n` (integer): Maximum number of results to return, sorted cheapest-first. Specific routes allow up to 50; anywhere mode returns at most 12.
- `verify` (string): How hard to cross-check the top result's route, dates, and cabin against Google Flights (SerpApi). `false` (default): the check still runs automatically on a fresh search when the top isn't already a…

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/dimabalony-whentofly/whentofly#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 63
- 2026-08-01: 63
- 2026-07-31: 62
- 2026-07-30: 58
- 2026-07-29: 64
- 2026-07-28: 64
- 2026-07-27: 63
- 2026-07-26: 62

## Links

- Remote endpoint: https://whentofly.io/mcp?ch=mcp-registry
- Repository: https://github.com/dimabalony/whentofly-mcp
- Website: https://whentofly.io/
- Changelog RSS feed: https://verifymcp.io/servers/dimabalony-whentofly/whentofly/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/dimabalony-whentofly/whentofly/changelog.json
- HTML version of this page: https://verifymcp.io/servers/dimabalony-whentofly/whentofly