Know your data sources.

Bureau of Indian Affairs land-records and tribal-boundary data (biamaps.geoplatform.gov ArcGIS). No auth. Tract-level mineral & surface ownership on tribal lands (249K rows: state, land area, resource code, Trust/Restricted ownership, acres) plus reservation extent polygons (AIAN National LAR), tribal statistical areas, and the 12 BIA regional boundaries. Scope is land-records/ownership + tribal boundaries — a complement to BLM/BOEM, NOT oil/gas wells, leases, or production (the NIOGEMS well/lease/production layers are not publicly exposed). format:'geojson' on the boundary methods draws polygons for patchops_addMapLayer.

Bureau of Land Management (BLM) oil & gas leases and Public Land Survey System (PLSS). Search federal O&G leases, get lease details, and resolve legal land descriptions (township/range/section) to geographic coordinates. CRITICAL USAGE RULES: 1. No authentication required - ArcGIS REST services 2. Use searchLeases() to find BLM oil & gas leases 3. Use getTownshipSection() to get PLSS at a point 4. Use searchByLegalDescription() to find sections by T/R/S 5. Use getSectionGeometry() for a single section's geometry — by T/R/S+state (same input as searchByLegalDescription()) OR by { plssid, section } when you already hold a PLSSID from a prior PLSS feature; returns one feature (or null) instead of an array.

California Energy Commission (CEC) open data via the data.ca.gov CKAN API. No auth. The CA power-plant inventory — 2,378 plants with operator, county, capacity (MW), fuel type, and coordinates — plus county/fuel summaries and CEC dataset discovery.

US Census Bureau Geocoder - address geocoding, reverse geocoding, and geographic identifiers. Convert addresses to coordinates, coordinates to addresses, and get Census geography (county, tract, block) at a location. CRITICAL USAGE RULES: 1. No authentication required 2. US addresses only 3. Use geocodeAddress() for free-form address to coordinates 4. Use reverseGeocode() for coordinates to address/county

Colorado Division of Water Resources via the CDSS HydroBase REST API (dwr.state.co.us). No auth. Active administrative calls show which water rights are curtailed by senior calls on a stream — directly relevant to industrial and frac-water sourcing in the DJ Basin. Also decreed water-right net amounts, groundwater well permits, and real-time telemetry stations, filterable by county, water division (1–7), and WDID.

Combined environmental analysis for oil & gas regulatory compliance. Aggregates data from multiple government sources: - USFWS National Wetlands Inventory (NWI) - Section 404 permit requirements - FEMA National Flood Hazard Layer (NFHL) - Flood zone analysis - USGS National Hydrography Dataset (NHD) - Water feature setbacks - USDA NRCS Soil Data Access (SDA) - Soil properties CRITICAL USAGE RULES: 1. All APIs are free government services - NO authentication required 2. Use analyzeLocation() for comprehensive site analysis 3. Use checkWellSite() for regulatory constraint checks 4. Coordinates are latitude/longitude in WGS84 (EPSG:4326)

EPA environmental compliance and regulatory data combining three APIs: - ECHO: Enforcement & Compliance History Online - facility search, compliance tracking - Envirofacts: TRI toxic releases, SDWIS drinking water - UIC aquifer exemptions: injection wells injecting into EPA-exempted USDWs (GeoJSON) CRITICAL USAGE RULES: 1. ECHO and Envirofacts are free, no auth required 2. Use searchEchoFacilities() to find regulated facilities 3. Use getAquiferExemptions() for UIC injection wells + exempted-aquifer polygons (by state/wellClass), e.g. Class I/III/V where an aquifer exemption exists 4. AQS methods are now available in the dedicated authenticated connector "epa-aqs" 5. Per-program searches: CWA dischargers, CAA emitters (county→countyFips), RCRA handlers

FEMA National Flood Hazard Layer data for flood zone analysis. Special Flood Hazard Areas (SFHA) require floodplain development permits. CRITICAL USAGE RULES: 1. No authentication required - free government API 2. sfhaIndicator=true means site is in Special Flood Hazard Area 3. Flood zones: A, AE, AO, AH (high risk), X (moderate/minimal risk) 4. Coordinates are latitude/longitude in WGS84

US Fish & Wildlife Service ESA-designated critical habitat — Final and Proposed critical-habitat polygons for threatened & endangered species, from the FWS hosted ArcGIS service. No auth. The #1 federal ESA Section-7 permitting screen: does a well pad, pipeline route, or right-of-way intersect designated critical habitat, and for which listed species? Query by location (near a point or bbox) and/or by species name; ask for format:'geojson' to draw the polygons on a map.

