Know your data sources.

California Geologic Energy Management Division (CalGEM) WellSTAR — wells, facilities, incidents, notices. Public ArcGIS REST, no auth. WELLS: searchWells, getWellDetail, countWells, searchWellsByRadius FACILITIES / REGULATORY: searchFacilities, searchIncidents, searchNotices CRITICAL USAGE RULES: 1. API numbers are 8-10 digits (California format) 2. Use searchWellsByRadius for geographic queries (radiusMiles default 5) 3. searchWells accepts intuitive aliases like { status: 'active', type: 'oil' } and maps them to CalGEM codes 4. searchNotices supports county by matching county API prefixes and returns most recent notices first 5. bbox params are [minLon, minLat, maxLon, maxLat]

Clearfork Intelligence — curated Texas & New Mexico oil & gas well data, TX drilling permits, and monthly production history with enrichment (aggregated production stats, SB-1150 "zombie well" exposure, canonical well IDs, radius + batch lookup). A cleaned commercial layer complementing the public rrc/nmocd connectors. AUTH: PAID Bearer token (key format cfork_live_...). Set CLEARFORK_BEARER_TOKEN. Requires an Operator ($249/mo) or Enterprise ($499/mo) plan; the permits methods are Enterprise-only. getServiceInfo works without a key (hits the public /health endpoint).

Oklahoma Corporation Commission (OCC) live ArcGIS REST. No auth. 26 methods, 49 layers. DOMAINS: - Wells: searchWells, getOrphanWells, getStateFundsWells, getWellLogs, getCompletions, getHorizontalLaterals, getUICWells. - Permits: getPermits (ITD). - Units/Rules: getDrillingUnits, getFieldRules. - Seismicity: getInducedSeismicity({zone}). - Surface: getFacilities, getOilGasIncidents, getGasStorage, getPSTTanks/Releases. - Water: getHydrology, getBaseTreatableWater, getPublicWaterSupplyWells/Intakes, getGroundwaterWells. - Geology/Cadastral: getSedimentaryBasins, getCadastral, getDistricts. - Generic: queryLayer({layer,...}) for any listLayers() key. Returns {features, geojson, total}. geojson → patchops_addMapLayer. Page cap 2000. Production volumes at OK Tax Commission.

Texas RRC oil & gas regulatory data (Postgres/PostGIS). Wells, production, pipelines, permits, inspections, violations, gas plants, fields, orgs. RULES: 1. No auth. 2. searchWells/searchWellsByArea for discovery. county is NAME (e.g. "MIDLAND") — auto-resolved. 3. Nearby: flat latitude/longitude/radius_meters. 4. getWellDetail when API known. getWellProduction for lease monthly. 5. Pipeline lines: getPipelineGeoJSON or searchGisPipelines + patchops_addMapLayer({geojson}). 6. searchPipelineSegments/getPipelinesNearLocation are DISCOVERY only — do NOT map centroids as points. 7. Flow: getPipelinesNearLocation → getPipelineGeoJSON({segment_ids:[id]}). 8. NEVER simulate pipeline routes. Stop at discovery if geometry missing. 9. searchGisSurveys + patchops_addMapLayer for parcel polygons.