building_permits_county
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_county for the schema, then POST the same URL with its arguments for the data.
US residential building permits for a county (for Connecticut, a county or planning region), from the US Census Bureau Building Permits Survey: buildings, housing units and construction value in dollars for 1-unit, 2-unit, 3-4 unit and 5+ unit structures, estimated including imputation and reported only. Give county_fips (5 digits, e.g. “06037”) for one county, or a state (optionally with a county name fragment) to list its counties for one period. Group on FIPS, not names. Every row carries period_type, period, file_vintage and revisions. Connecticut rows carry geography_vintage: counties and planning regions are different boundaries and are never joined.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
county_fips | string | no | 5-digit county FIPS (state + county), e.g. “06037” for Los Angeles County. |
state | string | no | State as 2-digit FIPS, postal abbreviation or name; lists that state’s counties when county_fips is omitted. |
name | string | no | County name fragment to filter the state listing (e.g. “Harris”). |
limit | number | no | Max counties when listing a state (1-300, default 100). |
Example call
Arguments
{
"county_fips": "48201",
"period_type": "monthly",
"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_county","arguments":{"county_fips":"48201","period_type":"monthly","period":"2026-09"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('building_permits_county', {
"county_fips": "48201",
"period_type": "monthly",
"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"
},
"state": {
"type": "string"
},
"county_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.