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

NameTypeRequiredDescription
statestringnoState as 2-digit FIPS, postal abbreviation or name (or US for the national total). Omit for every state.
include_aggregatesbooleannoAlso 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

FieldTypeDescription
period_typestring
periodstring
countnumber
rowsarray
notesarray
sourcestring
licencestring
data_as_ofstring
refreshed_atstring
coveragestring
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.

Regenerated from source · build November 20, 2026