`housing_employment_outlook`

Pack: housing-intel · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/housing_employment_outlook for the schema, then POST the same URL with its arguments for the data.

Assess labor market health for housing demand. Returns employment, construction jobs, residential building employment, unemployment rate, and job openings. All BLS monthly releases; each series carries its own observation_date and cadence (JOLTS runs an extra month behind CES/LAUS), and freshness states the span. snapshot_date is the call date, not the data date.

Parameters

Name	Type	Required	Description
`_fredKey`	string	no	FRED API key (accepted for consistency but not used — BLS is free)
`_blsKey`	string	no	BLS registration key (optional — raises the shared quota; https://data.bls.gov/registrationEngine/)

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/housing-intel/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"housing_employment_outlook","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('housing_employment_outlook', {});

Response shape

Field	Type	Description
`snapshot_date`	string \| null	Today’s date in YYYY-MM-DD format
`total_nonfarm`	object
`construction`	object
`residential_building`	object
`unemployment_rate`	object
`jolts_openings`	object
`jolts_hires`	object
`freshness`	object

Full JSON Schema

{
  "type": "object",
  "properties": {
    "snapshot_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Today's date in YYYY-MM-DD format"
    },
    "total_nonfarm": {
      "type": "object",
      "properties": {
        "current": {
          "type": "number"
        },
        "observation_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "cadence": {
          "type": "string"
        },
        "trend": {
          "type": "string"
        },
        "recent_data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "construction": {
      "type": "object",
      "properties": {
        "current": {
          "type": "number"
        },
        "observation_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "cadence": {
          "type": "string"
        },
        "trend": {
          "type": "string"
        },
        "recent_data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "residential_building": {
      "type": "object",
      "properties": {
        "current": {
          "type": "number"
        },
        "observation_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "cadence": {
          "type": "string"
        },
        "trend": {
          "type": "string"
        },
        "recent_data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "unemployment_rate": {
      "type": "object",
      "properties": {
        "current": {
          "type": "number",
          "description": "Unemployment rate (percent)"
        },
        "observation_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "cadence": {
          "type": "string"
        },
        "trend": {
          "type": "string"
        },
        "recent_data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "jolts_openings": {
      "type": "object",
      "properties": {
        "current": {
          "type": "number"
        },
        "observation_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "cadence": {
          "type": "string"
        },
        "trend": {
          "type": "string"
        },
        "recent_data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "jolts_hires": {
      "type": "object",
      "properties": {
        "current": {
          "type": "number"
        },
        "observation_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "unit": {
          "type": "string"
        },
        "cadence": {
          "type": "string"
        },
        "trend": {
          "type": "string"
        },
        "recent_data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string"
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "freshness": {
      "type": "object",
      "properties": {
        "as_of": {
          "type": "string"
        },
        "span_days": {
          "type": "number"
        },
        "statement": {
          "type": "string"
        }
      }
    }
  }
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the housing-intel pack

{
  "mcpServers": {
    "housing-intel": {
      "url": "https://gateway.pipeworx.io/housing-intel/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

housing_employment_outlook