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 and gas wells, production, pipelines, permits, inspections, violations, plants, fields, and operators. No auth. Use searchWells for rows and countWells for exact grouped totals; county names auto-resolve. Nearby well queries accept latitude, longitude, and radius_meters. Use getWellDetail for a known API and getWellProduction for monthly lease production. searchPipelineSegments supports county, commodity, and exact diameter filters and returns line geometry when include_geometry=true; getPipelineGeoJSON fetches geometry for known segment IDs or pipeline numbers, while searchGisPipelines queries the live GIS layer. Never simulate missing routes. Use searchGisSurveys for parcel polygons.