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.
| Endpoint | What it returns |
|---|---|
GET /api/v1/screenlat, 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/powerlat, 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/congestioniso (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/moratoriastate, status (active | pending | expired) | Local (county / city / township) datacenter moratoria. |
GET /api/v1/utility-posturestate, 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-policystate, mw | Statewide datacenter posture, incentives and MW thresholds; with mw, whether the build trips them. |
GET /api/v1/ai-projectsstate | AI datacenter campuses with owner, off-takers and power (Epoch AI Frontier Data Centers, CC-BY). |
GET /api/v1/feedafter_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/regionstate | 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"
| Endpoint | What it returns |
|---|---|
GET /api/v1 | datasets, filters, your limits |
GET /api/v1/sites | Scored 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/datacenters | Existing and announced US datacenters: operator, location, capacity, square footage, type and status. Filters: stateoperator · q = name prefix |
GET /api/v1/queue-projects | Active ISO interconnection-queue requests (generation and storage): ISO, queue ID, MW, fuel, status, queue date, county. Filters: statefipsiso |
GET /api/v1/brownfields | Retired power plants and EPA brownfields with existing grid connections: capacity, voltage, retirement date, cleanup status. Filters: statesite_type · q = name prefix |
GET /api/v1/substations | Transmission 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-lines | Transmission 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-projects | Planned 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-estimates | Estimated 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-capacity | New 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/utilities | Electric 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/counties | Per-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-exchanges | Internet exchange and colocation interconnection facilities (PeeringDB): operator, address, exchanges and networks present. Filters: stateorg_name · q = name prefix |
GET /api/v1/fiber-routes | Long-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/parcels | Large 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/corridors | Designated 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-way | Bureau of Land Management rights-of-way grants: holder, commodity, width/length, location, and the nearest transmission line. Filters: state |
GET /api/v1/wecc-paths | Western Interconnection transfer paths: rated transfer capability each direction and utilization (share of hours above 75% / 90%). Filters: path_number |
GET /api/v1/queue-by-poi | Interconnection 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-constraints | ERCOT 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/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).