IL State Geological Survey

Live

Illinois State Geological Survey ILOIL well registry plus oil/gas/storage field polygons and waterflood-area boundaries. ~207K wells with API, status, operator, formation, depth.

What is IL State Geological Survey?

Illinois State Geological Survey (ISGS) — Illinois's official state geological survey. The ILOIL service surface publishes ~207,101 oil and gas wells via layer 8 (note: the wells layer is at index 8, not 0) with a rich schema: API_NUMBER, COMP_DATE, PERMIT_NUMBER, PERMIT_DATE, STATUS code (OIL/OILP/DAP/INJW/...), STATUS_TEXT descriptive (Oil Producer, Oil Producer Plugged, Dry and Abandoned, Water Injection Well, Stratigraphic Test,...), COMPANY_NAME, FARM_NAME, TOTAL_DEPTH, TDFORMATION/TDFMTEXT, LATITUDE/LONGITUDE. Field polygons split across two services: legacy Oil_and_Gas_Fields (~550 polygons, FIELD_TYPE: OIL/GAS/GAS STORAGE) and canonical Oil_Gas_GasStor_Fields_2024 (~1,000+ polygons; brief listed _2023 which is now 404). §0 spec drift caught: Wells layer at index 8, not 0; STATUS column has 100+ codes and STATUS_TEXT has 100+ descriptive variants; FIELD_TYPE on legacy uses upper-snake while FIELDTYPE on 2024 uses camelCase. ; responses normalized to WGS84. Last verified live 2026-05-07.

Available Tools

searchWells
Illinois oil and gas wells (~207K). Filter operator (COMPANY_NAME), status code, status text, formation (TDFMTEXT), depth, bbox/near.
searchOilGasFields
Field boundary polygons. Filter fieldName, fieldType (OIL/GAS/GAS STORAGE). Default canonical 2024 (~1K); pass legacy=true for ~550 legacy polygons.
getWellByApi
Single well lookup by API_NUMBER (12-digit).
searchWaterfloodAreas
Waterflood (secondary-recovery) area boundary polygons.
getServiceInfo
Schema, record counts, and enum values for any of the 4 services.

Requirements

Toggle on
Toggle on and use — no setup needed.

Quick Setup Guide

Follow these steps to connect your AI agents to this connector

Open /mcp and enable IL State Geological Survey with the toggle — no credentials needed.

Call searchWells with operator: 'Continental' and statusText: 'Oil Producer' to explore Illinois Basin oil and gas wells.

Connect to Your AI Assistant

Choose your AI assistant below for specific setup instructions

Follow these steps to connect IL State Geological Survey to Claude:

Step 1: Open Claude Settings

Launch Claude → Click the profile button (bottom left) → Navigate to Settings

Step 2: Access Connectors

Scroll down to the Connectors tab → Navigate to the bottom → Click “Add Custom Connector”

Step 3: Name Your Connector

Enter any name you'd like for this connector

Step 4: Get the Connector URL

Step 5: Add the Connector

Paste the URL in the “Remote MCP Server URL” text box → Click Add

Step 6: Start Using

Your connector is now ready to use in Claude

Follow these steps to connect IL State Geological Survey to ChatGPT:

Step 1: Enable Developer Mode

Go to Settings → Connectors → Advanced → Enable Developer mode

Step 2: Create New Connector

Go back to Connectors page → Click “Create” (top right)

Step 3: Name Your Connector

Enter any name you'd like for this connector (descriptions are optional)

Step 4: Get the Connector URL

Step 5: Add the URL

Paste the URL in the “MCP Server URL” text box

Step 6: Set Authentication

Click the authentication dropdown → Select “No authentication” (PatchOps handles authentication internally)

Step 7: Create the Connector

Click “I understand and want to continue” checkbox → Press Create

Step 8: Using the Connector

Start a new chat → Click the + button (left of text box) → Open dropdown → Hover over three dots labeled “More” → Select your connector

Instructions for connecting IL State Geological Survey to GitHub Copilot:

Coming Soon

Detailed setup instructions for GitHub Copilot will be added here.

For other MCP-compatible platforms:

Step 1: Get the Connector URL

Step 2: Add to Configuration

Add this configuration to your MCP settings file. Replace the URL with your specific connector URL from the /mcp page:

"IL State Geological Survey-MCP": {
  "url": "https://patchops.ai/api/mcp/...",
  "type": "http"
}

Example Configuration

Here’s an example using PatchOps MCP:

"PatchOps-MCP": {
  "url": "https://patchops.ai/api/mcp/...",
  "type": "http"
}