USGS National Hydrography Dataset for water feature setback analysis. Water features determine setback requirements and water sourcing for oil & gas operations. CRITICAL USAGE RULES: 1. No authentication required - free government API 2. Returns flowlines (streams/rivers) and waterbodies (lakes/ponds) 3. Use for setback distance calculations from water features 4. Coordinates are latitude/longitude in WGS84

Idaho Department of Water Resources via its public ArcGIS REST services (gis.idwr.idaho.gov). No auth. Water-right points of diversion, drilled wells & construction permits, places of use, appropriation permits, diversion/measurement sites, and regulatory groundwater/management areas. Filter by basin (1–99), owner, county, water district, beneficial use, or location (bbox / near a point). Coordinates are reprojected to WGS84 for the map viewer. Every search needs at least one filter — the primary layers hold 200k+ records.

Macrostrat geologic database - stratigraphic columns, formation data, and geologic units. Query surface geology, get stratigraphic columns, and look up formation details. Useful for understanding subsurface geology for oil & gas exploration. CRITICAL USAGE RULES: 1. No authentication required 2. Use getGeologyAtPoint() for surface geology at a location 3. Use getStratColumn() for the full stratigraphic column 4. Use getFormationInfo() to look up formations like "Wolfcamp", "Bakken"

Federal environmental-review (NEPA) pre-screen for siting wells, pads, pipelines, and rights-of-way. Aggregates the queryable upstream authorities — EPA ATTAINS impaired/303(d) waters, BLM National Surface Management Agency (federal land), NPS National Wild & Scenic Rivers, and EPA Sole Source Aquifers. No auth. screenLocation drops a point (or bbox) and returns every constraint at once. Built from the real source APIs, not EPA NEPAssist (whose query API is blocked). Federal-land layer is SURFACE management only — not subsurface/mineral ownership (split-estate caveat).

NOAA Center for Operational Oceanographic Products and Services (CO-OPS). Tide predictions, observed water levels, currents, and meteorological data from coastal stations. CRITICAL USAGE RULES: 1. No authentication required 2. Use searchStations() to find stations near a location 3. GULF_COAST_STATIONS constant has pre-mapped station IDs 4. Date format: YYYYMMDD (e.g., '20250601')

National Weather Service (NWS) API - weather forecasts, alerts, and station observations. US coverage only. Provides detailed forecasts, severe weather alerts, and real-time conditions. CRITICAL USAGE RULES: 1. No authentication required (User-Agent header added automatically) 2. US coverage only - will fail for non-US coordinates 3. Use getPointForecast() for 7-day forecasts at a location 4. Use getActiveAlerts() for severe weather warnings

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.

Open-Meteo - free global weather API with forecasts, historical data, marine weather, and air quality. Global coverage. Good complement to NWS for international locations or marine/offshore weather. CRITICAL USAGE RULES: 1. No authentication required 2. Global coverage (unlike NWS which is US-only) 3. Use getForecast() for weather forecasts up to 16 days 4. Use getMarineWeather() for offshore wave/swell data

Oregon Dept. of Geology & Mineral Industries — GeoThermal Information Layer of Oregon (GTILO): ~5,429 geothermal wells, geothermal springs, and direct-use area polygons. No auth. For renewable/geothermal siting in Oregon. Note: these layers have no objectIdField, so results are capped at 1000 per query (no pagination) — use bbox or near {lat,lon,radiusMiles} to bound the result. getDirectUseAreas returns GeoJSON polygons for patchops_addMapLayer.

Petroleum-engineering calculations, pure compute, no data source, no auth. Deterministic correlations in field units (Rs scf/STB, pressure psia, temp °F, API °API). Pairs with production/well data connectors (rrc, enverus, welldatabase) to turn raw data into engineering answers. 550+ methods across: PVT, gas/oil/water properties, EOS (Peng-Robinson/SRK flash), decline-curve (Arps + SEDM/PLE/LGM/Duong), IPR (Vogel/Fetkovich/Joshi), VFP multiphase lift (Beggs-Brill/Hagedorn-Brown/Gray), material balance, well-test/PTA, SCAL, hydraulic fracturing, surface facilities, flow assurance, artificial lift (ESP/rod/gas-lift), petrophysics/log analysis (Archie), drilling hydraulics, geomechanics/pore pressure, reserves and economics (NPV/IRR), tubular design, and ~100 unit conversions.

PSE (Polskie Sieci Elektroenergetyczne) — Polish electricity TSO open data (api.raporty.pse.pl). No auth. System load + generation mix, day-ahead demand forecast, day-ahead and balancing-market prices (PLN/MWh). Central-EU gas-to-power exposure.

