`census_homeownership`

Pack: census · 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/census_homeownership for the schema, then POST the same URL with its arguments for the data.

US homeownership rate and housing vacancy rates by quarter, from the Census Housing Vacancy Survey (HVS) — the official source. Returns headline (the national homeownership rate as a percent) plus the rental and homeowner vacancy rates. Defaults to the latest published quarter.

Parameters

Name	Type	Required	Description
`time`	string	no	Quarter as “YYYY-QN” (e.g. “2026-Q1”). Defaults to the latest published quarter.
`_apiKey`	string	no	Census API key

Example call

Arguments

{
  "time": "2024-Q1",
  "_apiKey": "your-census-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/census/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"census_homeownership","arguments":{"time":"2024-Q1","_apiKey":"your-census-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('census_homeownership', {
  "time": "2024-Q1",
  "_apiKey": "your-census-api-key"
});

More examples

{
  "time": "from+2020-Q1+to+2024-Q1",
  "_apiKey": "your-census-api-key"
}

Response shape

Always returns: metric, time, results

Field	Type	Description
`metric`	string	Metric type
`time`	string	Time period queried
`results`	array	Array of homeownership rate records

Full JSON Schema

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "enum": [
        "homeownership_rate"
      ],
      "description": "Metric type"
    },
    "time": {
      "type": "string",
      "description": "Time period queried"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "Homeownership rate data rows"
      },
      "description": "Array of homeownership rate records"
    }
  },
  "required": [
    "metric",
    "time",
    "results"
  ]
}

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 census pack

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

See Getting Started for client-specific install steps.

census_homeownership