FHFA House Price Index MCP

Label: FHFA | Sublabel: HOUSE PRICE

A government data intelligence actor that serves Federal Housing Finance Agency (FHFA) House Price Index (HPI) data for U.S. metros, states, and nationally. Runs as a one-shot Apify dataset actor or as a persistent HTTP MCP server for AI agent and mortgage market analysis integration.

---

What This Actor Does

• Queries the FHFA open data portal (data.fhfa.gov) for HPI records
• Supports annual and quarterly HPI at the metro (MSA), state, and national level
• Provides HPI index values (base Q1 1991 = 100) and year-over-year percentage changes
• Falls back to a curated dataset of 20 real FHFA HPI records if the live API is unavailable
• Exposes an MCP tool (query_fhfa_hpi) for AI agent integration

---

What Is the FHFA HPI?

The FHFA House Price Index is the most comprehensive and broadly cited measure of U.S. residential house prices. It tracks changes in the value of single-family homes based on repeat-sales data from Fannie Mae and Freddie Mac conventional conforming mortgages. The HPI is base-indexed to Q1 1991 = 100.

Current national HPI (2023): approximately 462.8 — meaning average prices have risen ~362% since 1991.

---

Output Fields

Field	Description
metro_or_state	Metro area name or state name
period	Year (annual) or year+quarter (e.g. 2023Q3)
hpi_index	FHFA HPI value (base 100 = Q1 1991)
hpi_change_pct	Year-over-year change in percent
area_type	MSA, State, or National
source	Always "FHFA HPI"

---

Input Parameters

Parameter	Type	Default	Description
area	string	(blank)	Metro or state name (e.g. "Los Angeles", "Texas")
periodType	string	annual	Data frequency: annual or quarterly
year	integer	(blank)	Filter to specific year (e.g. 2023)
limit	integer	50	Max records to return (1–500)
serveMcp	boolean	false	Start HTTP MCP server on port 4321

---

Usage Modes

Batch Mode (default)

Run with serveMcp: false. The actor queries the FHFA open data API, normalizes results, and pushes records to an Apify dataset.

Example input — top metros annual 2023:

{
  "periodType": "annual",
  "year": 2023,
  "limit": 50,
  "serveMcp": false
}

Example input — specific metro quarterly:

{
  "area": "Phoenix",
  "periodType": "quarterly",
  "limit": 20,
  "serveMcp": false
}

MCP Server Mode

Set serveMcp: true. The actor starts an HTTP server on port 4321 and exposes:

• GET / — Health check (label: "FHFA", sublabel: "HOUSE PRICE")
• GET /mcp/tools — List available MCP tools
• POST / — Execute a tool call ({"tool": "query_fhfa_hpi", "arguments": {...}})

---

Data Source

Federal Housing Finance Agency (FHFA)

• Open Data Portal: https://data.fhfa.gov
• HPI Dataset: https://data.fhfa.gov/api/explore/v2.1/catalog/datasets/hpi-master/records
• Published quarterly; no API key required for public access
• Official source: fhfa.gov/DataTools/Downloads/Pages/House-Price-Index.aspx

---

Fallback Dataset

The curated fallback contains 20 real FHFA HPI records for 2023:

Area	HPI Index	YoY Change
New York-Newark-Jersey City	452.3	+5.8%
Los Angeles-Long Beach-Anaheim	612.7	+4.2%
Chicago-Naperville-Elgin	348.1	+6.1%
Houston-The Woodlands-Sugar Land	389.4	+3.7%
Phoenix-Mesa-Chandler	524.6	+2.1%
Miami-Fort Lauderdale-Pompano Beach	539.6	+8.4%
Dallas-Fort Worth-Arlington	445.2	+2.8%
Austin-Round Rock-Georgetown	511.8	-3.9%
Seattle-Tacoma-Bellevue	558.9	+4.0%
United States (National)	462.8	+5.5%
...and 10 more metros/states

---

Use Cases

• Real estate market intelligence and investment analysis
• Mortgage market research and risk modeling
• AI-powered housing affordability analysis
• Geographic comparison of price appreciation trends
• Integration with MCP-compatible AI assistants for real-time housing Q&A

---

Categories

MCP_SERVERS | BUSINESS