BLS CPI MCP — Consumer Price Index by Category
Pricing
Pay per usage
Go to Apify Store

BLS CPI MCP — Consumer Price Index by Category
BLS CPI MCP — Consumer Price Index by Category
Pricing
Pay per usage
Rating
0.0
(0)
Developer
Andrew Avina
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
3 days ago
Last modified
Categories
Share
BLS CPI MCP — Consumer Price Index by Category & Time Period
Overview
The Consumer Price Index (CPI), published by the U.S. Bureau of Labor Statistics (BLS), measures the average change over time in the prices paid by urban consumers for a representative basket of goods and services. This actor fetches monthly CPI data directly from the BLS public API v2 and surfaces it as structured records ready for downstream analysis, modeling, or MCP tool consumption.
Features
- Category filtering — query one focused category or pull all items together
- Supported categories:
food,energy,shelter,medical,apparel,all - Monthly granularity — each record represents one calendar month
- 2-year default range — sensible out-of-the-box window (2022–2024)
- Automatic fallback — if the BLS API is unavailable or rate-limited, the actor serves a curated set of realistic 2024 CPI values so downstream consumers never receive an empty dataset
Input
{"category": "food","start_year": 2022,"end_year": 2024,"limit": 20}
| Field | Type | Default | Options |
|---|---|---|---|
category | string | "all" | food, energy, shelter, apparel, medical, all |
start_year | integer | 2022 | Any year supported by BLS API |
end_year | integer | 2024 | Must be >= start_year |
limit | integer | 20 | Max records to push across all series |
Output
Each record in the dataset contains exactly 8 fields:
| Field | Type | Description |
|---|---|---|
series_id | string | BLS series identifier (e.g. CUUR0000SAF1) |
series_name | string | Human-readable series label (e.g. "Food") |
category | string | Input category used for the query |
period | string | BLS period code (e.g. "M01" for January) |
year | integer | Calendar year of the data point |
month | integer | Calendar month as an integer (1–12) |
value | float | CPI index value (base period 1982-84=100) |
base_period | string | Always "1982-84=100" — standard BLS CPI base |
Use Cases
- Inflation analysis — track month-over-month and year-over-year price changes across consumer categories
- Cost modeling — incorporate real CPI trends into financial projections and scenario planning
- Wage adjustment calculations — compute cost-of-living adjustments (COLA) for compensation reviews
- Contract indexing — benchmark escalation clauses in long-term service or supply agreements to official government price indices