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

NameTypeRequiredDescription
levelstringnoGeography level to rank (default county).
compare_tostringnoComparison period, same format as period. Default: one year before period.
metricstringnoWhat to rank on (default units).
structurestringnoStructure size (default total).
basisstringnoestimated = reported plus imputed (default); reported = respondents only.
directionstringnoup = largest increases first (default), down = largest decreases first.
statestringnoRestrict county ranking to one state.
min_basenumbernoMinimum comparison-period value, in the metric’s own unit (default 100 for units and buildings, 10,000,000 for value).
limitnumbernoRows 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

FieldTypeDescription
period_typestring
periodstring
compared_tostring
levelstring
metricstring
structurestring
basisstring
directionstring
min_basenumber
countnumber
rowsarray
notesarray
sourcestring
licencestring
data_as_ofstring
refreshed_atstring
coveragestring
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.

Regenerated from source · build November 20, 2026