← Blog

FRED for AI Agents: 800,000 Economic Time Series Through MCP

The Federal Reserve's FRED database has 800K+ time series. Pipeworx gives your AI agent direct access — mortgage rates, GDP, unemployment, inflation, and more.

FRED — Federal Reserve Economic Data — is the single most important economic data source in the world. Maintained by the Federal Reserve Bank of St. Louis, it contains over 800,000 time series covering virtually every measurable aspect of the US and global economy: interest rates, GDP, employment, inflation, housing, trade, money supply, consumer credit, and more.

FRED is free to access. But its API is complex, series IDs are not intuitive (the 30-year mortgage rate is MORTGAGE30US, unemployment is UNRATE, GDP is just GDP), and building an integration that handles search, metadata, and time series retrieval correctly takes real work.

Pipeworx wraps FRED into clean MCP tools that your AI agent can call directly. FRED appears in four Pipeworx verticals because economic data is foundational to almost every analytical domain.

FRED tools

  • fred_get_series — pull any FRED series by ID. Returns observation dates and values for any time range.
  • fred_search — search for series by keyword. “mortgage rate” returns MORTGAGE30US and related series.
  • fred_series_info — metadata for any series: title, units, frequency, seasonal adjustment, last updated.
  • fred_category — browse FRED’s category tree to discover series by topic.
  • fred_releases — track data releases and their schedules (e.g., monthly jobs report, CPI release).

Where FRED appears in Pipeworx

Housing Intel

FRED provides the backbone of housing market analysis:

  • MORTGAGE30US — 30-year fixed mortgage rate (weekly)
  • HOUST — housing starts (monthly)
  • CSUSHPINSA — Case-Shiller US National Home Price Index
  • EXISTHOMESALES — existing home sales
  • PERMIT — building permits

FinTech

FRED provides macro financial context:

  • FEDFUNDS — effective federal funds rate
  • T10Y2Y — 10-year minus 2-year Treasury yield spread (yield curve)
  • TOTALSL — total consumer credit
  • M2SL — M2 money supply
  • CPIAUCSL — Consumer Price Index

TradeGuard

FRED tracks trade-related economic indicators:

  • BOPGSTB — US trade balance in goods and services
  • TWEXBMTH — trade-weighted US dollar index
  • IR3TIB01USM156N — import price index

AgriPulse

FRED covers agricultural economics:

  • Commodity futures prices
  • Agricultural price indices
  • Exchange rates affecting export competitiveness

Example: Mortgage rate analysis

Ask your AI: “What are current 30-year mortgage rates and how have they trended over the past year?”

Your AI calls fred_get_series with series ID MORTGAGE30US, gets weekly observations, and can show you the exact current rate and its trajectory — sourced directly from the Federal Reserve.

Example: Economic dashboard

Ask: “Give me a quick economic snapshot — GDP growth, unemployment, inflation, and the fed funds rate.”

Your AI chains:

  1. fred_get_series with GDP — latest real GDP
  2. fred_get_series with UNRATE — current unemployment rate
  3. fred_get_series with CPIAUCSL — latest CPI (inflation)
  4. fred_get_series with FEDFUNDS — current fed funds rate

Four calls, complete macro picture, all from the Federal Reserve.

Example: Series discovery

Don’t know the series ID? No problem.

Ask: “What FRED series track housing affordability?”

Your AI calls fred_search with “housing affordability” and gets a list of relevant series with titles, descriptions, and IDs. Then it can pull any of them with fred_get_series.

Why FRED matters for AI

FRED is arguably the highest-value single data source for any AI agent doing economic analysis. It’s authoritative (maintained by the Federal Reserve), comprehensive (800K+ series), free (no API cost), and well-structured (consistent time series format).

But most AI systems can’t access it directly. They’re stuck with whatever economic numbers were in their training data, or they search the web and get second-hand summaries. Direct FRED access means your AI is always working with the latest data from the source.

Connect

FRED is available through multiple Pipeworx verticals:

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

Or connect to a specific vertical for FRED data in context:

  • Housing: https://gateway.pipeworx.io/mcp?vertical=housing
  • FinTech: https://gateway.pipeworx.io/mcp?vertical=fintech
  • Trade: https://gateway.pipeworx.io/mcp?vertical=trade
  • Agriculture: https://gateway.pipeworx.io/mcp?vertical=agri

Call ask_pipeworx with any economic question and the gateway routes to FRED automatically when that’s the right source.