Building Permits by County for a Year: Units and Value by Structure Size (Building Permits Survey)

uspermits/get-county-permits

A byte window of the Building Permits Survey annual county file for one year (2000 to 2025): for each county, the buildings, housing units and valuation in dollars authorized by permits for 1-unit, 2-unit, 3-4 unit and 5-or-more-unit structures, plus the reported-only counts. The file has about 3,030 counties ordered by state then county FIPS and no filter, so the window defaults to the first 50,000 bytes (about 470 rows); at most 500 rows are returned. Send range as bytes=START-END, continue at START plus consumedBytes, and expect the first and last line of a window past the start to be dropped as fragments (counted in droppedLines). The 2023 file is 374,707 bytes. U.S. federal statistics data, served by Eden Engine; not endorsed or certified by the data publisher.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

U.S. Census Bureau

Source: U.S. Census Bureau, Building Permits Survey, annual estimates (www2.census.gov/econ/bps). Served by Eden Engine; not endorsed or certified by the Census Bureau.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "uspermits/get-county-permits" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "uspermits/get-county-permits" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "uspermits/get-county-permits", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "uspermits/get-county-permits", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "string",
      "pattern": "^(20[01][0-9]|202[0-5])$",
      "description": "Calendar year, 2000 to 2025, for example 2023. The newest year may hold partial-year figures."
    },
    "range": {
      "type": "string",
      "default": "bytes=0-49999",
      "pattern": "^bytes=[0-9]{1,7}-[0-9]{1,7}$",
      "description": "Byte window of the county file, written bytes=START-END, for example bytes=50000-99999. Defaults to bytes=0-49999. A start past the end of the file, or an end before the start, is refused as a validation error."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "columns",
    "rowCount",
    "truncated",
    "droppedLines",
    "bytesRead",
    "consumedBytes",
    "rows"
  ],
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": [
            "string",
            "number",
            "null"
          ]
        }
      },
      "description": "One array per row, aligned with columns. Counts are numbers (null when blank); codes, FIPS and names are strings."
    },
    "columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "survey_date, state_fips, [county_fips,] region_code, division_code, name, then 24 counts: one_unit, two_unit, three_four_unit and five_plus_unit, each as _bldgs, _units, _value_usd, followed by the same twelve prefixed reported_."
    },
    "rowCount": {
      "type": "integer",
      "description": "Rows in this answer."
    },
    "bytesRead": {
      "type": "integer",
      "description": "Size of the text the file server returned, in bytes."
    },
    "truncated": {
      "type": "boolean",
      "description": "True when the body held more than 500 rows; the rest are not returned."
    },
    "droppedLines": {
      "type": "integer",
      "description": "Lines dropped because they were fragments of a byte window."
    },
    "consumedBytes": {
      "type": "integer",
      "description": "Bytes of the returned text up to the end of the last row returned; the next window starts at this offset plus the window's own start."
    }
  },
  "additionalProperties": false
}