Epa Aqs

@pipeworx/epa-aqs

EPA の大気質システム — 米国の約10,000か所の測定地点で測定された大気環境データを収録した、品質保証済みの規制基準レベルのアーカイブです。直近数日分の暫定リアルタイム AQI を提供する airnow パックとは異なります。

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

ツール

• aqs_list_parameters(list, pc?, state?, county?) — パラメーターコード、クラス、州、郡、測定地点、機関。
• aqs_sample_data(param, bdate, edate, by?, state?, county?, site?, cbsa?, bbox?, limit?) — 生の測定値。
• aqs_annual_summary(param, bdate, edate, ...) — 年平均、最大値、パーセンタイル、超過回数、完全性。
• aqs_monitors(param, bdate, edate, ...) — 測定機器のメタデータ、ネットワーク、測定方法、稼働開始日・終了日。

認証

現時点ではBYOのみです。 EPA AQS の認証には、メールアドレスとキーの2つの値が必要で、両方がセットで発行されます。パックには認証情報のスロットが1つしかないため、両方を _apiKey に指定します。

• ?_apiKey=<email>:<key> — メールアドレスとキーをまとめて指定するか、
• ?_apiKey=<key> と email=<your-email> を指定します。

無料ですぐに登録できます：GET https://aqs.epa.gov/data/api/signup?email=<your-email>。EPA はそのアドレスにキーをメールで送信します。

プラットフォームのフォールバック環境変数は PLATFORM_EPA_AQS_KEY で、<email>:<key> の形式で保存する必要があります。2026-09-17時点ではプロビジョニングされていません（fleet #2212）。ゲートウェイが Cloudflare の250個のテキストバインディング上限に達しているため、wrangler secret put ではなく、プラットフォームのキー ストアを通じて設定します。

キーなし、またはデモ用の方法はありません。 EPA の公式ドキュメントには共有テストアカウント（[email protected] / test）が記載されていますが、1日の割り当て量を恒常的に超過しています。2026-09-17に確認したところ、 {"error":"Daily limit for account use exceeded. Retry later."} が返されました。そのため、意図的に接続していません。これをデータとして提供すると、こちらの障害に見えてしまいます。

データソース

https://aqs.epa.gov/data/api — ドキュメント：https://aqs.epa.gov/aqsweb/documents/data_api.html

次の人が改めて調べずに済むよう、注意点をまとめます。

• 日付は区切り文字なしの YYYYMMDD 形式です。 ツールでは YYYY-MM-DD 形式を指定します。
• bdate と edate は同じ暦年に含まれている必要があります。 EPA のエラーメッセージでは明確に説明されないため、このパックでは事前に確認し、その旨を示します。
• エラーでも HTTP 200 が返されます。 認証や割り当て量の問題は Header[0].status または単独の {"error": ...} として返され、4xx にはなりません。このパックではどちらも、空の Data 配列としてではなく、エラーとして通知します。
• 1回のリクエストで指定できる param コードは最大5つです。

クイックスタート

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

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

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

https://gateway.pipeworx.io/epa-aqs/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールに加えて、共通ツールが約 30 個表示されます。接続の initialize レスポンスには対象範囲が正確に示されており、その日の状況を確認するうえで信頼できる情報です。

これは意図的なもので、偶然の多重化ではありません。メタツールを使うと、このパックで扱えない質問にも、ask_pipeworx を介してカタログ全体を検索して回答できるため、MCP サーバーをもう 1 つ追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

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

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

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

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/aqs_list_parameters \
  -H 'Content-Type: application/json' \
  -d '{"list":"classes"}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/aqs_list_parameters を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

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

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

起動を確認するには、直接実行することもできます。

npx -y @pipeworx/mcp-epa-aqs

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Epa Aqs data" })

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

詳細

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

ライセンス

MIT