Flytoday

flytoday-mcp：AI エージェント向け Flytoday MCP サーバー

AI エージェントで、イラン国内外の Flytoday（فلای‌تودی）旅行を計画できます。
イランのオンライン旅行会社、Flytoday 向けの非公式な読み取り専用 MCP サーバーです。
Claude、Cursor、Copilot から、最安の国内線・国際線、列車・バス、運賃規則・手荷物、正確な料金がわかるホテル・ヴィラに加え、CIP ラウンジ、eSIM、ビザを確認できます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 知っておくと便利なこと · FAQ · 設定 · فارسی · 開発

AI エージェント向け

• 概要： Flytoday（فلای‌تودی、flytoday.ir）向けの非公式・読み取り専用 MCP サーバー（Model Context Protocol）です。対象は、イラン国内線・国際線、イラン国内外のホテル、ヴィラやアパートメント、列車、バス、CIP ラウンジ、eSIM、ビザ、アクティビティです。ペルシャ語と英語で検索でき、料金はトマン建てです。
• インストール： uvx flytoday-mcp または claude mcp add flytoday -- uvx flytoday-mcp。トランスポートは stdio です。Python 3.10 以降と uv が必要です。
• 認証： 不要です。API キーもアカウントも必要ありません。ネットワークから flytoday.ir に接続できない場合、または IP がレート制限された場合に限り、任意で FLYTODAY_MCP_PROXY を指定できます（HTTP プロキシ、またはカンマ区切りのリスト）。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、座席確保、予約、支払いは行わないため、ツールを呼び出す前の確認は不要です。すべてのツールに readOnlyHint: true が付与されています。
• ツール： 22 個あり、すべて ft_ で始まります。まず検索ツール（ft_find_airport、ft_find_hotel_place、ft_find_station、ft_find_bus_city）で ID を取得します。フライト：ft_flight_calendar → ft_search_flights → ft_flight_details。ホテル：ft_search_hotels → ft_hotel。ヴィラ：ft_search_stays → ft_stay。
• 単位： *_toman という名前のフィールドの料金はトマン建てです（ビザと一部のアクティビティの料金は外貨建てです。price_currency を参照してください）。日付はグレゴリオ暦の YYYY-MM-DD 形式で、過去の日付は受け付けられません。search_id と fare_source_code の有効期限は約 15 分です。
• 使用する場合： Flytoday でフライト、ホテル、ヴィラ、列車、バスを比較するとき、または CIP ラウンジ、eSIM、ビザ、アクティビティの料金を調べるとき。
• 使用しない場合： 予約や支払いが必要なとき（ユーザーが flytoday.ir で行います）。検索は IP ごとにレート制限されるため、検索を繰り返すより、カレンダーとページングを活用してください。
• 機械可読データ： server.json。イランの MCP サーバー全件のカタログ：iran-mcp（TOOLS.md、servers.json、llms.txt）。

利用する理由

Flytoday（flytoday.ir、فلای‌تودی）では、国内線・国際線、ホテル、ヴィラ、列車、バス、CIP ラウンジ、eSIM、ビザを取り扱っています。「どの日に、飛行機か列車かバスか、どのホテルか」を比較するには、今でも何度もページを読み込む必要があります。 flytoday-mcp を使えば、エージェントが一度に調べられます。

あなた： 10 月 20 日ごろに、テヘランからマシュハドへ行く最安の方法は？

エージェント： 次を呼び出します： ft_flight_calendar(origin="THR", destination="MHD", date="2026-10-21", window="week")、 ft_train_calendar(origin="1", destination="191")

交通手段	最安日	料金（トマン）
フライト	2026-10-20、航空会社 IRZ	11,056,700
列車	2026-10-20（およびその週のほとんどの日）	760,000

列車のほうがはるかに安いです。その日の列車を ft_search_trains で一覧表示しますか？

_{2026-10-07 時点の実際のツール出力です。料金と座席数は常に変動します。料金はトマン建てです。}

できること

