Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt

Use this file to discover all available pages before exploring further.

Available as MCP tools: macro_indicator_search + macro_indicator_history — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.
Live   1 credit · history   free · search

​
What it does for your agent

macro_indicator_history returns the latest-vintage historical time series for one supported U.S. macro indicator (CPI, UNRATE, Fed Funds, 10Y yield, GDP, etc.) — a list of { date, value, realtime_start, realtime_end } observations. Use it as a macro time-series fetcher mid-task: when an agent needs to chart inflation over the last 5 years, compute a yield-curve slope, or feed observations into a downstream model. The canonical agent flow is two-step: call macro_indicator_search first (free) to locate the right indicator alias, then macro_indicator_history to pull the series. Two query modes:
  • Recent mode — pass limit (default 60) for the most recent N observations.
  • Range mode — pass start_date + end_date for an explicit window.

​
Agent flow

​
Response

​
data
MacroHistorical
required
Indicator metadata + observations array.
​
meta.count
number
Number of observations returned.
​
meta.stale
boolean
true if returned data is from cache after upstream refresh failed.
​
meta.creditsUsed
number
Credits consumed (always 1).
​
meta.remainingCredits
number
Account credits remaining.
​
meta.sourceNotice
string
FRED API notice string.
200 OK · macro_indicator_history
{
  "data": {
    "indicator": "us.cpi.headline",
    "series_id": "CPIAUCSL",
    "title": "Consumer Price Index for All Urban Consumers: All Items in U.S. City Average",
    "frequency": "Monthly",
    "units": "Index 1982-1984=100",
    "observations": [
      {
        "date": "2026-01-01",
        "value": 318.412,
        "realtime_start": "2026-02-12",
        "realtime_end": "2026-02-12"
      },
      {
        "date": "2026-02-01",
        "value": 319.082,
        "realtime_start": "2026-03-12",
        "realtime_end": "2026-03-12"
      },
      {
        "date": "2026-03-01",
        "value": 319.799,
        "realtime_start": "2026-04-10",
        "realtime_end": "2026-04-10"
      }
    ],
    "attribution": "Source: U.S. Bureau of Labor Statistics via FRED"
  },
  "meta": {
    "count": 3,
    "stale": false,
    "creditsUsed": 1,
    "remainingCredits": 99,
    "sourceNotice": "This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis."
  }
}

​
Notes

Revision-aware: macro observations get revised. The series returns the current latest vintage — the value FRED publishes today, not the value released originally. Use realtime_start / realtime_end to detect whether you’re seeing a revised print. ALFRED-style as-of replay is not supported.
Default limit=60 covers ~5 years for monthly series, ~1 year for weekly, ~3 months for daily. Bump to 500 or use Range mode for longer windows. Cache is shared across users, so popular indicators stay warm.
Recent and Range are mutually exclusive. Pass either limit alone, or start_date + end_date together. Passing only one of start_date / end_date returns 400.
Allowlist only. ~50 curated U.S. indicators. Arbitrary FRED series IDs return 404. Use macro_indicator_search to discover what’s available.

​
Direct invocation

// 1) Discover the alias
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_search",
    "arguments": { "q": "cpi", "category": "Inflation" }
  }
}

// 2) Fetch recent history (default 60)
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_history",
    "arguments": { "indicator": "us.cpi.headline", "limit": 60 }
  }
}

// 2b) Or fetch an explicit date range
{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_history",
    "arguments": {
      "indicator": "us.cpi.headline",
      "start_date": "2020-01-01",
      "end_date": "2026-03-01"
    }
  }
}

​
Full parameter reference

​
q
string
Free-text keyword. Matches indicator alias, FRED title, and series_id.
​
category
string
Filter by theme (Inflation, Rates, Labor, Growth, Housing, Liquidity, Conditions, FX, Credit, Sentiment, Energy, Inflation Expectations, Consumption).
​
frequency
string
Filter by cadence (Daily, Weekly, Monthly, Quarterly, Annual).
​
limit
number
default:20
Max items returned. Range 1–100.
​
indicator
string
Platform alias (e.g. us.cpi.headline, us.rates.fed_funds). Use this OR series_id.
​
series_id
string
FRED series ID (e.g. CPIAUCSL). Use this OR indicator. Must be in the allowlist.
​
start_date
string
Range mode. ISO date YYYY-MM-DD. Must be paired with end_date.
​
end_date
string
Range mode. ISO date YYYY-MM-DD. Must be paired with start_date.
​
limit
number
default:60
Recent mode count. Range 1–500. Ignored when Range mode is used.

Macro Indicators Catalog

Discover the ~50-indicator allowlist (free).

Macro Snapshot

Just the latest print + delta vs previous (no full series).