well-data-mcp
Summary: This MCP server lets you discover well-data sources, search and retrieve well records, find wells near a location, and search related geothermal/project datasets.
list_sources: show available source coverage, filters, and caveats.search_wells: search by API, operator, well/lease name, county, field, status, type, state/source; paginate and count-only size queries.get_well: fetch a specific well's full raw and normalized record by API number, with formatting tolerance and optional state.wells_near: find wells within a radius of lat/lon, optionally limited by state/source.raw_query: run raw ArcGIS SQL-92 WHERE clauses against one source for custom filters/attributes.list_operators: find exact operator-name strings matching partial text.search_gem_projects: search offline Global Energy Monitor geothermal and oil/gas project/field trackers.search_geothermal_datasets: search DOE GDR/OSTI geothermal datasets and get data links.Note: this schema exposes a limited state/source set (CA, UT, NM, CO, ND, TX, NV, NZ, GP) and omits README tools such as
search_heat_flow.
Queries live oil & gas and geothermal well data from state regulator ArcGIS REST services, enabling well searches by operator/name/county/field/status/type, retrieval by API number, radius searches, operator lists, and raw SQL-92 queries against source layers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@well-data-mcp find producing wells in Kern County, CA"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
well-data-mcp
MCP server for oil & gas and geothermal well data worldwide, pulled live from the public services of state, provincial and national regulators and geological surveys. No API keys, no accounts, no scraping of pages meant for people: these are the same ArcGIS, WFS and query endpoints the agencies' own map viewers use.
It answers questions like "which wells does Fervo have at Cape Station", "every well within 2 km of this pad", "look up API 30-025-36283", "what was pumped into this well's frac job", "bottom-hole temperatures in Weld County", "orphaned wells in this county", "Equinor's wellbores on the Norwegian shelf" or "geothermal wells near Larderello" - and says plainly when a country publishes nothing machine-readable.
Coverage
United States
Key | Coverage | Agency | Via |
| California oil & gas wells | CalGEM (WellSTAR) | ArcGIS |
| California geothermal wells | CalGEM (WellSTAR) | ArcGIS |
| Utah oil & gas wells | Utah Division of Oil, Gas & Mining (DOGM) | ArcGIS |
| Utah deep geothermal wells (incl. Fervo Cape Station, Utah FORGE) | Utah Division of Water Rights (DWRi) | ArcGIS |
| Utah drilled-well logs (every well drilled under a water-rights approval, incl. geothermal) | Utah Division of Water Rights (DWRi) | ArcGIS |
| Utah thermal wells and springs (temperature + water chemistry) | Utah Geological Survey (UGS) | ArcGIS |
| New Mexico oil & gas wells | NM OCD (EMNRD) | ArcGIS |
| Colorado wells (API spots) | Colorado ECMC (via DNR GIS) | ArcGIS |
| Wyoming oil & gas wells (WOGCC database snapshot) | Wyoming State Geological Survey (copy of the WOGCC well database) | ArcGIS |
| Wyoming wells - live WOGCC list (name, status, type) | Wyoming Oil and Gas Conservation Commission (WOGCC) Data Explorer | WFS |
| Montana oil & gas wells | Montana Board of Oil & Gas Conservation (DNRC) | ArcGIS |
| Idaho oil & gas wells | Idaho Geological Survey | ArcGIS |
| Idaho geothermal wells (low-temperature use, with water temperatures) | Idaho Department of Water Resources (IDWR) | ArcGIS |
| Oregon geothermal wells and temperature-gradient holes (incl. Newberry) | Oregon DOGAMI (GTILO-2 compilation) | ArcGIS |
| Washington oil & gas wells | Washington DNR (Geology) | ArcGIS |
| Washington geothermal well permits | Washington DNR (Geology) | ArcGIS |
| Arizona oil, gas, helium & geothermal wells | Arizona Oil & Gas Conservation Commission (hosted by ADEQ) | ArcGIS |
| Nevada geothermal wells | NBMG (UNR) / NGDS | ArcGIS |
| Nevada oil & gas wells (compiled through 2013) | NBMG (UNR) | ArcGIS |
| Great Basin boreholes - Nevada and neighbours (geothermal, oil & gas, groundwater, mining), current | Nevada Bureau of Mines and Geology (University of Nevada, Reno) subsurface database | ArcGIS |
| Alaska oil, gas & geothermal wells (incl. state offshore) | Alaska Oil and Gas Conservation Commission (via Alaska Division of Oil & Gas) | ArcGIS |
| Hawaii geothermal wells (Puna) | Hawaii Statewide GIS Program | ArcGIS |
| South Dakota oil & gas wells | South Dakota Geological Survey / DANR | ArcGIS |
| North Dakota oil & gas wells | ND DMR Oil & Gas Division | ArcGIS |
| Texas well locations (location + API only) | Texas RRC public GIS | ArcGIS |
| Texas wellbores with operator, lease, field and county | Texas Railroad Commission (EWA wellbore query) | RRC query |
| Oklahoma oil, gas & injection wells | Oklahoma Corporation Commission (RBDMS) | ArcGIS |
| Kansas oil & gas wells | Kansas Geological Survey (KCC well data) | ArcGIS |
| Nebraska oil & gas wells (API, name, location) | Nebraska Oil & Gas Conservation Commission | WFS |
| Missouri oil & gas wells | Missouri DNR / Missouri Geological Survey | ArcGIS |
| Arkansas oil & gas wells | Arkansas Oil and Gas Commission (via Arkansas GIS Office) | ArcGIS |
| Louisiana oil & gas wells (incl. state waters) | Louisiana DENR Office of Conservation (SONRIS) | ArcGIS |
| Mississippi oil & gas wells | Mississippi State Oil & Gas Board | WFS |
| Alabama oil, gas & coalbed-methane wells | State Oil and Gas Board of Alabama (via Geological Survey of Alabama) | ArcGIS |
| Florida oil & gas wells | Florida Department of Environmental Protection, Oil and Gas Program | ArcGIS |
| Pennsylvania oil & gas wells | Pennsylvania DEP Office of Oil and Gas Management | ArcGIS |
| Ohio oil & gas wells | Ohio DNR Division of Oil & Gas Resources | ArcGIS |
| West Virginia oil & gas wells | West Virginia DEP Office of Oil and Gas | ArcGIS |
| Kentucky oil & gas wells | Kentucky Geological Survey | ArcGIS |
| Illinois oil & gas wells | Illinois State Geological Survey (ILOIL) | ArcGIS |
| Indiana oil & gas wells | Indiana DNR Division of Oil & Gas | ArcGIS |
| Michigan oil, gas & mineral wells | Michigan EGLE (Oil, Gas, and Minerals Division) | ArcGIS |
| New York oil, gas & solution-mining wells | New York DEC Division of Mineral Resources | ArcGIS |
| Tennessee oil & gas wells | Tennessee Department of Environment and Conservation (TDEC) | ArcGIS |
| Virginia gas & oil wells (active) | Virginia Energy, Division of Gas and Oil | ArcGIS |
| Virginia oil & gas wells - historic, incl. plugged and abandoned | Virginia Energy, Division of Geology and Mineral Resources (compiled for the National Geothermal Data System) | ArcGIS |
| Colorado borehole temperatures (bottom-hole and log temperatures by well) | Colorado state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| Idaho borehole temperatures (bottom-hole and log temperatures by well) | Idaho state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| Montana borehole temperatures (bottom-hole and log temperatures by well) | Montana state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| Nevada borehole temperatures (bottom-hole and log temperatures by well) | Nevada state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| South Dakota borehole temperatures (bottom-hole and log temperatures by well) | South Dakota state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| Utah borehole temperatures (bottom-hole and log temperatures by well) | Utah state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| Wyoming borehole temperatures (bottom-hole and log temperatures by well) | Wyoming state geological survey data in the National Geothermal Data System (AASG), served by the Nevada Bureau of Mines and Geology | ArcGIS |
| Illinois borehole temperatures (bottom-hole and log temperatures by well) | Illinois state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Indiana borehole temperatures (bottom-hole and log temperatures by well) | Indiana state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Massachusetts borehole temperatures (bottom-hole and log temperatures by well) | Massachusetts state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Michigan borehole temperatures (bottom-hole and log temperatures by well) | Michigan state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Missouri borehole temperatures (bottom-hole and log temperatures by well) | Missouri state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| New York borehole temperatures (bottom-hole and log temperatures by well) | New York state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Ohio borehole temperatures (bottom-hole and log temperatures by well) | Ohio state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Pennsylvania borehole temperatures (bottom-hole and log temperatures by well) | Pennsylvania state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| Vermont borehole temperatures (bottom-hole and log temperatures by well) | Vermont state geological survey data in the National Geothermal Data System (AASG), served by the Illinois State Geological Survey | ArcGIS |
| West Virginia borehole temperatures (bottom-hole and log temperatures by well) | West Virginia state geological survey data in the National Geothermal Data System (AASG), served by the West Virginia Geological and Economic Survey | ArcGIS |
| Iowa wells (Iowa Geological Survey GeoSam: water, exploration, gas-storage and oil tests) | Iowa Geological Survey (GeoSam) data in the National Geothermal Data System, served by the Illinois State Geological Survey | ArcGIS |
| US documented unplugged orphaned oil & gas wells (USGS national dataset, from state regulators) | U.S. Geological Survey - Documented Unplugged Orphaned Oil and Gas Well dataset (DOI 10.5066/P13FHBYG) | ArcGIS |
| BLM applications for permit to drill (APDs) on federal minerals - New Mexico, Oklahoma, Kansas, Texas | Bureau of Land Management, New Mexico State Office | ArcGIS |
| US hydraulic-fracturing disclosures (one record per frac job, with the chemical list) | FracFocus (Ground Water Protection Council / Interstate Oil & Gas Compact Commission) | FracFocus API |
US federal offshore
Key | Coverage | Agency | Via |
| US Gulf federal offshore wells (Outer Continental Shelf) | BOEM / BSEE (federal offshore) | ArcGIS |
| US Pacific federal offshore wells (Outer Continental Shelf) | BOEM / BSEE (federal offshore) | ArcGIS |
| US Alaska federal offshore wells (Outer Continental Shelf) | BOEM / BSEE (federal offshore) | ArcGIS |
| US Atlantic federal offshore wells (Outer Continental Shelf) | BOEM / BSEE (federal offshore) | ArcGIS |
Canada
Key | Coverage | Agency | Via |
| Saskatchewan oil & gas wells (vertical) | Saskatchewan Ministry of Energy and Resources | ArcGIS |
| Saskatchewan oil & gas wells (horizontal / directional) | Saskatchewan Ministry of Energy and Resources | ArcGIS |
| British Columbia oil & gas wells | BC Energy Regulator (BCER) | ArcGIS |
| Ontario oil, gas, salt & storage wells (incl. Lake Erie) | Ontario Ministry of Natural Resources (Land Information Ontario) | ArcGIS |
| Newfoundland & Labrador offshore wells | Newfoundland and Labrador Department of Industry, Energy and Technology | ArcGIS |
| Nova Scotia offshore wells | Canada-Nova Scotia Offshore Energy Board directory (via NRCan) | ArcGIS |
| Northwest Territories oil & gas wells | NWT Office of the Regulator of Oil and Gas Operations (OROGO) | ArcGIS |
| Yukon oil & gas wells | Government of Yukon (Oil and Gas Resources Branch) | ArcGIS |
| Yukon geothermal boreholes (temperature, gradient, heat flow) | Yukon Geological Survey | ArcGIS |
| Alberta wells - AER ST37 well list locations and status (March 2024) | Alberta Energy Regulator ST37 list, mapped by the Alberta Geological Survey | ArcGIS |
| Alberta wells reaching the Swan Hills / Slave Point formations - formation depth and temperature (geothermal resource assessment) | Alberta Geological Survey / Alberta Energy Regulator | ArcGIS |
| Alberta wells reaching the Granite Wash - formation depth and temperature (geothermal resource assessment) | Alberta Geological Survey / Alberta Energy Regulator | ArcGIS |
| Alberta wells reaching the Leduc Formation - formation depth and temperature (geothermal resource assessment) | Alberta Geological Survey / Alberta Energy Regulator | ArcGIS |
| Manitoba oil & gas wells | Manitoba Petroleum Branch (Economic Development, Investment, Trade and Natural Resources) | Shapefile download |
| Quebec oil & gas wells and stratigraphic holes | Québec Ministère des Ressources naturelles et des Forêts (hydrocarbon wells) | ArcGIS |
| Nova Scotia onshore petroleum wells | Nova Scotia Department of Natural Resources (onshore petroleum wells) | ArcGIS |
| New Brunswick producing oil & gas wells | New Brunswick Department of Natural Resources and Energy Development (GeoNB oil & gas viewer) | ArcGIS |
Latin America & Caribbean
Key | Coverage | Agency | Via |
| Belize exploration & production wells (onshore and offshore) | Government of Belize - petroleum data coverage map (Geology & Petroleum Department data) | ArcGIS |
| Mexico oil & gas wells (onshore and offshore) | CNH well inventory as re-hosted by SEMARNAT | ArcGIS |
| Colombia oil & gas wells | Servicio Geológico Colombiano (EPIS) | ArcGIS |
| Brazil oil & gas wells (onshore and offshore, incl. pre-salt) | ANP - Agência Nacional do Petróleo, Gás Natural e Biocombustíveis | WFS |
| Peru oil & gas wells | PERUPETRO | WFS |
| Argentina oil & gas wells - conventional | Secretaría de Energía de la Nación (Argentina) | WFS (FES) |
| Argentina oil & gas wells - shale (Vaca Muerta...) | Secretaría de Energía de la Nación (Argentina) | WFS (FES) |
| Argentina oil & gas wells - tight | Secretaría de Energía de la Nación (Argentina) | WFS (FES) |
| Argentina oil & gas wells - resource type not reported | Secretaría de Energía de la Nación (Argentina) | WFS (FES) |
| Argentina - Neuquén province wells incl. Vaca Muerta (provincial registry, more detail than AR-*) | Provincia del Neuquén - Subsecretaría de Energía, Minería e Hidrocarburos | WFS |
| Brazil groundwater wells incl. deep and thermal wells (SIAGAS national register) | Serviço Geológico do Brasil (SGB) - SIAGAS | WFS |
| Bolivia oil & gas wells | Ministerio de Hidrocarburos y Energías de Bolivia (Viceministerio de Exploración y Explotación) | ArcGIS |
| Colombia deep oil & gas wells with bottom-hole temperatures and geothermal gradients | Servicio Geológico Colombiano (Mapa Geotérmico de Colombia, ANH well data) | ArcGIS |
| Paraguay petroleum wells (all ~50 drilled since 1947) | Viceministerio de Minas y Energía de Paraguay | ArcGIS |
| Suriname wells in Staatsolie's data room (mostly offshore exploration) | Staatsolie Maatschappij Suriname (state oil company) - GeoPortal | ArcGIS |
| Ecuador oil & gas wells (unofficial copy of the 2020 ministry consolidation) | Ecuador Ministry of Energy (MERNNR) well data, 2020, re-hosted on ArcGIS Online by GEOcentro, Universidad San Francisco de Quito | ArcGIS |
Europe
Key | Coverage | Agency | Via |
| France boreholes incl. overseas departments (Guadeloupe/Bouillante, Martinique, Réunion...) | BRGM - Banque du Sous-Sol (BSS) | WFS (FES) |
| Norway offshore wellbores (all: exploration, development, other) | Sodir - Norwegian Offshore Directorate (FactMaps) | ArcGIS |
| UK offshore wellbores (UKCS) | North Sea Transition Authority (NSTA) | ArcGIS |
| England onshore petroleum wells | North Sea Transition Authority (NSTA) | ArcGIS |
| Great Britain borehole index (all onshore drilling, incl. deep geothermal) | British Geological Survey (Single Onshore Borehole Index) | ArcGIS |
| Netherlands deep boreholes (oil, gas, geothermal, salt, storage; onshore and offshore) | TNO / NLOG (Dutch Oil and Gas Portal) | WFS |
| Iceland borehole registry (geothermal production, reinjection, gradient wells...) | Orkustofnun (National Energy Authority) via the national geoportal | WFS |
| Germany deep wells (hydrocarbon, storage, salt, geothermal) - North German Basin, North Sea, Upper Rhine | LBEG - Landesamt für Bergbau, Energie und Geologie (NIBIS) | WFS (FES) |
| Poland borehole database (all purposes, incl. geothermal) | Polish Geological Institute (PGI-PIB, CBDG) | ArcGIS |
| Ireland offshore petroleum wells | Petroleum Affairs Division (Department of the Environment, Climate and Communications) | ArcGIS |
| Ireland onshore petroleum wells | Petroleum Affairs Division (Department of the Environment, Climate and Communications) | ArcGIS |
| Denmark released exploration wells (onshore and offshore) | GEUS - Geological Survey of Denmark and Greenland (Samba) | WFS (FES) |
| Germany - every released borehole from the state geological surveys (incl. Bavaria, NRW, Saxony, Thuringia) | BGR - Federal Institute for Geosciences and Natural Resources (German Borehole Locations, GBL) | ArcGIS |
| Italy hydrocarbon wells, onshore and offshore (ministry list, published by ISPRA) | ISPRA - Servizio Geologico d'Italia (Ministry of Environment and Energy Security hydrocarbon wells, UNMIG/ViDEPI) | ArcGIS |
| Italy geothermal wells (Larderello, Amiata, Travale, Latium, Campania...) | ISPRA - Servizio Geologico d'Italia (national geothermal well inventory) | ArcGIS |
| Czech Republic borehole register (all purposes, incl. ~2,300 oil & gas wells) | Czech Geological Survey (ČGS) - borehole database | ArcGIS |
| Slovenia borehole register (hydrocarbon, geothermal, gas storage, hydrogeological) | Geological Survey of Slovenia (GeoZS) | ArcGIS |
| Croatia onshore oil, gas and geothermal wells | Croatian Hydrocarbon Agency (Agencija za ugljikovodike) | ArcGIS |
| Croatia offshore (Adriatic) wells | Croatian Hydrocarbon Agency (Agencija za ugljikovodike) | ArcGIS |
| Slovakia geothermal wells (with wellhead temperature, yield and thermal power) | State Geological Institute of Dionýz Štúr (ŠGÚDŠ) - geothermal well register | ArcGIS |
| Slovakia borehole register (exploration, hydrogeological and engineering boreholes) | State Geological Institute of Dionýz Štúr (ŠGÚDŠ) - register of other boreholes | ArcGIS |
| Portugal deep boreholes incl. petroleum wells onshore and offshore (Sondabase) | LNEG - National Laboratory of Energy and Geology (Sondabase) | ArcGIS |
| Northern Ireland borehole index (incl. hydrocarbon and geothermal wells) | Geological Survey of Northern Ireland (via the British Geological Survey GeoIndex) | ArcGIS |
| UK onshore hydrocarbon wells incl. Scotland (BGS index) | British Geological Survey - onshore hydrocarbon well data index | ArcGIS |
| Belgium (Flanders) borehole database incl. the Balmatt deep geothermal wells | Databank Ondergrond Vlaanderen (DOV) - Flemish Government | WFS |
| Denmark deep onshore wells (GEUS Jupiter database) | GEUS - Geological Survey of Denmark and Greenland (Jupiter) | WFS (FES) |
| Greenland petroleum wells (onshore Nuussuaq and offshore West Greenland) | GEUS - Geological Survey of Denmark and Greenland (Samba) | WFS (FES) |
| Danube-region geothermal wells (Hungary, Romania, Slovenia, Croatia, Serbia, Bosnia) - DARLINGe | DARLINGe Interreg project (national geological surveys), hosted by the Geological Survey of Slovenia | ArcGIS |
| Switzerland deep wells over 500 m (hydrocarbon, geothermal, salt, thermal water, research) | swisstopo - Federal Office of Topography (geo.admin.ch) | geo.admin.ch API |
| Pan-European deep boreholes with bottom-hole temperatures (25 national surveys) | Geological Service for Europe (GSEU) via EGDI | WFS (FES) |
Africa
Key | Coverage | Agency | Via |
| South Africa petroleum wells (mostly offshore: Bredasdorp, Orange...) | Petroleum Agency SA (PASA) | ArcGIS |
| Mozambique exploration & production wells | Instituto Nacional de Petróleo (INP) | ArcGIS |
| Kenya petroleum exploration wells (unofficial copy of the ministry map) | State Department for Petroleum map, re-hosted on ArcGIS Online by a third-party account | ArcGIS |
| Angola oil & gas wells, onshore and offshore | ANPG - Agência Nacional de Petróleo, Gás e Biocombustíveis (Angola) | ArcGIS |
| Tanzania petroleum wells (statutory Petroleum Activity Reference Map) | Petroleum Upstream Regulatory Authority (PURA), Tanzania | ArcGIS |
| Equatorial Guinea petroleum wells (licensing-round map) | Ministry of Hydrocarbons of Equatorial Guinea (EG Ronda map, hosted by Perceptum) | ArcGIS |
| Sierra Leone offshore wells | Petroleum Directorate of Sierra Leone (PDSL) data portal | ArcGIS |
Asia & Middle East
Key | Coverage | Agency | Via |
| Indonesia oil & gas wells | Directorate General of Oil and Gas (Ditjen Migas), Ministry of Energy and Mineral Resources - MDR | ArcGIS |
| Thailand oil & gas wells, onshore and Gulf of Thailand (2003 to date) | Department of Mineral Fuels (DMF), Ministry of Energy, Thailand | ArcGIS |
| Israel oil & gas wells, onshore and offshore (2015 snapshot) | Geophysical Institute of Israel - National Geophysical Data-Base | ArcGIS |
| Jordan petroleum wells | Ministry of Energy and Mineral Resources of Jordan (petroleum opportunities map) | ArcGIS |
Oceania
Key | Coverage | Agency | Via |
| New Zealand petroleum wells (nationwide, incl. offshore) | NZ Petroleum & Minerals (NZP&M) | ArcGIS |
| Waikato geothermal wells (Taupō Volcanic Zone, incl. deep production wells) | Waikato Regional Council (National Wells Database) | ArcGIS |
| Bay of Plenty geothermal bores (Rotorua, Tauranga...) | Bay of Plenty Regional Council | ArcGIS |
| Australia national borehole database (petroleum, coal-seam gas, geothermal, stratigraphic) | Geoscience Australia | WFS |
| South Australia petroleum wells (Cooper/Eromanga...) | Government of South Australia, Department for Energy and Mining (SARIG) | WFS |
| South Australia geothermal wells (incl. Habanero) | Government of South Australia, Department for Energy and Mining (SARIG) | WFS |
| Queensland petroleum wells | Geological Survey of Queensland | ArcGIS |
| Queensland coal-seam-gas wells | Geological Survey of Queensland | ArcGIS |
| Queensland geothermal heat-flow bores | Geological Survey of Queensland | ArcGIS |
| Victoria petroleum and geothermal wells (onshore and offshore: Gippsland, Otway, Bass) | Geological Survey of Victoria (DbMap petroleum well database), Department of Energy, Environment and Climate Action | WFS |
| New South Wales petroleum and coal-seam-gas wells | Geological Survey of New South Wales | WFS |
| New South Wales geothermal drillholes | Geological Survey of New South Wales | WFS |
| Northern Territory petroleum wells (Amadeus, Beetaloo, McArthur, Georgina...) | Northern Territory Geological Survey (STRIKE) | STRIKE WMS (whole layer) |
| Tasmania fuel (petroleum, coal, oil shale) and geothermal boreholes | Mineral Resources Tasmania | ArcGIS |
| Australia offshore petroleum wells and boreholes (NOPTA titles register) | National Offshore Petroleum Titles Administrator (NOPTA) | ArcGIS |
| Western Australia onshore petroleum wells | WA Department of Energy, Mines, Industry Regulation and Safety (DMIRS-025) | ArcGIS |
No public registry found
Guatemala - No official registry. The Energy & Mines ministry (mem.gob.gt) and the open-data portal sit behind a browser challenge scripts cannot pass; the national spatial data infrastructure (IDEG/SEGEPLAN) WFS has no hydrocarbon or geothermal layers. Geothermal well data (Zunil, Amatitlán) is operator-held. Project level: search_gem_projects.
Eastern Caribbean geothermal islands - Dominica, St Kitts & Nevis, Montserrat, St Lucia, Grenada, St Vincent: no machine-readable well data found (reports and PDF tables only; the regional CHARIM GeoNode domain now serves only a static copy of its homepage). Guadeloupe and Martinique boreholes are in FR-BSS. Project level: search_gem_projects.
Central American geothermal - El Salvador, Honduras, Nicaragua, Costa Rica, Panama: no public geothermal well service found (Ahuachapán, Berlín, Momotombo, San Jacinto-Tizate, Miravalles are operator-held). Project level: search_gem_projects.
Mexico (geothermal) - CFE publishes no geothermal well data (Cerro Prieto, Los Azufres, Los Humeros). Oil & gas wells are in MX (a 2024 snapshot). The former CNH map (mapa.hidrocarburos.gob.mx) is offline.
Ecuador (official) - The hydrocarbon regulator's geoportal requires a login and the open-data API refuses scripts; EC is an unofficial university-hosted copy of the ministry's 2020 well list.
Trinidad & Tobago - The Ministry of Energy publishes PDF data-package listings for bid rounds and an ArcGIS Online map of blocks and fields, but no well layer.
Chile (geothermal) - No geothermal well service found (Cerro Pabellón is operator-held); open-data and ministry GIS searches return nothing.
Uruguay, Guyana, Dominican Republic, Venezuela, Cuba, Jamaica - No keyless official well service found: Uruguay's mining geoportal has groundwater bores only, Guyana publishes blocks and FPSO locations, the Dominican Republic a dozen historic well and seep points without ids or depths, and the others nothing machine-readable.
Oregon oil & gas, Maryland, Georgia, the Carolinas, New Jersey, Minnesota, Wisconsin - No live well service: Oregon's oil & gas permits (Mist gas field) are a dated .xls download (OR-GEO has its geothermal wells), and the others publish PDF circulars or nothing. Their orphaned wells, if any, are in US-ORPHAN and their frac jobs in US-FRACFOCUS.
Alberta (well details), PEI, Nunavut - Alberta's AB source has every well's location and status but no names or licensees: AER's own map services are internal-only, and the details exist only as bulk files (ST37, 184 MB; Petrinex 'Well Licence', 18 MB zip; 'Well Infrastructure', 67 MB zip). Prince Edward Island and the Arctic islands (Nunavut) publish no well layer; the federal frontier-wells services need a token.
Turkey - MTA's earth-science viewer exposes no data endpoint; no public well service found. Some Turkish boreholes may appear in EU-GSEU.
Hungary, Austria, Romania, Greece, Spain, Bulgaria, Serbia, the Baltics, Ukraine - No national keyless deep-well service found: Hungary's geothermal well cadastre server is broken, Spain's IGME layer has only names and basins, Austria publishes thermal springs and a core store, Estonia's service blocks text search, and Ukraine's well register sits behind the e-subsoil login. EU-GSEU carries deep boreholes (many geothermal, with bottom-hole temperatures) from these surveys, and EU-DARLINGE adds Hungarian, Romanian and Serbian thermal-water wells.
Gulf states, Iraq, Iran, Kazakhstan, Mongolia - No public well service: the Saudi Geological Survey's data services need a token, Kazakhstan's subsoil-fund GIS is unreachable, and the national oil companies publish nothing machine-readable. Field level: search_gem_projects; heat flow: search_heat_flow.
Indonesia (geothermal) - The energy ministry's geoportal publishes geothermal prospects and working areas but no wells. ID-MIGAS is oil and gas.
Kenya - No official machine-readable registry. Petroleum exploration wells: KE-PET, an unofficial copy of the State Department for Petroleum's map. Geothermal wells (Olkaria, Menengai) are held by KenGen and GDC, whose GIS hosts are not public; some Olkaria research data is in the DOE GDR (search_geothermal_datasets); heat flow and temperature gradients across the Kenya Rift: search_heat_flow; plant level: search_gem_projects.
Namibia - No public well registry. The Ministry of Mines and Energy's petroleum licence layers (Landfolio cadastre) need a token, and NAMCOR sells E&P data (incl. the offshore Orange Basin discoveries). Heat flow: search_heat_flow; field level: search_gem_projects.
Uganda, Ghana, Nigeria, Ethiopia, Egypt and the rest of Africa without a source - No keyless official well service found. Uganda's (PAU) and Ghana's (GNPC) ArcGIS Online well layers answer 'Token Required' - apparently lapsed subscriptions, so they may return. Egypt's and Nigeria's data repositories need a login; Morocco, Tunisia and the others publish licences, blocks or nothing. Heat flow: search_heat_flow; field level: search_gem_projects.
New Zealand (national geothermal database) - GNS Science's GGW database is a click-through web app whose terms allow internal use only (no publishing), so it is not used. Geothermal wells come from regional councils instead: NZ-WAIKATO and NZ-BOP. NZP&M petroleum wells are in NZ-PET.
Japan - Not yet supported: the Geological Survey of Japan publishes borehole temperatures (GT-4) only as static GeoJSON files; no well registry service found.
Philippines, India, Malaysia, Pakistan and the rest of South and East Asia without a source - No keyless well service found: India's national data repository and Pakistan's PPIS need a login, the Philippine DOE's GIS times out, Timor-Leste's data sit in a virtual data room, Taiwan's files are behind a bot block, and the others publish PDFs or nothing.
Related MCP server: mcp-arcgis-albuquerque
Tools
Tool | What it does |
| Coverage index; pass |
| Search by operator, well name, county/area, field, status or type in one source, a state, a country, or everywhere. |
| One well's full raw record by identifier. US API numbers in any format are routed to the right state by their 2-digit API prefix, and also return the well's FracFocus frac jobs (with the chemical list), borehole temperatures and orphaned-well listing where they exist; UWIs, wellbore names and agency codes work with |
| Every well within a radius of a point. Only sources whose coverage area overlaps the circle are asked, so it works anywhere without picking a source |
| The exact operator strings a source uses ( |
| Raw SQL-92 |
| DOE geothermal datasets: text search via OSTI, or - given a latitude/longitude - the Geothermal Data Repository catalog's footprints, returning datasets that cover the place with direct file links (Cape Station, Utah FORGE, Newberry...) |
| Bundled IHFC Global Heat Flow Database (offline): ~91,000 heat-flow measurements worldwide with temperature gradient, thermal conductivity, depth and purpose - geothermal screening anywhere, with summary statistics for a radius |
| Bundled Global Energy Monitor trackers (offline): geothermal power units and oil & gas fields worldwide - the fallback where no well registry exists |
What a record looks like
Every source is mapped to the same core fields, then keeps its own extras (temperatures, production, formation, links to scanned well files...):
source, country, state, api, wellName, operator, status, wellType, field, county, latitude, longitude, spudDate plus whatever else the source publishes
(completionDate, depthMD, depthTVD, waterDepth, bottomHoleTempC...).
apiholds the source's well identifier: a US API number, Canadian UWI, Norwegian wellbore name, BSS code and so on.list_sourcessays which, per source.Coordinates are WGS84 decimal degrees, taken from the server-reprojected geometry (attribute coordinates are often NAD27, ED50 or sign-flipped).
Every
*Datefield is an ISOYYYY-MM-DDstring or null, whatever the source stores (epoch milliseconds,MM/DD/YYYY,DD.MM.YYYY,16-NOV-2017...).Units are the agency's: most US sources use feet, most others metres. Sources that mix units carry a
depthUnitfield.A source that cannot apply a filter you asked for is skipped with a note rather than returning unfiltered results.
Run / register
Requires Node 18+ (native fetch, top-level await); developed on Node 22.
npm install
npm test # offline unit tests
npm run smoke # live: search + id lookup + radius search against every source
npm run smoke -- NO UT # just some sources (matches key, country or state)
claude mcp add --scope user well-data -- node <abs-path>/src/index.jsclaude mcp add stores that absolute path in ~/.claude.json; moving the project
folder breaks the registration until you run it again.
A search with no country or source asks all of the 160-odd services at once. Node
resolves host names on a pool of 4 threads, which then becomes the bottleneck the first
time; registering with -e UV_THREADPOOL_SIZE=32 (before --) roughly halves those
searches. The server cannot raise it itself, because Node starts the pool before any
code runs. Any other MCP client can launch
node src/index.js over stdio the same way. package.json's bin entry means
npx -y well-data-mcp will work if the package is ever published to npm (it isn't yet).
node scripts/call-tool.js <tool> '<json args>' calls one tool over stdio, the way an
MCP client would - handy for trying a query from a terminal.
Adding a source
Each source is one object in src/sources/<region>.js: endpoint, a map from the
normalized filters to the layer's own field names, a normalize(attrs, geometry)
function, a rough extent, and a probe filter known to return hits (the smoke test
uses it). The protocol is a kind:
arcgis(default) - any ArcGIS MapServer/FeatureServer layer. Find layers with…/rest/services?f=json, then a layer's fields with…/MapServer/<id>?f=json. Options cover common server quirks:noPaging,noReproject,nearAsEnvelope,apiNumeric,apiDigits14,dedupeBy+orderBy,baseWhere,fallbackUrl,headers,outFields(seesrc/providers/arcgis.js).wfs- OGC WFS 2.0 with GeoJSON output:dialect: "cql"for GeoServer,dialect: "fes"for MapServer, deegree and others that ignore CQL.bboxAttrsfor a layer whose spatial filters return nothing,sortBywhere paging needs a sort.rrc-ewa- the Texas RRC wellbore query (operator, lease and field for Texas).snapshot- a small layer fetched whole by the source'sload()(an API with no attribute filter, a static GeoJSON or CSV file) and searched in memory; refetched every 12 h (ttlMs). Fine up to a few tens of thousands of records.fracfocus- the FracFocus disclosure API.
Run npm run smoke -- <KEY> until search, id and radius checks pass, then
npm run readme to refresh the tables and the map above.
Data licences and attribution
Each agency's terms apply to its data; list_sources shows the licence where the
agency states one. Notably:
Alabama (State Oil and Gas Board): the terms forbid redistributing the data to third parties without permission. Query it live; don't republish it.
Norway (Sodir): Norwegian Licence for Open Government Data (NLOD).
FracFocus: the site's terms bar republishing its content or using it commercially; its bulk data download may be used without restriction if unaltered. Query it live; for reuse, take the download.
Ecuador (
EC): an unofficial university-hosted copy marked for viewing. Query it live; don't republish it.UK (NSTA): NSTA Open User Licence. Ontario / Canada (NRCan): Open Government Licence. Alberta (AER/AGS): Open Government Licence - Alberta. Argentina (Secretaría de Energía), Colombia (SGC), Victoria, NSW, Northern Territory, Tasmania, Queensland, South Australia, Western Australia: CC BY 4.0. Switzerland (swisstopo): free use, source must be cited. Slovakia (ŠGÚDŠ): free use with the attribution "copyright ŠGÚDŠ".
DOE Geothermal Data Repository datasets: mostly CC BY 4.0 (each result says).
IHFC Global Heat Flow Database bundled in
data/: CC BY 4.0 - cite it as given in everysearch_heat_flowresponse (seedata/ATTRIBUTION.md). Refresh by downloading a new release from GFZ Data Services and runningpython scripts/convert-ihfc.py <zip>.Global Energy Monitor trackers bundled in
data/: CC BY 4.0 - credit "Global Energy Monitor" (seedata/ATTRIBUTION.md). Refresh by downloading a new release from globalenergymonitor.org/download-data,pip install -r scripts/requirements.txt, thenpython scripts/convert-gem.py <dir>.
Source
https://github.com/Wickemu/well-data-mcp - MIT licensed (the code; data licences above).
Available Tools
8 toolsget_wellGet well by API numberA
Look up a specific well by API number and return its FULL raw record from the state source plus the normalized summary. Handles formatting differences (dashes, state prefixes): tries an exact match first, then the bare digits, then a dash-tolerant contains-match on the county + sequence digits — so undashed input still finds wells in sources that store dashed APIs (NM, ND, CO, NV). If state is omitted, tries every state.
Inputs: api (required), state.
list_operatorsList operators matching a nameA
Find the exact operator name strings a state uses (they rarely match what you would guess — 'Fervo Energy Company', 'CALIFORNIA RESOURCES PRODUCTION CORPORATION'). Returns distinct operator names containing the search text, per source. Use before search_wells when an operator search returns nothing.
Inputs: name (required), state.
list_sourcesList well-data sourcesA
List the state regulator well-data sources this server can query: coverage, agency, searchable filters, and caveats. Call this first to see what is available.
Inputs: no named parameters.
raw_queryRaw ArcGIS queryA
Escape hatch: run a raw SQL-92 WHERE clause against one source's ArcGIS layer and get raw attributes back. Use list_sources for source keys; field names are the layer's own (see the searchableFilters mapping, or query with where='1=1' limit=1 to inspect a record). Useful for filters the normalized search does not cover (dates, depths, cumulative production).
Inputs: where (required), source (required), limit, offset, +1 more.
search_gem_projectsSearch global energy projects (GEM)A
Search bundled Global Energy Monitor tracker data: geothermal power units worldwide (Geothermal Power Tracker - covers Kenya/Olkaria, New Zealand, Guadeloupe/Bouillante, Guatemala, US) and upstream oil & gas fields/discoveries (Oil & Gas Extraction Tracker - covers Namibia Orange Basin, Guatemala, NZ). Project/field level, NOT well level. Filters are ANDed, case-insensitive substrings. Local data - fast, works offline. Cite 'Global Energy Monitor' when publishing results.
Inputs: name, limit, status, country, +5 more.
search_geothermal_datasetsSearch DOE geothermal datasets (GDR)A
Search U.S. DOE-funded geothermal project datasets via OSTI Data Explorer - this indexes the Geothermal Data Repository (gdr.openei.org): well logs, stimulation and flow-test data, microseismic, DTS, geologic models. THE source for Fervo Cape Station (search 'cape egs' or 'fervo' - note 'cape station' also matches Cape Grim air station), Utah FORGE, and some international geothermal studies. Terms are ANDed. Returns titles, DOIs, dates, and links to the data.
Inputs: query (required), rows.
search_wellsSearch wellsA
Search state regulator well databases by operator, well/lease name, county, field, status, or type. Returns normalized records (API number, name, operator, status, type, field, county, lat/lon, dates, depths where available) plus source-specific extras. All *Date fields are normalized to ISO 'YYYY-MM-DD' strings (or null) regardless of how the source stores them, so they sort and compare across states. Filters combine with AND. Set count_only=true to size a query before pulling records.
Inputs: api, field, limit, state, +8 more.
wells_nearFind wells near a pointA
Find wells within a radius of a lat/lon point — e.g. all wells on or around a pad, lease, or project site. Searches the geographically relevant sources unless state/source is given.
Inputs: latitude (required), longitude (required), limit, state, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Tools are largely distinct: search_wells, raw_query, and wells_near differ by query mode, while search_gem_projects and search_geothermal_datasets target separate datasets. The only mild ambiguity is between the three 'search_*' tools, but descriptions clearly specify data source and query style.
Most tools follow a clear list_/search_/get_ verb_noun pattern, making the set predictable. raw_query and wells_near break that pattern, but they are still readable and not confusing.
8 tools is well-scoped for the domain: source discovery, operator lookup, normalized search, spatial proximity, raw SQL escape hatch, and specialized project/dataset searches. Each tool earns its place without redundancy.
The surface covers the full read-only workflow: discover sources, inspect operators, query wells by attributes or location, retrieve full records by API, and fall back to raw SQL when needed. The specialized GEM and OSTI searches add meaningful coverage beyond state well data.
Maintenance
Related MCP Connectors
Read-only Texas oil & gas data: operator directory, county production, and dataset catalog.
Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search and query Los Angeles County open geospatial datasets (parcels, parks, etc.) via ArcGIS Feature Services.76 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables searching and querying City of Albuquerque open geospatial datasets (parcels, zoning, public works) via ArcGIS Feature Services, allowing natural language access to GIS data.83 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables searching and querying City of Tulsa GIS open geospatial datasets (parcels, zoning, public works) via ArcGIS Feature Services through natural language or direct MCP tool calls.81 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables searching and querying Stanislaus County GIS open geospatial datasets (parcels, addresses, zoning, public works) via ArcGIS Feature Services. Supports natural language access through Pipeworx gateway.93 npmMIT