Macro Calendar (CPI / PCE / EMPLOYMENT / GDP / FOMC — forward macro release dates, PIT-by-construction)
macro_calendarForward (or trailing) calendar of major US macro releases — CPI, PCE, EMPLOYMENT (payrolls + unemployment), GDP, FOMC meetings, and EIA weekly energy inventories (WPSR crude Wed + natural-gas storage Thu). The macro counterpart to upcoming_earnings and catalyst_calendar. Use to answer 'what macro prints are coming in the next N days' / 'when was the last FOMC' / 'is CPI in this window.'
PIT semantics: PIT-by-construction. Major-release schedules are published ~1 year in advance, so filtering release_date > as_of IS 'as known then.' Response echoes as_of_effective = as_of (no resolution needed). Reference implementation parity with sec_power_supply_curve and the rest of the as_of-honored catalog.
Inputs (all optional):
window_days— forward window in days fromas_of(default 30, max 365).as_of— YYYY-MM-DD reference date (default today).categories— restrict to one or more of {CPI, PCE, EMPLOYMENT, GDP, FOMC, EIA_PETROLEUM, EIA_NATGAS}. Omit for all.include_passed— when true, returns a TRAILINGwindow_dayswindow (release_date in [as_of - window_days, as_of]). Default false (forward-only).limit— max rows returned (default 50, max 500).
Coverage: 5,383 release dates, 1947 → 2028. FOMC schedule is static (synthesized from FOMC's published meeting calendar; release_id = -1 on those rows); CPI/PCE/EMPLOYMENT/GDP come from FRED's release calendar. EIA weekly inventories now covered (added 2026-07-11): EIA_PETROLEUM (WPSR, Wed 10:30 ET) + EIA_NATGAS (gas storage, Thu 10:30 ET), 2010 → 2028, generated from EIA's pre-announced weekly schedule with federal-holiday shifts (PIT-by-construction, source='eia_static'). Release DATES only — inventory values live with the stock-data / prices feeds. Rare stacked-holiday weeks are a documented ±1d approximation.
Response shape: list of {category, release_name, release_date, source, release_id} rows sorted by release_date. Plus as_of_effective (= as_of), window (resolved bounds), n_returned.
Verified live (FRED team smoke goldens 2026-06-14): 30d after 2025-01-01 returns EMPLOYMENT 2025-01-10 + CPI 2025-01-15 + FOMC 2025-01-29 + GDP 2025-01-30 + PCE 2025-01-31. CPI as known on 2025-01-01, next 3: 2025-01-15 / 2025-02-12 / 2025-03-12.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "macro_calendar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Reference date YYYY-MM-DD (default today). | |
| limit | No | Max rows returned (default 50, max 500). | |
| categories | No | Restrict to one or more categories. Omit for all. | |
| window_days | No | Forward window in days from as_of (default 30, max 365). | |
| include_passed | No | When true, returns a TRAILING window [as_of - window_days, as_of] instead of the default forward window (as_of, as_of + window_days]. Default false. |