• **航空券：**国内線・国際線、片道・往復、複数人分の料金、航空会社、直行便、チャーター便／システム便、時刻で絞り込み
• **最安日：**航空券（前後15日）、列車（約16日）、バス（約6週間）
• **運賃の詳細：**払い戻し・変更の規則、手荷物、国際線の入国に関する注意事項
• **ホテル：**イラン国内外の料金検索、キャンセル条件付きの客室・食事プラン、宿泊者レビュー
• **ヴィラとアパートメント：**イラン国内の宿泊施設。1泊あたり・合計料金、日ごとのカレンダーと予約不可日
• **列車とバス：**クラス、残席数、停車地、設備、VIPバスと寝台バス
• **その他：**IKAとMHDのCIPラウンジ、国別のeSIMデータプラン、ビザの料金と必要書類、ツアーとチケット
• **読み取り専用設計：**ログイン、座席の仮押さえ、予約、支払いはできません

プロンプトの例：

• 「来月、テヘランからイスタンブールへの最安日はいつですか？その運賃の払い戻し規則も教えてください。」
• 「21日から2泊、マシュハドで無料キャンセル可能なホテルを、料金の安い順に教えてください。」
• 「来週末、ラムサールで4人用、1泊500万トマン以下のヴィラを探してください。」
• 「今週、テヘランからマシュハドへの最安列車と、停車駅を教えてください。」
• 「トルコ向けのeSIMはいくらですか？ビザにはどの書類が必要ですか？」
• ارزان‌ترین اتوبوس VIP تهران به اصفهان دوشنبه بعد؟
• ارزان‌ترین روز برای پرواز تهران به مشهد در هفته آینده کدام است؟
• قوانین استرداد و بار مجاز این بلیط خارجی چیست؟
• یک ویلا در رامسر برای ۴ نفر آخر هفته زیر ۵ میلیون تومان پیدا کن.

クイックスタート

uvが必要です。APIキーやアカウントは不要です。

claude mcp add flytoday -- uvx flytoday-mcp

claude mcp add flytoday -e FLYTODAY_MCP_PROXY=http://127.0.0.1:8080 -- uvx flytoday-mcp

{
  "mcpServers": {
    "flytoday": { "command": "uvx", "args": ["flytoday-mcp"] }
  }
}

{
  "servers": {
    "flytoday": { "type": "stdio", "command": "uvx", "args": ["flytoday-mcp"] }
  }
}

codex mcp add flytoday -- uvx flytoday-mcp

[mcp_servers.flytoday]
command = "uvx"
args = ["flytoday-mcp"]

{
  "mcpServers": {
    "flytoday": { "command": "uvx", "args": ["flytoday-mcp"] }
  }
}

各分野には、それぞれの検索ツールで取得する固有の ID があります。航空便では IATA コード（THR、MHD、IST）、ホテルでは city_id／region_code、宿泊施設では region_code、列車では駅コード（テヘランは 1、マシュハドは 191）、バスでは 4 桁の都市 ID（テヘランは 0001、イスファハンは 0002）を使用します。

全22個のツールには readOnlyHint: true が注釈として付与されており、エージェントのコンテキストを過剰に消費しない、簡潔な構造化 JSON を返します。

動作の仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  flytoday-mcp  (runs on your machine)
      │
      │  HTTPS (optional proxy)
      ▼
  www.flytoday.ir/api/gateway  ──▶  api.flytoday.ir, placesearch.flytoday.ir

flytoday-mcp はローカルで動作し、flytoday.ir のウェブサイトが使用するものと同じ公開ゲートウェイを呼び出します。間にホスト型サーバーはなく、API キーも不要で、ユーザーに関する情報がほかの場所へ送信されることもありません。リクエストは Chrome を偽装する HTTP クライアント経由で送信され、同時実行数は最大2件で、短いランダムな間隔を設けます。失敗した呼び出し（タイムアウト、5xx、429）は最大2回再試行されます。静的な検索リスト（CIP の空港、eSIM の国、ビザ対象国）は6時間キャッシュされます。

