Skip to content
Gridcensus

API and MCP server

Plug GridCensus into your own models and AI tools. The MCP server answers anyone in public mode; full records, the REST API, the change feed, webhooks and weekly data files come with Enterprise.

Screen a parcel

One call returns what the vet shows for a point and a target load: nearest substations and lines, a dual-feed (N+1) screen, typical service voltage and the transformations to reach it, planned transmission upgrades, queue requests nearby, the serving utility's large-load terms, MW-gated state rules, local moratoria, the nearest grid bottlenecks and county context.

curl -H "Authorization: Bearer gck_live_…"   "https://gridcensus.com/api/v1/screen?lat=32.4487&lng=-99.7331&mw=40"

Built from public data. Substation headroom, bus configuration, short-circuit levels and power-flow results are held by utilities and grid operators under CEII rules; the screen tells you which sites deserve those studies and what to ask for.

EndpointWhat it returns
GET /api/v1/screen
lat, lng (or q = address / town / 'lat,lng'), mw, radius_km (default 25), min_kv (69), feed_km (10), news (1|0)
Screen one parcel: nearest substations and lines, N+1 dual-feed proxy, service voltage + transformations + an order-of-magnitude connection cost, utility-posted load headroom where published, planned transmission upgrades, queue requests nearby, serving utility posture and tariff terms, MW-gated state rules, local moratoria, nearest bottlenecks, county context, nearby candidate sites, datacenters and AI campuses, local news.
GET /api/v1/power
lat, lng, mw, radius_km, min_kv, feed_km
The power part of /screen only — fast, no geocoding or news.
GET /api/v1/geometry/{dataset}/{id}
dataset = transmission-lines | fiber-routes | corridors | blm-rights-of-way
One feature's geometry as GeoJSON.
GET /api/v1/congestion
iso (ERCOT | PJM | NYISO | MISO | SPP | CAISO), limit
Ranked binding transmission constraints per market with severity, binding intervals, shadow prices, and coordinates where the station codes resolve.
GET /api/v1/moratoria
state, status (active | pending | expired)
Local (county / city / township) datacenter moratoria.
GET /api/v1/utility-posture
state, q (utility name)
Curated large-load posture per utility: speed, MW threshold, tariff terms (minimum take, term, collateral, exit fee, docket).
GET /api/v1/state-policy
state, mw
Statewide datacenter posture, incentives and MW thresholds; with mw, whether the build trips them.
GET /api/v1/ai-projects
state
AI datacenter campuses with owner, off-takers and power (Epoch AI Frontier Data Centers, CC-BY).
GET /api/v1/feed
after_id (poll, oldest first) | before_id (page back), limit (≤200), since, states, isos, categories (queue|generation|onsite_power|datacenter|transmission), events, min_mw, min_kv, q, utility, fips, changes_only=1
Project lead feed: new and changed queue requests, planned plants and on-site power (EIA-860M), AI datacenter campuses and transmission upgrades, with sponsor, utility, MW/kV, status and source per item. Refreshed daily.
GET /api/v1/region
state | fips | utility (territory id)
Region report: substation headroom estimate bands and leaders, queue MW by fuel and newest requests, planned upgrades, planned and on-site generation, AI campuses, utility large-load posture and terms, state policy, local moratoria.
GET /api/v1/history/{congestion|moratoria|rankings}
iso (congestion), state (moratoria, rankings)
Monthly series behind the site's trend lines.

MCP server (AI tools)

Connect GridCensus to Claude, ChatGPT or your own agent. The server is https://gridcensus.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": {
    "gridcensus": {
      "type": "http",
      "url": "https://gridcensus.com/api/mcp",
      "headers": { "Authorization": "Bearer gck_live_…" }
    }
  }
}

Tools: search_sites, get_sites, search_datacenters, get_datacenters, search_queue-projects, get_queue-projects, search_brownfields, get_brownfields, search_substations, get_substations, search_transmission-lines, get_transmission-lines, search_transmission-projects, get_transmission-projects, search_headroom-estimates, get_headroom-estimates, search_load-capacity, get_load-capacity, search_utilities, get_utilities, search_counties, get_counties, search_internet-exchanges, get_internet-exchanges, search_fiber-routes, get_fiber-routes, search_parcels, get_parcels, search_corridors, get_corridors, search_blm-rights-of-way, get_blm-rights-of-way, search_wecc-paths, get_wecc-paths, search_queue-by-poi, get_queue-by-poi, search_ercot-constraints, get_ercot-constraints, recent_changes (Enterprise), about.

REST API (Enterprise)

