whentofly

whentofly — AI エージェント向けフライト検索（MCP）

whentofly.io は、AI エージェントが直接利用できる、日付に柔軟性のあるフライト検索サービスです。エージェントに 「シンガポール発東京行き、10月、5～9日間の最安往復便」 と尋ねると、期間全体を検索し、予約リンク付きで実際の最安運賃を返し、その価格が通常の価格帯のどこに位置するかも教えてくれます。

API キー不要。登録不要。リモートホスト型の 2 つのツールを利用するため、ローカルで実行するものはありません。

インストール

Claude Code

claude mcp add whentofly https://whentofly.io/mcp?ch=github

Claude Desktop / claude.ai — Settings → Connectors → Add custom connector → https://whentofly.io/mcp?ch=github

Cursor — mcp.json に追加します：

{
  "mcpServers": {
    "whentofly": { "url": "https://whentofly.io/mcp?ch=github" }
  }
}

リモート（ストリーミング可能な HTTP）に対応するその他の MCP クライアント：接続先に https://whentofly.io/mcp を指定します。

ChatGPT — whentofly Custom GPT をご利用ください（現時点では、MCP コネクターは Claude／Cursor 側でのみ利用できます）。

ツールの機能

search_locations — 地名を正確な識別子に変換

search_flights にそのまま渡せる型付きの値を返します。

• city:SHA — 上海市場にあるすべての空港
• airport:SHA — 浦東ではなく、虹橋空港を指定

IATA コードの多くは空港と都市圏の両方を指します。SHA もその一つです。そのため、複数の検索結果が妥当と思われる場合、エージェントはどちらを意味しているのか尋ねる必要があります。検索カタログには 3,614 の空港と 3,465 の都市が登録されているため、小規模な地方空港も特定できます。

コードがわかっている場合は、そのまま指定してください。このツールは、なじみのない地名や、都市と空港を区別する必要がある場合に使います。

search_flights — 日程に柔軟性のある期間内の最安往復便

月または日付範囲と、旅行期間の最小値／最大値（「10月に5～9日間」など）を指定すると、条件に合う出発日と帰着日の全組み合わせを検索し、価格順に並べます。すべての運賃に予約リンクが付き、航空会社名も特定されます。

目的地を省略するか、「どこでも」と指定すると、出発地から行ける最安の目的地を返します。「9月にベルリンから最安で行ける場所はどこ？」

各運賃には、価格レベルとして お得、通常、高め、または路線に利用可能な価格帯データがない場合は データ不足 も表示されます。これは、今日の価格が路線の通常の価格帯のどこに位置するかを示します。運賃がどちらの方向に動いているかは示さず、待つよう勧めることもありません。

プロンプトの例

• 「10月のシンガポール発東京行き、5～9日間の最安往復便を探してください。」
• 「9月にベルリンから1週間で最安で行ける場所はどこですか？」
• 「11月のニューヨーク発リスボン行きで450ドルは高いですか？日程に柔軟性を持たせて調べてください。」
• 「今後3か月以内で、日本への10～14日間の旅行を最安で計画してください。」
• 「張家界発のフライトを探してください。まず空港を特定してください。」

現時点で対応していないこと

プレミアムクラスの航空券は予約できません。cabin=business または first を指定すると、metadata.route_price_check に路線単位の価格情報が表示される場合がありますが、予約リンク付きで価格順に並べた運賃は表示されません。予約可能な運賃の情報源はエコノミークラスのみを扱っています。別の場所のビジネスクラス運賃を、別の場所へ移動するリンクとともに表示することもできますが、そのリンクでは適用されない価格を示すより、何も表示しないほうがよいと考えています。

価格はキャッシュされた参考情報です。すべての応答には metadata.freshness が含まれるため、エージェントは運賃情報がどの程度古いかを確認できます。最終価格は予約ページでご確認ください。

料金と運営資金

お客様のために順位付けし、当社のためには順位付けしません。 結果は、販売元が当社に報酬を支払うかどうかにかかわらず、見つかった実際の最安価格順に並びます。販売元が料金を支払って上位に表示されることはありません。

無料で利用でき、キーも不要です。予約リンクの一部はアフィリエイトリンクです。そのリンクから予約すると、提携先から当社に手数料が支払われる場合がありますが、運賃に上乗せされることはありません。各検索結果にはそれぞれの収益化情報が表示されるため、エージェントはその違いを把握できます。運賃はキャッシュされた航空券データに基づいているため、最終価格は必ず予約ページでご確認ください。

開発者向け

同じ検索機能をプレーンな JSON API（https://whentofly.io/search （ドキュメント））でも利用できます。また、場所の解決には https://whentofly.io/locations?q=Shanghai を利用できます。このリポジトリでは、ホステッド MCP サーバーのドキュメントを公開しています。サービス自体はクローズドソースです。

ご質問・フィードバック：[email protected] または、こちらで issue を作成してください。