Skip to main content
Available as MCP tool: macro_indicator_search — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.
Live   free · 0 credits

​
What it does for your agent

macro_indicator_search returns the LLMQuant Data supported catalog of ~50 U.S. macro indicators — Inflation (CPI / PCE), Rates (Fed Funds, Treasury yields), Labor (UNRATE, payrolls), Growth (GDP), Housing, Liquidity (M2, Fed balance sheet), Financial Conditions, FX, and more. Use it as a catalog discovery step: when an agent needs to figure out which indicator alias or series_id to feed into macro_indicator_history / macro_indicator_snapshot, call this tool first to browse the catalog by category, frequency, or free-text keyword. It does not expose every possible macro series — only the curated, attribution-cleared supported catalog. Call with no parameters to list everything.

​
Response

​
data
MacroIndicatorCatalogItem[]
required
Curated catalog entries. Each entry is one supported indicator.
​
meta.count
number
Number of items returned.
​
meta.creditsUsed
number
Always 0 — catalog discovery is free.
​
meta.sourceNotice
string
Required source notice string. Display when showing macro data.
200 OK · macro_indicator_search
{
  "data": [
    {
      "indicator": "us.cpi.headline",
      "series_id": "CPIAUCSL",
      "title": "Consumer Price Index for All Urban Consumers: All Items in U.S. City Average",
      "category": "Inflation",
      "frequency": "Monthly",
      "units": "Index 1982-1984=100",
      "observation_start": "1947-01-01",
      "observation_end": "2026-03-01",
      "copyright_status": "Public Domain: Citation requested",
      "attribution": "Source: U.S. Bureau of Labor Statistics via FRED"
    },
    {
      "indicator": "us.unemployment_rate",
      "series_id": "UNRATE",
      "title": "Unemployment Rate",
      "category": "Labor",
      "frequency": "Monthly",
      "units": "Percent",
      "observation_start": "1948-01-01",
      "observation_end": "2026-03-01",
      "copyright_status": "Public Domain: Citation requested",
      "attribution": "Source: U.S. Bureau of Labor Statistics via FRED"
    }
  ],
  "meta": {
    "count": 2,
    "creditsUsed": 0,
    "sourceNotice": "This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis."
  }
}

​
Notes

Two-step pattern: call macro_indicator_search first (free) to find the right alias, then macro_indicator_history (1 credit) for time series or macro_indicator_snapshot (1 credit) for the latest print. Catalog calls don’t burn credits, so call freely.
Prefer the platform indicator alias (us.cpi.headline) over raw series_id (CPIAUCSL) — aliases are stable across raw series naming changes and give clearer intent in agent traces.
Supported catalog only. Roughly 50 U.S. macro series. Arbitrary series_id values outside the catalog return 404. If you need a series that isn’t listed, file a request.
Catalog rows are not real-time: observation_end reflects the latest known release time available to LLMQuant Data, not necessarily today.

​
Direct invocation

{
  "method": "tools/call",
  "params": {
    "name": "macro_indicator_search",
    "arguments": { "category": "Inflation", "limit": 10 }
  }
}

​
Full parameter reference

​
q
string
Free-text keyword. Matches indicator alias, indicator title, and series_id.
​
category
string
Filter by theme. Values: Growth, Consumption, Inflation, Labor, Housing, Rates, Inflation Expectations, Liquidity, Conditions, FX, Credit, Sentiment, Energy.
​
frequency
string
Filter by release cadence. Values: Daily, Weekly, Monthly, Quarterly, Annual.
​
limit
number
default:20
Max items returned. Range 1–100.

Macro Historical

Time-series observations for one indicator (Recent or Range mode).

Macro Snapshot

Latest print + previous value + delta for one indicator.