Create a key under Account → API keys, then send it as Authorization: Bearer gck_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://gridcensus.com/api/v1/sites?state=TX&limit=100"
EndpointWhat it returns
GET /api/v1datasets, filters, your limits
GET /api/v1/sitesScored datacenter candidate sites: DC Readiness score, nearest substation and voltage, estimated available capacity (from nearby line ratings — not utility-confirmed headroom), fiber, water, hazard, utility, queue activity and bottlenecks nearby. Filters: statesite_typeiso_regionfips_code · q = name prefix
GET /api/v1/datacentersExisting and announced US datacenters: operator, location, capacity, square footage, type and status. Filters: stateoperator · q = name prefix
GET /api/v1/queue-projectsActive ISO interconnection-queue requests (generation and storage): ISO, queue ID, MW, fuel, status, queue date, county. Filters: statefipsiso
GET /api/v1/brownfieldsRetired power plants and EPA brownfields with existing grid connections: capacity, voltage, retirement date, cleanup status. Filters: statesite_type · q = name prefix
GET /api/v1/substationsTransmission substations (HIFLD/EIA): location, max/min voltage kV, owners derived from the transmission lines that connect to it, and connected line count + HIFLD line ids. Capacity and bus configuration are not public and are not included. Filters: statemax_voltage_kv · q = name prefix
GET /api/v1/transmission-linesTransmission lines (HIFLD): voltage, owner, endpoint substations (sub_1/sub_2), length, static rating and estimated MVA/MW capacity band, upgrade-candidate flag, ERCOT binding history. Ratings are estimates from voltage class unless static_rating_amps is present. Filters: statevoltage_kvownerhifld_id
GET /api/v1/transmission-projectsPlanned and approved transmission projects from the grid operators' published plans (MISO MTEP, ERCOT TPIT, SPP ITP, PJM RTEP, ISO-NE RSP, NYISO, CAISO TPP): owner, voltage, type, estimated cost, expected in-service date, status, plan cycle, and the substations it touches where the plan names them. Filters: isostatestatusowner · q = name prefix
GET /api/v1/headroom-estimatesEstimated new load each transmission substation takes before a line reaches its rating, with the limiting line, its voltage and owner, and the share of the new load it carries. From a public-data DC power-flow model of the grid calibrated with the grid operators' binding constraints (method at gridcensus.com/methodology#headroom). An estimate (N-0), not a utility determination. Filters: bandinterconnection
GET /api/v1/load-capacityNew load each distribution feeder and substation takes without upgrades, as the utility publishes it: Southern California Edison (incl. 220/66 kV A-bank headroom), National Grid NY and MA, Pepco / Delmarva / Atlantic City Electric, Central Hudson, Orange & Rockland. Distribution scale (typically 0–50 MW). Filters: stateutility
GET /api/v1/utilitiesElectric retail service territories (HIFLD): utility, type (IOU, coop, muni), holding company, customers, retail MWh, control and planning area. Curated datacenter posture and large-load tariff terms are at /api/v1/utility-posture. Filters: statetype · q = name prefix
GET /api/v1/countiesPer-county siting context: FEMA National Risk Index by hazard, construction and IT labor, climate (degree days), water stress and withdrawals, datacenter tax incentives, fiber coverage, electricity rates, proposed generation, FERC 714 peak demand and load growth, land value. Filters: statefips_code
GET /api/v1/internet-exchangesInternet exchange and colocation interconnection facilities (PeeringDB): operator, address, exchanges and networks present. Filters: stateorg_name · q = name prefix
GET /api/v1/fiber-routesLong-haul fiber route segments and the rail rights-of-way fiber runs in: operator, type, centroid. Geometry via /api/v1/geometry/fiber-routes/{id}. Filters: stateoperator
GET /api/v1/parcelsLarge parcels adjacent to transmission lines: owner, acreage, address, the line's voltage/capacity/owner, distance to the line, and whether it sits in a Section 368 corridor, a NIETC or a BLM solar area. Filters: statetransmission_line_id
GET /api/v1/corridorsDesignated federal energy corridors: type, agency, width, states, environmental status, and the transmission lines and upgrade candidates inside each. Filters: corridor_type
GET /api/v1/blm-rights-of-wayBureau of Land Management rights-of-way grants: holder, commodity, width/length, location, and the nearest transmission line. Filters: state
GET /api/v1/wecc-pathsWestern Interconnection transfer paths: rated transfer capability each direction and utilization (share of hours above 75% / 90%). Filters: path_number
GET /api/v1/queue-by-poiInterconnection queue totals by point of interconnection (substation/bus name as the ISO publishes it): projects, MW, mix, average wait. Filters: isostatepoi_name
GET /api/v1/ercot-constraintsERCOT real-time (SCED) binding transmission constraints: constraint and contingency, from/to station and kV, shadow price, limit and flow MW, interval. Ranked bottlenecks for all six ISOs are at /api/v1/congestion. Filters: constraint_name
GET /api/v1/sites/{id}one candidate site + its last 20 changes
GET /api/v1/datacenters/{id}one datacenter + its last 20 changes
GET /api/v1/queue-projects/{id}one interconnection-queue project + its last 20 changes
GET /api/v1/brownfields/{id}one brownfield site + its last 20 changes
GET /api/v1/substations/{id}one substation + its last 20 changes
GET /api/v1/transmission-lines/{id}one transmission line + its last 20 changes
GET /api/v1/transmission-projects/{id}one planned transmission project + its last 20 changes
GET /api/v1/headroom-estimates/{substation_id}one substation headroom estimate + its last 20 changes
GET /api/v1/load-capacity/{id}one feeder load headroom + its last 20 changes
GET /api/v1/utilities/{id}one electric utility + its last 20 changes
GET /api/v1/counties/{fips_code}one county + its last 20 changes
GET /api/v1/internet-exchanges/{id}one interconnection facility + its last 20 changes
GET /api/v1/fiber-routes/{id}one fiber route segment + its last 20 changes
GET /api/v1/parcels/{id}one parcel + its last 20 changes
GET /api/v1/corridors/{id}one energy corridor + its last 20 changes
GET /api/v1/blm-rights-of-way/{id}one blm right-of-way + its last 20 changes
GET /api/v1/wecc-paths/{id}one wecc transfer path + its last 20 changes
GET /api/v1/queue-by-poi/{id}one queue point of interconnection + its last 20 changes
GET /api/v1/ercot-constraints/{id}one ercot binding constraint interval + its last 20 changes
GET /api/v1/changeschange 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).