# macro_list_recent_updates List macro series whose ingested observations changed after a timestamp. | Field | Value | | --- | --- | | Category | Macro (`macro`) | | Exposure | public | | MCP tool | `macro_list_recent_updates` | | Documentation | https://www.agentdatasets.com/docs/tools/macro_list_recent_updates | ## Description List macro series whose ingested observations changed after a timestamp. Use this as a cheap "what changed?" poll instead of re-pulling every tracked series. The result is the shared envelope: `data.since` and `data.source` echo the filter, `data.updates` is the bounded newest-first page, `meta` holds `source` ("macro_catalog") and the freshest `updated_at` on the page, and `pagination` holds the cursor paging state. Each update row carries `series_key`, `source`, `title`, `units`, `currency`, `frequency`, `seasonal_adjustment`, `geography`, `updated_at`, and `latest_observation`. `updated_at` is when we ingested the newest change for that series — insert or revision — and can postdate `latest_observation.as_of` when an older period was revised. `latest_observation` is only the newest period summary; call `macro_get_series` with the returned `series_key` for full history. Bounds: default `limit` 100, max 500. Ordering is `updated_at` descending, then `series_key` ascending for ties. To page, pass `pagination.next_cursor` back as `cursor` while keeping `since` and `source` unchanged; a series that receives *another* update while you are mid-pagination can move ahead of your cursor and drop out of the current pass — it surfaces on your next poll, since its `updated_at` just got newer. Errors carry a machine `code`: `bad_parameter` for a naive/malformed `since`, malformed cursor, or out-of-range limit. Example: `macro_list_recent_updates(since="2026-07-01T00:00:00Z", source="bls", limit=100)`. ## Parameters Input schema advertised to MCP clients and mirrored by the REST query string. | Parameter | In | Type | Required | Default | Constraints | Description | | --- | --- | --- | --- | --- | --- | --- | | since | input | `string (date-time)` | yes | — | — | RFC 3339 timestamp with timezone offset. Returns series whose freshest observation-level as_of is strictly after this timestamp; poll by passing the max updated_at from your previous call. | | source | input | `"treasury" \| "bls" \| "bea" \| "ecb" \| "frb" \| "usaspending" \| "eurostat" \| "census" \| null` | no | null | — | Optional agency filter (`treasury`, `bls`, `bea`, `ecb`, `frb`, `usaspending`, or `eurostat`). `frb` covers Federal Reserve Board H.15/PRATES policy and market rates, H.4.1 balance-sheet levels, H.8 bank credit, G.17/G.19 activity and credit, and SLOOS credit conditions. Omit for all macro sources. | | limit | input | `integer` | no | 100 | min 1, max 500 | Updated series rows to return, newest first (1–500). | | cursor | input | `string \| null` | no | null | — | Opaque pagination cursor from a previous response's `pagination.next_cursor`; keep `since` and `source` constant while paging. Omit to start from the newest update. | ## Provenance - `bea` — U.S. Bureau of Economic Analysis, NIPA table lines: GDP (growth/nominal/chained), personal consumption expenditures, personal income, PCE price indexes (U.S. Government work, public domain (us-gov-public-domain)). See https://www.agentdatasets.com/docs/attribution.md - `bls` — U.S. Bureau of Labor Statistics, CPI (headline/core, seasonally adjusted/not adjusted), PPI final demand, unemployment, labor-force participation, nonfarm payrolls, average hourly earnings (U.S. Government work, public domain (us-gov-public-domain)). See https://www.agentdatasets.com/docs/attribution.md - `ecb` — European Central Bank, Ten curated ECB key-interest-rate, €STR, and euro-area AAA central-government yield-curve spot-rate series (ECB information reuse terms (ecb-reuse)). See https://www.agentdatasets.com/docs/attribution.md - `eurostat` — Eurostat, Curated euro-area price, activity and labour series (Creative Commons Attribution 4.0 International (CC BY 4.0)). See https://www.agentdatasets.com/docs/attribution.md - `frb` — Board of Governors of the Federal Reserve System, Curated H.15 and PRATES policy/market rates plus FOMC federal-funds target-range levels (U.S. Government work, public domain (us-gov-public-domain)). See https://www.agentdatasets.com/docs/attribution.md - `macro_catalog` — Curated internal catalog (Treasury, BLS, BEA, FRB, USAspending, Eurostat), Discovery catalog for macro series search (`series_catalog.yaml`) spanning Treasury, BLS, BEA, Federal Reserve Board, USAspending, and Eurostat series metadata; a matched series' own `source` still carries its originating agency (Aggregates U.S. Government public-domain series and Eurostat CC BY 4.0 series (see the source-specific entries); the catalog identifier itself carries no separate license). See https://www.agentdatasets.com/docs/attribution.md - `treasury` — U.S. Department of the Treasury, Daily par yield curve (11 tenors), Debt to the Penny, and average interest rates on Treasury securities (U.S. Government work, public domain (us-gov-public-domain)). See https://www.agentdatasets.com/docs/attribution.md - `usaspending` — U.S. Department of the Treasury, USAspending.gov, Agency and government-wide federal contract and assistance obligation totals by fiscal year and fiscal quarter (U.S. Government work, public domain (us-gov-public-domain)). See https://www.agentdatasets.com/docs/attribution.md Dataset registry: `macro_bea`, `macro_bls`, `macro_ecb`, `macro_eurostat`, `macro_frb`, `macro_treasury`, `macro_usaspending`.