BLS occupational wage data MCP response
MCP tool response returned by the BLS occupational wage data MCP tool.
- Returned by: BLS occupational wage data MCP tool
- Response type: Structured pricing data
Response Shape
The response is a structured CALC+ payload. Search mode returns normalized rows in items; filters mode returns aggregation-derived option arrays.
| Field | Type | Notes |
|---|---|---|
summary | object | Summary statistics, including median_price and raw wage_stats. |
items | object array | Search-mode rows. Rows flatten source values and may include _id, sort, rate, wage fields, area, state, occupation, and industry values. |
aggregations | object | Raw CALC+ aggregations returned with search results. |
empty | boolean | Whether search mode returned zero rows. |
occupation_names | object array | Filters-mode occupation title options with value and doc_count. |
occupation_codes | object array | Filters-mode occupation code options with value and doc_count. |
occupation_levels | object array | Filters-mode occupation-level options with value and doc_count. |
states | object array | Filters-mode state options with value and doc_count. |
industries | object | Filters-mode industry code and NAICS title buckets. |
areas | object array | Filters-mode paired area options with area_name, normalized_area_name, and doc_count. |
modeling_presets | object | Guide-derived modeling defaults, such as occupation-level percentile mappings and escalation options. |
Example
{
"summary": {
"median_price": 78.42,
"wage_stats": {
"count": 12,
"min": 62.15,
"max": 91.8
}
},
"items": [
{
"_id": "BLS_ROW_ID",
"rate": 78.42,
"occupation_name": "Software Developers",
"occupation_code": "15-1252",
"state_name": "Virginia",
"area_name": "Washington-Arlington-Alexandria, DC-VA-MD-WV"
}
],
"aggregations": {},
"empty": false,
"occupation_names": [],
"occupation_codes": [],
"occupation_levels": [],
"states": [],
"industries": {},
"areas": [],
"modeling_presets": {}
}