MCP server exposing 10 tools for fred.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/fred/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}fred_get_series — AUTHORITATIVE historical time-series for US economic indicators from FRED (Federal Reserve Bank of St. Louis — the official US macroeconomic data repository, 800k+ series). Every series is an AGGREGATE for a whole country, state, or METROPOLITAN AREA (e.g. the Phoenix or Oklahoma City metro), reported monthly or quarterly. Pass a series ID like "MORTGAGE30US" (30y mortgage rate), "UNRATE" (unemployment), "CPIAUCSL" (CPI), "GDP", "FEDFUNDS" (Fed funds rate), "HOUST" (housing starts), "RHORUSQ156N" (US homeownership rate — the percent of households that OWN their home, distinct from the mortgage interest rate). Returns dates + values + the indicator's units. Use for macro, Fed, and metro-level US indicator questions. DO NOT GUESS a non-US series ID by pattern-matching a US one — "DEUUNRATE", "JPNUNRATE", "CANUNRATE" and similar <ISO3><METRIC> codes do NOT exist on FRED and 400 with "the series does not exist". For a NON-US country's unemployment/GDP/inflation/population, use worldbank_get_indicator (ISO country code + indicator, e.g. SL.UEM.TOTL.ZS for unemployment) instead — it is the reliable source for foreign macro data. If you don't know a FRED series ID, call fred_search first rather than inventing one.fred_vintage_dates — ALFRED revision history: every date FRED published a new vintage (initial release or a later revision) of a series. Use before fred_revisions to see which dates have a distinct vintage, or pass one of these dates as `as_of`/`realtime_start`+`realtime_end` to fred_get_series to get the data as it stood on that date.fred_revisions — How ONE observation (one date) in a FRED series was revised over time, from first release through every later vintage to the latest. Use on series that get revised after initial publication (e.g. GDP "GDPC1", payrolls "PAYEMS") to see the originally reported value versus the current one. Returns every ALFRED vintage on record for that observation, oldest first — consecutive vintages can repeat the same value, so compare `first_release.value` to `latest.value` (or scan `revisions`) to see whether it was ever actually revised.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.fred_release_dates — Economic data RELEASE CALENDAR from FRED — the dates indicators are/were published, including FUTURE scheduled dates. PREFER OVER WEB SEARCH for "when is the next CPI / jobs report / GDP release", "economic calendar", "Fed data release schedule". Omit release_id for the cross-release calendar; pass a release_id (from fred_releases — e.g. 10 = CPI, 50 = Employment Situation, 53 = GDP) for one release schedule. Returns release name + date, newest/upcoming first by default.nyfed_gdp_nowcast — The New York Fed Staff Nowcast — a weekly real GDP growth nowcast for the currently-tracked US quarter(s), from the Federal Reserve Bank of New York (keyless, NOT a FRED series — FRED's own catalog does not carry this). Answers "what is the NY Fed GDP nowcast", "current GDP growth estimate", "is the economy growing this quarter". Returns the headline nowcast percentage (annualized QoQ) for the quarter(s) actively being tracked (typically the most recent quarter awaiting its official BEA GDP release, plus the quarter in progress), with 50%/80% probability intervals where published, the publisher's own narrative explaining what moved the estimate this week, and recent CONCLUDED quarters' final nowcast versus the actual BEA advance/latest GDP print. Updated every Friday (except federal holidays).cleveland_fed_inflation_nowcast — Daily CPI and PCE inflation nowcasts (headline and core) from the Federal Reserve Bank of Cleveland — keyless, NOT a FRED series. Answers "what is the Cleveland Fed inflation nowcast", "current CPI estimate before the official release", "PCE inflation nowcast today". Returns month-over-month and year-over-year nowcasts for the current and prior month, plus quarterly annualized nowcasts for the current and next quarter. A blank value for a period/measure means the actual BLS (CPI) or BEA (PCE) release for that period has already been published, so the nowcast model stops estimating it. Updated every business day.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/fred/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io