Skip to main content
All providers

FRED (St. Louis Fed)

FinanceUS

api.stlouisfed.org

Over 800,000 US and international economic time series from the Federal Reserve Bank of St. Louis.

Runs on your machine under the source's own terms

The crw MCP on your computer calls FRED (St. Louis Fed) directly, with a free key of your own. Calls cost no credits and the data does not pass through fastCRW. Install it once for Claude Code, Cursor, Codex, Windsurf, Gemini CLI or OpenCode, with your fastCRW API key in place of the placeholder:

Capabilities (18)

fred/categoryFree, runs locally

Returns one node of FRED's topic tree: its id, name and parent id.

category_id
fred/category-childrenFree, runs locally

Returns the immediate child categories of a node in FRED's topic tree.

category_idrealtime_start?realtime_end?
fred/category-seriesFree, runs locally

Returns every series filed under one category, each with full series metadata.

category_idlimit?offset?order_by?sort_order?filter_variable?filter_value?tag_names?exclude_tag_names?realtime_start?realtime_end?
fred/observationsFree, runs locally

Returns the actual data points of one FRED series: an array of date/value pairs plus the realtime window they were valid in.

series_idobservation_start?observation_end?units?frequency?aggregation_method?limit?offset?sort_order?realtime_start?realtime_end?output_type?vintage_dates?
fred/releaseFree, runs locally

Returns one release's record: its name, whether it is press-released and the publisher's URL.

release_idrealtime_start?realtime_end?
fred/release-datesFree, runs locally

Returns the dates on which releases were or will be published, newest first, each with its release id and name.

limit?offset?order_by?sort_order?realtime_start?realtime_end?include_release_dates_with_no_data?
fred/releasesFree, runs locally

Returns FRED's catalogue of statistical releases (id, name, publisher link and notes) for every report it ingests.

limit?offset?order_by?sort_order?realtime_start?realtime_end?
fred/release-seriesFree, runs locally

Returns every series published as part of one release, each with full series metadata.

release_idlimit?offset?order_by?sort_order?filter_variable?filter_value?realtime_start?realtime_end?
fred/searchFree, runs locally

Full-text search over FRED series titles and notes; returns matching series with their full metadata, ranked by search relevance or popularity.

search_textlimit?offset?order_by?sort_order?filter_variable?filter_value?tag_names?exclude_tag_names?search_type?
fred/seriesFree, runs locally

Returns one series' descriptive record: title, units, frequency, seasonal adjustment, observation range, last update time, popularity and notes.

series_idrealtime_start?realtime_end?
fred/series-categoriesFree, runs locally

Returns the FRED category nodes a given series is filed under, with each category's id, name and parent id.

series_idrealtime_start?realtime_end?
fred/series-releaseFree, runs locally

Returns the statistical release a series belongs to: release id, name, whether it is press-released and the publisher's link.

series_idrealtime_start?realtime_end?
fred/series-tagsFree, runs locally

Returns the FRED tags attached to a series (geography, frequency, seasonality, source and topic) with each tag's group and series count.

series_idorder_by?sort_order?realtime_start?realtime_end?
fred/series-updatesFree, runs locally

Returns the series FRED refreshed most recently, newest first, with full metadata including each one's last_updated timestamp.

limit?offset?filter_value?start_time?end_time?realtime_start?realtime_end?
fred/series-vintagedatesFree, runs locally

Returns the list of dates on which a series was revised or re-released, i.e. every vintage ALFRED holds for it.

series_idlimit?offset?sort_order?realtime_start?realtime_end?
fred/sourcesFree, runs locally

Returns the organisations FRED sources data from (BLS, BEA, the Federal Reserve Board and so on) with id, name and link.

limit?offset?order_by?sort_order?realtime_start?realtime_end?
fred/tagsFree, runs locally

Returns FRED's tag vocabulary: name, group (geography, frequency, source, seasonality, general), notes, popularity and how many series carry it.

limit?offset?order_by?sort_order?tag_names?tag_group_id?search_text?realtime_start?realtime_end?
fred/tags-seriesFree, runs locally

Returns every series carrying all of the given tags, with full series metadata.

tag_nameslimit?offset?order_by?sort_order?exclude_tag_names?realtime_start?realtime_end?

Response example

The shape of data from fred/category (Category details). A sample, not live data.

idnameparent_id
125Trade Balance13

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • Category details

    Use FRED (St. Louis Fed) (fred) from fastCRW Pergamon, capability "Category details" (category). You have a category id and want its name and where it sits in the tree. Example options: category_id=125. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "fred" and capability "category". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Child categories

    Use FRED (St. Louis Fed) (fred) from fastCRW Pergamon, capability "Child categories" (category-children). You are walking FRED's taxonomy from the root (id 0) down to a topic. Example options: category_id=13. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "fred" and capability "category-children". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Series in a category

    Use FRED (St. Louis Fed) (fred) from fastCRW Pergamon, capability "Series in a category" (category-series). You have narrowed the topic tree to a category and now want its series. Example options: category_id=125, order_by=series_id, limit=20. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "fred" and capability "category-series". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Series observations

    Use FRED (St. Louis Fed) (fred) from fastCRW Pergamon, capability "Series observations" (observations). You have a FRED series id and want its numbers over time. Example options: series_id=UNRATE, observation_start=2015-01-01, units=lin. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "fred" and capability "observations". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

Licence

FRED provides data and data services to the public for non-commercial, educational, and personal uses subject to a few prohibitions. Furthermore, other uses (e.g., commercial) are subject to additional restrictions.

https://fred.stlouisfed.org/legal/

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attributionText.

Source: Federal Reserve Bank of St. Louis (FRED)