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 items, summary and empty by default; filters mode returns discovery options, summary and modeling_presets.
fields_to_return selects top-level fields for the chosen mode. In search mode, include aggregations explicitly to receive raw CALC+ aggregations. item_fields_to_return selects attributes inside each items row and is available only in search mode. When using it, include items in fields_to_return or omit fields_to_return to keep the default envelope.
| 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 in search mode only when explicitly selected. |
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
Search-mode 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"
}
],
"empty": false
}