US FRED economic series search

us_search_fred_series

TW-specificMIT

**關鍵字 / Keywords**: 美聯儲經濟數據 GDP 失業率 CPI 通膨利率時間序列 FRED Federal Reserve St Louis Fed economic time series macro unemployment inflation interest rate treasury monetary consumer price

Scope: US Federal Reserve Economic Data (FRED) · 816,000+ macro
/ monetary / financial time series curated by the St. Louis Fed.

Natural-language search across FRED series titles. Returns
series_id + human-readable title + units + frequency + last
observation date + popularity — the fields agents need to pick
the right series before pulling observations.

Endpoint:
    https://api.stlouisfed.org/fred/series/search?search_text=…

Args:
    query: free-text query (e.g. "unemployment", "consumer price
           index", "10-year treasury", "federal funds rate").
    limit: max hits to return (default 10, hard cap 100).
    order_by: FRED sort key. Common values:
              "search_rank" (default · text relevance),
              "popularity", "frequency", "observation_start",
              "observation_end", "last_updated".

Requires US_FRED_API_KEY environment variable (free from
https://fred.stlouisfed.org/docs/api/api_key.html, ~1 min signup
with email). Response includes `license` warning that FRED
aggregates third-party series (OECD, Eurostat, ISM, …) which
carry origin-jurisdiction copyright — check per-series
`copyright` (surfaced in observations responses) before
redistributing.

Input schema

{
  "properties": {
    "query": {
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "title": "Limit",
      "type": "integer"
    },
    "order_by": {
      "default": "search_rank",
      "title": "Order By",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "us_search_fred_seriesArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see us_search_fred_series. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 us_search_fred_series 處理 "…"。

# It will call:
us_search_fred_series(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs