API and MCP server

Plug the disclosed building-energy record into your own systems and AI tools. The MCP server answers anyone in public mode; full records, the REST API, the change feed and webhooks come with Enterprise.

MCP server (AI tools)

Connect BuildingCensus to Claude, ChatGPT or your own agent. The server is https://buildingcensus.com/api/mcp (Streamable HTTP). Without a key it answers in public mode: summaries with a link to each record, 5 results per call. With an Enterprise key it returns full records, change history and the change feed.

{
  "mcpServers": {
    "buildingcensus": {
      "type": "http",
      "url": "https://buildingcensus.com/api/mcp",
      "headers": { "Authorization": "Bearer bck_live_…" }
    }
  }
}

Tools: search_buildings, get_buildings, search_office-buildings, get_office-buildings, search_federal-leases, get_federal-leases, recent_changes (Enterprise), about.

REST API (Enterprise)

Create a key under Account → API keys, then send it as Authorization: Bearer bck_live_…. JSON responses; keyset paging with cursor; up to 100 records per page and 120 requests a minute per key.

curl -H "Authorization: Bearer $KEY" \
  "https://buildingcensus.com/api/v1/buildings?state=TX&limit=100"

Endpoint	What it returns
`GET /api/v1`	datasets, filters, your limits
`GET /api/v1/buildings`	City and state building-energy benchmarking disclosures, one row per building per report year: ENERGY STAR score, site and source EUI, GHG emissions and intensity, floor area, property type, year built and reported owner. Filters: `statecitybuilding_keyslug_hash` · `q` = name prefix
`GET /api/v1/office-buildings`	Office-class parcels in the covered metros from county assessment rolls: recorded owner, use code, floors, building area, assessed values, year built and last sale. Filters: `metrocityzipowner_keyproperty_key` · `q` = name prefix
`GET /api/v1/federal-leases`	Active U.S. General Services Administration (GSA) leases: annual rent paid, rentable square feet, effective and expiration dates, renewal options and lessor. Filters: `statecountycityzipfolio` · `q` = name prefix
`GET /api/v1/buildings/{id}`	one building disclosure + its last 20 changes
`GET /api/v1/office-buildings/{id}`	one office building + its last 20 changes
`GET /api/v1/federal-leases/{id}`	one federal lease + its last 20 changes
`GET /api/v1/changes`	change feed: new, updated, removed records (`dataset`, `after_id`, `since`)

Bulk files and webhooks

Enterprise includes every national and state file (gzipped CSV, refreshed weekly), and any alert can post to your webhook, signed with X-Census-Signature: t=…,v1=HMAC-SHA256(secret, t.body).