知っておくと便利なこと

• 価格はすべてトマンで、すべてのツールで *_toman という名前のフィールドに表示されます（API はリヤルを送信し、値は 10 で割られています）。 航空券の price_toman は大人 1 人あたりの価格で、total_toman はグループ全体の価格です。ホテルの price_toman は滞在全体の価格（per_night_toman もあります）です。宿泊施設では price_per_night_toman と total_toman が表示されます。列車は大人 1 人あたり、バスは座席 1 席あたりの価格です。 ビザや一部のアクティビティの価格は外貨建てです（price_currency）。
• 日付の入出力形式はグレゴリオ暦の YYYY-MM-DD です。過去の日付は拒否されます。時刻は現地時間です。
• 航空券には airline（英語名）と airline_fa（API にある場合はペルシャ語名）が表示されます。
• ホテルと宿泊施設（検索結果の行、ft_hotel、ft_stay）には、カバー写真の image が含まれます。サイトと同じ形式の <cdn>/<id>/main.jpg で構成されています（API に画像フィールドはありません）。
• Flytoday では、検索は IP ごとにレート制限されています。航空券・列車・バスの検索は約 15 回、ホテル検索は 10 分間に約 12 回行うと CAPTCHA が要求されます（1 時間以上ブロックされる場合があります）。再検索する代わりに、カレンダーとページング（search_id）を使ってください。ツールが検索を繰り返すことはありません。
• ID の有効期限：search_id と fare_source_code は約 15 分間有効です。
• 販売開始時期：列車のチケットは約 16 日前から販売されます。検索結果が空でも、単に「まだ販売されていない」だけの場合があります。
• 鉄道会社のリンクがダウンしている場合、Flytoday は HTTP 599 を返します。ft_search_trains は 3 回再試行してから、その旨を通知します。
• 対応していない機能： 予約、座席の確保、支払い、払い戻し、ログイン、ツアーやパッケージの検索、バスの座席表には対応していません。
• 安全性： 読み取り専用です。POST リクエストは、サイトが予約前に行う検索と価格確認に限られます。 同時リクエストは最大 2 件で、検索をループ内で繰り返すツールはありません。
• プロキシ： ネットワークから flytoday.ir にアクセスできない場合は、FLYTODAY_MCP_PROXY を設定してください（設定を参照）。

よくある質問

npx @modelcontextprotocol/inspector uvx flytoday-mcp

設定

ペルシャ語：Flytoday MCP サーバー

claude mcp add flytoday -- uvx flytoday-mcp

開発

git clone https://github.com/sepehr071/flytoday-mcp && cd flytoday-mcp
uv sync
uv run python -m pytest  # offline, against recorded responses
uv run python -m pytest -m live  # real API, one search per tool (set FLYTODAY_MCP_PROXY if needed)
uv run ruff check .

ツールは src/flytoday_mcp/flights.py、hotels.py、trains.py、buses.py、extras.py にあります。それぞれ、エージェントがいつ使うべきかを説明する docstring を備えた、型付きの非同期関数です。課題の報告や PR を歓迎します。

リリース手順：pyproject.toml と server.json のバージョンを更新し、v* タグをプッシュします。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• iran-mcp：イランのサービスを提供するすべての MCP サーバーのカタログ
• MrBilit MCP server：航空券、鉄道、バス、タクシー、ホテル向け
• Jabama MCP server：ヴィラ、ツアー、イベント向け
• Otaghak MCP server：ヴィラ、コテージ、アパートメントの宿泊向け

クリック数の節約に役立ったら、スターを付けて他の人にも見つけてもらいましょう。

免責事項

非公式のサービスであり、Flytoday との提携関係や、同社からの推奨はありません。読み取り専用で、予告なく変更される場合がある flytoday.ir ウェブサイトの公開エンドポイントを使用します。リクエスト頻度は適切に保ってください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローして、イランのウェブサイト向けの MCP サーバーをご覧ください。すべて iran-mcp に掲載されています。これが時間の節約になった場合は、リポジトリにスターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT