building_permits_place
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_place for the schema, then POST the same URL with its arguments for the data.
US residential building permits for a permit-issuing place (city, town, township), from the US Census Bureau Building Permits Survey. Identify a place by place_id (8 digits: 2-digit state FIPS plus the Census 6-digit place id) or by state plus a name fragment; a name matching several places returns the candidates instead of guessing. Monthly place rows carry the publisher source_code (5 = no report received, values imputed; 9 = no report and no imputation, so zeros mean unknown); annual and year_to_date rows carry months_reporting and reported_only beside the imputed estimate. Every row carries period_type, period, file_vintage and revisions.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
place_id | string | no | 8-digit place id (state FIPS + 6-digit Census place id); get it from a state + name search. |
state | string | no | State as 2-digit FIPS, postal abbreviation or name (required with name). |
name | string | no | Place name fragment, e.g. “Austin”. |
limit | number | no | Max candidates (1-100, default 25). |
Example call
Arguments
{
"place_id": "48033000",
"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_place","arguments":{"place_id":"48033000","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_place', {
"place_id": "48033000",
"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"
},
"place_id": {
"type": "string"
},
"county_fips": {
"type": "string"
},
"fips_place": {
"type": "string"
},
"fips_mcd": {
"type": "string"
},
"population_2000_basis": {
"type": "number"
}
},
"additionalProperties": true
},
"period_type": {
"type": "string"
},
"period": {
"type": "string"
},
"file_vintage": {
"type": "string"
},
"revisions": {
"type": "number"
},
"source_code": {
"type": "number"
},
"source_note": {
"type": "string"
},
"imputed": {
"type": "boolean"
},
"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": "null"
}
},
"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.