Red Eléctrica de España (REE) — Spanish electricity TSO open data (apidatos.ree.es). No auth. Aggregate demand, generation by technology (with renewable mix %), and market prices (PVPC + day-ahead spot, EUR/MWh). Pairs with the entsoe/elexon/nordpool/neso power-market connectors.

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.

RTE / ODRE — French electricity (éCO2mix) open data (odre.opendatasoft.com). No auth. Real-time national & regional consumption, generation by fuel (incl. nuclear share), CO2 intensity, and cross-border flows, at 15-min resolution. The largest continental EU power market.

User-created skills connector for accessing custom AI instructions and workflows. Skills are dynamic AI instructions that users create through the PatchOps web interface. They combine natural language instructions with connector references to guide AI agents. USAGE: 1. Use listSkills() to see all available skills for the current user 2. Use getSkill({ slug }) to get full details of a specific skill 3. Use getSkillInstructions({ slug }) to get LLM-ready markdown instructions 4. Use createSkill({ name, instructions, ... }) to create a new skill 5. Skills reference connectors that the agent should use (welldatabase, postgres, etc.)

USDA NRCS Soil Data Access for soil properties and construction suitability. Soil properties affect foundation design, spill containment, and reclamation planning. CRITICAL USAGE RULES: 1. No authentication required - free government API 2. Query by area symbol (county code, e.g., TX201 for Harris County) 3. Returns drainage class, hydrology group, flood frequency 4. Use getInterpretations() for construction suitability ratings

USGS Earthquake Hazards Program - real-time and historical seismicity data. Search earthquakes by location, magnitude, date range, or get significant events. CRITICAL USAGE RULES: 1. No authentication required 2. Use searchByRadius() for location-based seismicity analysis 3. Magnitude scale: 0-2 micro, 2-4 minor, 4-6 moderate, 6+ major 4. Coordinates are latitude/longitude in WGS84

USGS Elevation Point Query Service (EPQS), 3D Elevation Program (3DEP), and topographic CONTOUR LINES. Get elevation at points, batch elevation queries, elevation profiles along routes, and topo contour-line vector data (GeoJSON) for rendering on a map. CRITICAL USAGE RULES: 1. No authentication required 2. Use getElevation() for single point elevation 3. Use getElevationProfile() for pipeline route terrain analysis 4. Use getContoursGeoJSON() for topographic contour LINES — requires a bbox or near (lat/lon) because contour data is dense; pass the result to patchops_addMapLayer to draw them 5. Units: 'Feet' or 'Meters' (default Feet)

USGS State Geologic Map Compilation (SGMC) - national geologic map data. Query lithology, formation names, rock types, and geologic age at a point or within a bounding box from the USGS ArcGIS REST service. CRITICAL USAGE RULES: 1. No authentication required 2. Use queryGeologyAtPoint() for geology at a specific point 3. Use queryGeologyInBbox() for regional geology mapping 4. Returns USGS-mapped surface geologic units

USGS National Water Information System (NWIS) - real-time and historical water data. Streamflow, gage height, groundwater levels, and monitoring site information. CRITICAL USAGE RULES: 1. No authentication required 2. searchSites takes exactly ONE location filter: bbox ("west,south,east,north") OR countyCd (5-digit FIPS) OR stateCd (2-letter). Empty result = no sites matched. 3. Use site IDs from searchSites() for data queries (getGroundwaterLevels also accepts bbox directly) 4. Parameter codes: 00060=discharge, 00065=gage height, 72019=depth to water 5. Period format: P1D=1 day, P7D=7 days, P30D=30 days. getDailyValues defaults to P30D when no dates given.

USFWS National Wetlands Inventory data for Section 404 permit analysis. Wetland presence triggers Army Corps 404 permit requirements for oil & gas operations. CRITICAL USAGE RULES: 1. No authentication required - free government API 2. Use queryAtPoint() for specific location analysis 3. Use queryInBbox() for area-wide wetland mapping 4. Coordinates are latitude/longitude in WGS84

Live and historical prices for energy futures (WTI, Brent, Henry Hub, RBOB, heating oil) and energy equities (XOM, CVX, FANG, OXY…), from Yahoo Finance. No auth. The only free price feed reachable from our infrastructure — CME, OPEC, Stooq, and Baker Hughes all IP-block datacenter traffic. Futures use Yahoo "=F" tickers (CL=F WTI, BZ=F Brent, NG=F Henry Hub); equities are plain tickers.