Fred

FRED — Federal Reserve Economic Data

セントルイス連邦準備銀行のデータウェアハウスです。金利、インフレ、雇用、GDP、マネーサプライ、為替レート、都市圏レベルの指標を網羅する、80万件以上の経済時系列データを収録しています。米国のマクロ経済・金融データの最も信頼性が高く、継続的に更新される情報源であり、経済学者、政策立案者、ジャーナリストに利用されています。

Pipeworx の一部です。AI エージェントを1879以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開を受けたものではありません。

AI エージェントにとって重要な理由

「現在の X はいくらか」といったマクロ経済に関する質問の多くは、FRED の系列データで解決できます。系列 ID を把握しているエージェントなら、学習データのスナップショットではなく、実際の最新値を回答できます。よく使われる系列は次のとおりです。

• 30年固定住宅ローン金利 → MORTGAGE30US
• フェデラルファンド金利 → DFF
• CPI（全項目） → CPIAUCSL
• 失業率 → UNRATE
• 10年物米国債利回り → DGS10
• 住宅着工件数 → HOUST
• ケース・シラー住宅価格指数 → CSUSHPISA

米国のマクロ経済状況についてエージェントが質問に回答する場合は、fred_search（適切な系列を見つける）→ fred_series_info（単位と頻度を確認する）→ fred_get_series（値を取得する）の順に利用するのが適切です。

認証

FRED には API キーが必要です。https://fred.stlouisfed.org/docs/api/api_key.html で無料で取得できます。所要時間は30秒で、支払いは不要であり、厳しいレート制限もありません。

呼び出しごとに _apiKey を渡してください。

fred_get_series({
  series_id: "MORTGAGE30US",
  _apiKey: "your-fred-api-key"
})

または、キーを管理してくれる Housing Vertical をご利用ください。

更新頻度

系列の種類	更新頻度
日次系列（金利、為替レート）	毎日、約1営業日の遅れ
週次（住宅ローン金利）	毎週木曜日
月次（CPI、失業率、小売売上高）	毎月、月末から約2～3週間後
四半期（GDP）	四半期ごと、四半期末から約1か月後

Pipeworx は、これらの更新頻度に合わせた TTL で FRED のレスポンスをキャッシュします。キャッシュと鮮度をご覧ください。

引用可能な URI

安定した引用のため、出力に埋め込んでください。

pipeworx://fred/series/{series_id}
pipeworx://fred/series/{series_id}/observations

ほかのエージェント（および resources/read）は、これらを解決して系列の現在値を取得できます。

ALFRED のビンテージ：「日付 X 時点でこの数値はどう示されていたか」

FRED は、初回公開後に多くの系列を改訂します（GDP、給与所得者数、小売売上高など）。 fred_get_series は既定で最新の改訂値を返します。以前のビンテージを取得するには、次のいずれかを指定してください。

• as_of: "2020-03-15" — その日時点のデータです。realtime_start = realtime_end = as_of の省略形です。
• realtime_start / realtime_end — 単一の日付ではなくカスタム範囲を指定する、よりまれなケース向けの明示的な公開期間です。

3つすべてを省略した場合は既定の動作となり、変更はありません。vintage フィールドは追加されず、このパラメーターが導入される前と同じ値が返されます。いずれかを渡すと、レスポンスに vintage オブジェクト（{as_of, realtime_start, realtime_end}）が追加され、参照しているビンテージを確認できます。

fred_get_series({ series_id: "GDPC1", as_of: "2024-01-15", limit: 1 })
// -> the GDP print as FRED had it published on 2024-01-15, before later revisions

改訂履歴を直接確認できるツールが、さらに2つあります。

• fred_vintage_dates({ series_id }) — FRED がその系列の新しいビンテージを公開したすべての日付（初回公開またはその後の改訂）を返します。
• fred_revisions({ series_id, observation_date }) — 1つの観測値が、初回公開（first_release）から最新（latest）まで、すべてのビンテージにわたってどのように変化したかを返します。GDP の GDPC1 や給与所得者数の PAYEMS など、改訂されやすい系列で利用すると、当初公表された数値と現在の数値を比較できます。

