Aviationstack

@pipeworx/aviationstack

Aviationstack MCP — 世界規模のフライト追跡＋空港／航空会社／路線の参照データ。

Pipeworx の一部です。AI エージェントを 1872 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、承認も公開も受けていません。

ツール

• flights(flight_iata?, flight_icao?, dep_iata?, arr_iata?, airline_iata?, flight_status?, limit?, offset?) — リアルタイムおよびスケジュール済みのフライト
• airports(search?, iata_code?, icao_code?, limit?, offset?) — 空港データベース（約 1 万の空港）
• airlines(search?, iata_code?, icao_code?, limit?, offset?) — 航空会社データベース
• cities(search?, iata_code?, country_iso2?, limit?) — 都市から主要空港への対応付け
• countries(search?, country_iso2?, limit?) — 国の参照データ
• routes(dep_iata?, arr_iata?, airline_iata?, flight_number?, limit?) — スケジュール済みの路線
• aviationstack_future_flights(iataCode, type, date, airline_iata?, airline_icao?, flight_number?, limit?, offset?) — 特定の日に指定空港を発着するスケジュール済みの将来のフライト（type：departure または arrival）。Aviationstack の /flightsFuture エンドポイントを利用しています。このエンドポイントは、apilayer が 2026-10-06 の告知で今後 7 日間のみ利用可能としたもので、date は tomorrow..today+7（UTC）の範囲である必要があります。パックは上流への呼び出し前に、範囲外の日付を独自に拒否します（fleet #2700）。

認証

• プラットフォームキー： ゲートウェイ環境変数 PLATFORM_AVIATIONSTACK_KEY
• BYO： https://aviationstack.com/signup/free で登録後、?_apiKey=<key> を指定します

プランのティア

2026-10-06 時点で、共有プラットフォームキーのプランは、flights、airports、 airlines、cities、countries、routes にライブでアクセスできます（確認済み：airports／JFK と routes／JFK→LAX はどちらも空でないデータを返しました。どちらも、もはや無料ティア限定ではありません。 2026-08-28 に書かれたこの README の以前のバージョンには異なる記載があり、古くなっていました）。 aviationstack_future_flights は、ベンダーから /flightsFuture をより広く開放したというメールが届いた同日に追加されました。このツールの公開前に、当社の特定のプランがそのエンドポイントにアクセスできるかは独立して確認されていません（プラットフォームキーの実際の値は Cloudflare／Supabase のシークレットであり、パック作成セッションからは利用できません）。ライブ呼び出しで HTTP 403 function_access_restricted が返る場合、これはプランがまだこのエンドポイントをカバーしていないことを意味し、パックのバグではなく、料金またはプランに関する判断事項です。

無料プラン（プラットフォームキーが今後無料プランに戻った場合）は、月 100 リクエストに制限されており、上限に達すると、そのティアで通常は許可されるエンドポイントを含め、すべてのエンドポイントが 429 を返します。無料プランは HTTP のみ（https は不可）です。パックはすでに http:// を使用しています。

ここでの 429 の読み取り方： Aviationstack は月間利用枠の超過による拒否をコード rate_limit_reached で示し、メッセージ本文では「monthly」としか説明していません。そのため、コード名からは数秒で解除されるバースト制限のように見えますが、実際にはプラン更新まで続く上限です。パックはコードではなくメッセージに基づいて分岐します。Fleet #577。

データソース

http://api.aviationstack.com/v1/ — access_key クエリパラメーター。/flightsFuture の仕様： https://api.swaggerhub.com/apis/apilayer-863/AviationstackAPI/1.0.0/swagger.json

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "aviationstack": {
      "url": "https://gateway.pipeworx.io/aviationstack/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/aviationstack/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに、共有ツールが約 30 個表示されます。接続の initialize レスポンスには正確な範囲が記載されており、その日の状況を確認するための正式な情報です。

これは意図的な仕様であり、誤って多重化されているわけではありません。メタツールを使うことで、このパックでは対応していない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによって増えるコンテキストが、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すれば、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1872+ のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/flights \
  -H 'Content-Type: application/json' \
  -d '{"flight_iata":"AA100","dep_iata":"JFK","arr_iata":"LAX"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/flights を実行してください。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "aviationstack": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-aviationstack"]
    }
  }
}

または、直接実行して起動を確認してください。

npx -y @pipeworx/mcp-aviationstack

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールを使用しますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも使用できます。

ask_pipeworx({ question: "your question about Aviationstack data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT