housing_market_snapshot
Pack: housing-intel · Endpoint: https://gateway.pipeworx.io/housing-intel/mcp
Get national housing market overview: mortgage rates, housing starts, Case-Shiller index, unemployment, construction employment. Optionally add metro-level prices (e.g., “Denver”, “Atlanta”). For comparing Case-Shiller across multiple metros use case_shiller_metro_compare instead. THE COMPONENTS DO NOT SHARE A DATE — they are weekly, monthly and quarterly official statistics, each published on its own lag, so one call can span months of vintages. freshness states the span in days and names the oldest component; read it before comparing components against each other.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_fredKey | string | no | FRED API key (https://fred.stlouisfed.org/docs/api/api_key.html) |
_blsKey | string | no | BLS registration key (optional — raises the shared quota; https://data.bls.gov/registrationEngine/) |
metro_name | string | no | Metro area name for metro-level FHFA HPI (e.g., “Denver”, “Atlanta”). Supports top 50 US metros. National data is always included. |
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_market_snapshot","arguments":{}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('housing_market_snapshot', {});More examples
{
"metro_name": "Denver"
}Response shape
| Field | Type | Description |
|---|---|---|
snapshot_date | string | Today’s date in YYYY-MM-DD format |
metro | string | Metro name or ‘National’ |
note | string | Explanation of data scope and sources |
mortgage_rate | object | |
housing_starts | object | |
case_shiller | object | |
unemployment | object | |
owners_equiv_rent | object | |
construction_employment | object | |
metro_hpi | object | null | |
zillow | object |
Full JSON Schema
{
"type": "object",
"properties": {
"snapshot_date": {
"type": "string",
"description": "Today's date in YYYY-MM-DD format"
},
"metro": {
"type": "string",
"description": "Metro name or 'National'"
},
"note": {
"type": "string",
"description": "Explanation of data scope and sources"
},
"mortgage_rate": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Current 30-year mortgage rate (percent)"
},
"4wk_ago": {
"type": "number",
"description": "Mortgage rate 4 weeks ago"
},
"trend": {
"type": "string",
"enum": [
"rising",
"falling",
"stable"
]
},
"error": {
"type": "string",
"description": "Error message if data unavailable"
}
}
},
"housing_starts": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Latest housing starts in thousands"
},
"unit": {
"type": "string",
"enum": [
"thousands"
]
},
"3mo_trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO date YYYY-MM-DD"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"case_shiller": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Latest Case-Shiller index value"
},
"3mo_trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"unemployment": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Current unemployment rate (percent)"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"owners_equiv_rent": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Owners' equivalent rent index"
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"construction_employment": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"national"
]
},
"current": {
"type": "number",
"description": "Construction employment in thousands"
},
"unit": {
"type": "string",
"enum": [
"thousands"
]
},
"trend": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"error": {
"type": "string"
}
}
},
"metro_hpi": {
"type": [
"object",
"null"
],
"properties": {
"series": {
"type": "string",
"description": "FRED series ID for metro FHFA HPI"
},
"metro": {
"type": "string",
"description": "Metro name"
},
"current": {
"type": "number",
"description": "Latest metro HPI value"
},
"trend": {
"type": "string",
"enum": [
"rising",
"falling",
"stable"
]
},
"recent_data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"yoy": {
"type": "object",
"properties": {
"change": {
"type": "number",
"description": "Year-over-year absolute change"
},
"pctChange": {
"type": "number",
"description": "Year-over-year percent change"
}
}
},
"error": {
"type": "string"
}
}
},
"zillow": {
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"metro",
"national"
],
"description": "Whether data is metro-specific or national"
},
"region": {
"type": "string",
"description": "Region name (CBSA label or 'National')"
},
"home_value_index": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "ISO date of observation"
},
"value": {
"type": [
"number",
"null"
],
"description": "ZHVI value in USD"
},
"note": {
"type": "string",
"description": "Description of metric"
}
}
},
"rent_index": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "ZORI value in USD/month"
},
"note": {
"type": "string"
}
}
},
"median_sale_price": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "Weekly median sale price in USD"
},
"note": {
"type": "string"
}
}
},
"sales_count": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "Monthly sales count"
},
"note": {
"type": "string"
}
}
},
"inventory": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "For-sale inventory (smoothed)"
},
"note": {
"type": "string"
}
}
},
"new_listings": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
],
"description": "Monthly new listings"
},
"note": {
"type": "string"
}
}
},
"error": {
"type": "string",
"description": "Error message if Zillow data unavailable"
}
}
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"housing-intel": {
"url": "https://gateway.pipeworx.io/housing-intel/mcp"
}
}
}See Getting Started for client-specific install steps.