building_permits_state
Pack: building-permits · 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/building_permits_state for the schema, then POST the same URL with its arguments for the data.
US residential building permits by state for one period, from the US Census Bureau Building Permits Survey: buildings, units and value in dollars by structure size, estimated including imputation and reported only. Omit state for all 50 states plus DC; set include_aggregates to also get the United States total, the 4 Census regions and 9 divisions (ids US, R1-R4, D1-D9). Every row carries period_type, period, file_vintage and revisions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
state | string | no | State as 2-digit FIPS, postal abbreviation or name (or US for the national total). Omit for every state. |
include_aggregates | boolean | no | Also return US, region and division totals (default false). |
Example call
Arguments
{
"state": "TX",
"period_type": "year_to_date",
"period": "2026-09"
}
curl
curl -X POST https://gateway.pipeworx.io/building-permits/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"building_permits_state","arguments":{"state":"TX","period_type":"year_to_date","period":"2026-09"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('building_permits_state', {
"state": "TX",
"period_type": "year_to_date",
"period": "2026-09"
});
Response shape
| Field | Type | Description |
|---|---|---|
period_type | string | |
period | string | |
count | number | |
rows | array | |
notes | array | |
source | string | |
licence | string | |
data_as_of | string | |
refreshed_at | string | |
coverage | string |
Full JSON Schema
{
"type": "object",
"properties": {
"period_type": {
"type": "string"
},
"period": {
"type": "string"
},
"count": {
"type": "number"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"geography": {
"type": "object",
"properties": {
"level": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"state_fips": {
"type": "string"
}
},
"additionalProperties": true
},
"period_type": {
"type": "string"
},
"period": {
"type": "string"
},
"file_vintage": {
"type": "string"
},
"revisions": {
"type": "number"
},
"estimated_including_imputation": {
"type": "object",
"properties": {
"total": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"by_structure": {
"type": "object",
"properties": {
"1_unit": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"2_units": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"3_4_units": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"5_plus_units": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"reported_only": {
"type": "object",
"properties": {
"total": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"by_structure": {
"type": "object",
"properties": {
"1_unit": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"2_units": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"3_4_units": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
},
"5_plus_units": {
"type": "object",
"properties": {
"buildings": {
"type": "number"
},
"units": {
"type": "number"
},
"value_usd": {
"type": "number"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"imputed_units": {
"type": "number"
},
"imputed_value_usd": {
"type": "number"
}
},
"additionalProperties": true
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"type": "string"
},
"licence": {
"type": "string"
},
"data_as_of": {
"type": "string"
},
"refreshed_at": {
"type": "string"
},
"coverage": {
"type": "string"
}
},
"additionalProperties": true
}
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 building-permits pack
{
"mcpServers": {
"building-permits": {
"url": "https://gateway.pipeworx.io/building-permits/mcp"
}
}
}
See Getting Started for client-specific install steps.