building_permits_movers
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_movers for the schema, then POST the same URL with its arguments for the data.
Rank US counties or states by change in residential building permits between two periods of the SAME period_type, from the US Census Bureau Building Permits Survey. Default compares the period with the same month (or year) one year earlier, which removes seasonality. Choose metric (units, buildings or value), structure size (total, 1_unit, 2_units, 3_4_units, 5_plus_units), basis (estimated including imputation, or reported only), direction (up or down) and a minimum base so tiny counties do not dominate. Geographies present in only one of the two periods (such as Connecticut counties against planning regions) are excluded and counted, never joined.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
level | string | no | Geography level to rank (default county). |
compare_to | string | no | Comparison period, same format as period. Default: one year before period. |
metric | string | no | What to rank on (default units). |
structure | string | no | Structure size (default total). |
basis | string | no | estimated = reported plus imputed (default); reported = respondents only. |
direction | string | no | up = largest increases first (default), down = largest decreases first. |
state | string | no | Restrict county ranking to one state. |
min_base | number | no | Minimum comparison-period value, in the metric’s own unit (default 100 for units and buildings, 10,000,000 for value). |
limit | number | no | Rows to return (1-100, default 20). |
Example call
Arguments
{
"level": "county",
"period_type": "monthly",
"period": "2026-09",
"metric": "units",
"direction": "up",
"limit": 10
}
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_movers","arguments":{"level":"county","period_type":"monthly","period":"2026-09","metric":"units","direction":"up","limit":10}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('building_permits_movers', {
"level": "county",
"period_type": "monthly",
"period": "2026-09",
"metric": "units",
"direction": "up",
"limit": 10
});
Response shape
| Field | Type | Description |
|---|---|---|
period_type | string | |
period | string | |
compared_to | string | |
level | string | |
metric | string | |
structure | string | |
basis | string | |
direction | string | |
min_base | number | |
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"
},
"compared_to": {
"type": "string"
},
"level": {
"type": "string"
},
"metric": {
"type": "string"
},
"structure": {
"type": "string"
},
"basis": {
"type": "string"
},
"direction": {
"type": "string"
},
"min_base": {
"type": "number"
},
"count": {
"type": "number"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"current": {
"type": "number"
},
"previous": {
"type": "number"
},
"change": {
"type": "number"
},
"change_pct": {
"type": "number"
},
"current_file_vintage": {
"type": "string"
},
"previous_file_vintage": {
"type": "string"
},
"current_revisions": {
"type": "number"
},
"previous_revisions": {
"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.