Econdata

@pipeworx/econdata

Bureau of Labor Statistics の公開 API v2 による米国の労働・物価統計 — インフレ率（CPI-U）、失業率、産業別の非農業部門雇用者数、および ID を指定した任意の BLS 系列。

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

ツール

ツール	返されるデータ
get_cpi	米国都市平均の全項目を対象とした CPI-U 指数の履歴。各月の yoy_inflation_pct と latest の概要が計算されます。デフォルトでは季節調整されていません（BLS CUUR0000SA0）。seasonally_adjusted: true を渡すと CUSR0000SA0 が使われます。これは FRED が CPIAUCSL として公開している系列と同じです。2 つの値には約 1 ポイントの差があるため（2026-07: 333.918 NSA vs 332.813 SA）、各レスポンスには使用した調整方法が記載され、同じ月のもう一方の値も latest.index_value_sa / latest.index_value_nsa として含まれます。
get_unemployment	季節調整済みの民間失業率（LNS14000000）、月次。
get_employment_by_industry	季節調整済みの従業員数（千人単位）。total_nonfarm、manufacturing、construction、retail、financial、government が対象です。
get_series	取得したい系列がすでに決まっている場合に、ID を指定して任意の BLS 系列を取得します。

データは新しい順に届きます。すべてのレスポンスで observation_order にその旨が示されるため、日付から順序を推測する必要はありません。ここでは total と returned は常に同じ値です。BLS は要求された年の範囲内のすべてのデータポイントを返すため、データが切り詰められることはありません。

各データポイントには、BLS の period コード（毎月 M01～M12、四半期ごと Q01～Q04、半年ごと S01／S02、年次 A01／M13）から導出された ISO date が含まれます。そのため、"M06" をデコードしなくても、結果を並べ替えたり、データの鮮度を確認したりできます。

認証

キーなしでも利用できますが、IP ごとに 1 日あたり約 25 リクエストです。無料の BLS 登録キーを使うと 1 日あたり 500 リクエストに増えます。https://data.bls.gov/registrationEngine/ で取得してください。ゲートウェイはプラットフォームキー（PLATFORM_BLS_KEY）を提供します。独自のキーで上書きする場合に限り、_apiKey を渡してください。

BLS の 2 種類の制限は異なる形でエラーになるため、このパックでは区別しています。以前はどちらも同じように見えていました。

• 1 秒あたりのバースト制限 — 同じ秒内に同時リクエストが集中すると、BLS は HTTP 429「Requests Per Second Limit Exceeded」を返します。このパックは 3 回（400 ms、1200 ms、2500 ms）再試行します。3 回の再試行後も 429 が続いた場合のみ、upstream_throttled として返されます。その際、これは日次クォータではなく、キーの上限に達した状態でもないことが明示されます。
• 日次しきい値 — HTTP エラーではなく、REQUEST_NOT_PROCESSED の本文として返されます。こちらも upstream_throttled として返され、登録リンクが示されます。

データソース

• BLS Public Data API v2 — https://api.bls.gov/publicAPI/v2/timeseries/data/（ドキュメント：https://www.bls.gov/developers/api_signature_v2.htm）
• 使用する系列：CUUR0000SA0 / CUSR0000SA0（CPI-U、NSA / SA）、LNS14000000（失業率）、CES*（産業別 Current Employment Statistics）

クイックスタート

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

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

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

https://gateway.pipeworx.io/econdata/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 も、同じゲートウェイと同じ 1878 以上のデータソースにアクセスします。唯一の違いは、どのパックのツールが直接リストされるかです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

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

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

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

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

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

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

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-econdata

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

ask_pipeworx を使用する

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

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

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

詳細

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

ライセンス

MIT