fred_revisions({ series_id: "GDPC1", observation_date: "2023-10-01" })
// -> revisions: [{ vintage_date: "2023-10-26", value: "22490.692" }, ...]
//    one entry per ALFRED vintage, oldest first; first_release is the
//    earliest, latest the most recent. Consecutive vintages can repeat the
//    same value — compare first_release.value to latest.value to see
//    whether this observation was ever actually revised.

fred_get_series レスポンスの読み方

フィールド	内容
count	指定した期間について、FRED が保持している観測値の数です。
returned	observations に含まれる観測値の数です。デフォルトでは limit により 20 件が上限になります。
truncated	returned < count の場合に True になります。note にその旨が文章で記載されます。
observation_order	newest_first（デフォルト）または oldest_first（sort_order: "asc"）です。
observation_start / observation_end	FRED のシリーズメタデータに基づく、シリーズの実際の対象期間です。
requested_start / requested_end	指定した期間です。期間を指定しなかった場合は含まれません。

知っておくべきなのは最後の 2 行です。FRED の observations エンドポイントは、 observation_start／observation_end を受け取った値のまま返し、呼び出し側がどちらも指定しない場合は 1600-01-01／9999-12-31 に置き換えます。そのため、このパックでは以前、 米国 GDP の対象期間が 1600 年から 9999 年までと報告されていました。現在はこれらのフィールドに シリーズメタデータに基づく対象期間が設定され、fred_series_info や fred_search での意味と一致しています。

地域連銀のナウキャスト（API キー不要、FRED シリーズではありません）

このパックの 2 つのツールは、セントルイス連銀の API ではなく、各地域の連邦準備銀行のウェブサイトに 直接プロキシします。どちらのシリーズも FRED 自身のカタログには存在しないことを、作成前に fred_search で確認しています。_apiKey は不要です。

• nyfed_gdp_nowcast() — ニューヨーク連邦準備銀行による、現在追跡中の四半期の週次実質 GDP 成長率ナウキャストです。 50％／80％の確率区間、公開元独自の解説、直近の確定済み四半期についての最終ナウキャストと 実際の BEA GDP 発表値が含まれます。毎週金曜日に更新されます。
• cleveland_fed_inflation_nowcast() — クリーブランド連邦準備銀行による、日次の CPI／PCE インフレ率ナウキャストです （総合とコア）。前月比、前年同月比、年率換算の四半期値で示されます。空欄は、その期間の公式な BLS／BEA 発表が すでに存在することを意味します。毎営業日に更新されます。

nyfed_gdp_nowcast({})
// -> current_estimates: [{ quarter: "2026:Q3", nowcast_pct: 2.7, ... }, { quarter: "2026:Q4", nowcast_pct: 2.8 }]

cleveland_fed_inflation_nowcast({})
// -> current: { month: "October 2026", month_over_month_pct: { cpi: 0.27, ... }, year_over_year_pct: { cpi: 3.77, ... } }

よくある落とし穴

• ビンテージ：FRED は過去の「ビンテージ」（時点 T に報告されたデータ）を保持しています。デフォルトのツール呼び出しでは、最新の改訂済みシリーズが返されます。as-of クエリを行うには、fred_get_series に as_of（または realtime_start／realtime_end）を渡すか、fred_revisions を使って 1 つの観測値の全履歴を確認してください。
• 頻度の集計：frequency パラメーターを指定すると、異なる頻度に変換されます（例：日次から月次平均）。デフォルトはシリーズ本来の頻度です。
• 単位の変換：units パラメーターは、リクエスト時に派生シリーズを計算します（パーセント変化を表す pch、複利年率を表す pca など）。これらをクライアント側で計算せず、FRED に任せてください。
• シリーズ名の変更：連銀がシリーズを廃止し、後継シリーズを作成することがあります。古い ID はエラーになります。fred_search で検索して復旧してください。

クイックスタート

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

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

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

https://gateway.pipeworx.io/fred/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/fred_get_series \
  -H 'Content-Type: application/json' \
  -d '{"series_id":"MORTGAGE30US"}'

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

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

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

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

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

npx -y @pipeworx/mcp-fred

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

ask_pipeworx を使用する

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

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

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

詳細情報

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

ライセンス

MIT