@pipeworx/fred

Connect: https://gateway.pipeworx.io/fred/mcp · Install: one-click buttons

Tools: 5

The St. Louis Fed’s data warehouse: 800,000+ economic time series spanning interest rates, inflation, employment, GDP, money supply, exchange rates, and metro-level indicators. The most authoritative, continuously updated source for US macro and monetary data — used by economists, policymakers, and journalists.

Why this matters for AI agents

Most “what is the current X” macro questions resolve to a FRED series. An agent that knows the series ID can answer with the actual current value, not a training-data snapshot. Common ones:

• 30-year mortgage rate → MORTGAGE30US
• Federal funds rate → DFF
• CPI (all items) → CPIAUCSL
• Unemployment rate → UNRATE
• 10-year treasury yield → DGS10
• Housing starts → HOUST
• Case-Shiller home price index → CSUSHPISA

If your agent is answering a question about US macroeconomic state, the right pattern is fred_search (find the right series) → fred_series_info (confirm units and frequency) → fred_get_series (get the values).

Auth

FRED requires an API key. It’s free at https://fred.stlouisfed.org/docs/api/api_key.html — takes 30 seconds, no payment, no rate-limit terror.

Pass via _apiKey per call:

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

Or subscribe to the Housing Vertical which manages the key for you.

Update cadence

Pipeworx caches FRED responses with TTLs matching these cadences — see caching and freshness.

Citable URI

Embed in your output for stable citations:

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

Other agents (and resources/read) can resolve these to the current value of the series.

Common pitfalls

• Vintages: FRED preserves historical “vintages” (data as it was reported at time T). Default tool calls get the latest revised series. Pass realtime_start and realtime_end for as-of queries.
• Frequency aggregation: frequency parameter coerces to a different cadence (e.g., daily → monthly average). Default is the series’ native frequency.
• Units transformation: units parameter computes derived series at request time (pch for percent change, pca for compound annual rate, etc.). Don’t compute these client-side; let FRED do it.
• Series renamed: occasionally the Fed deprecates a series and creates a successor. Old IDs return errors. fred_search is the recovery path.

Tools

• fred_get_series — Fetch historical data points for an economic indicator by series ID (e.g., ‘MORTGAGE30US’ for 30-year mortgage rate, ‘HOUST’ for housing starts). Returns dates and values.
• fred_search — Search for economic data series by keyword. Returns series IDs, titles, and descriptions to identify the right indicator.
• fred_series_info — Get metadata for a series: title, units, frequency, seasonal adjustment, notes, and date range. Check this before fetching historical data.
• fred_category — Browse economic data by category (housing, employment, money/banking, etc.). Returns subcategories and related series IDs.
• fred_releases — Check upcoming and recent economic data releases. Returns release dates, names, and which series they update.