WellDatabase

Live

Comprehensive well data management and analysis platform for drilling and completion optimization with advanced code execution capabilities.

What is WellDatabase?

WellDatabase provides comprehensive well data management and analysis with powerful code execution capabilities. Access detailed well information, production data, operator intelligence, and geographic analytics through both direct MCP tools and flexible JavaScript/TypeScript code execution. Execute custom queries with advanced filtering by location, operator, depth, dates, and production metrics.

Available Tools

getOperatorWells
Get wells by operator name or ID. Handles name→ID resolution automatically. Recommended for operator searches.
searchWells
Search wells with filters (state, operator, dates, depths). Supports cumulative production sorting (CumOil, CumGas, CumWater, EUR, IP).
searchWellSummary
Search well summary data with aggregated metrics.
searchWellLocation
Search well locations with coordinates and surface hole data.
getWellProductionTimeseries
Get production data for a well by API number. Returns monthly/daily production volumes, summary statistics, and peaks.
getWellDetails
Get full well details by API number including location, operator, status, type, lease, field, basin, and formation.
searchProduction
Search monthly production records (oil, gas, water volumes).
searchProductionSummary
EFFICIENT: Get cumulative production data with sorting. Has cumulativeOil, cumulativeGas, EUR, IP, decline rates.
searchProductionForecast
Search production forecast/decline curve data.
searchProductionForecastSummary
Get aggregated production forecast summaries.
getTopOilProducers
Convenience: Get top oil producers sorted by cumulative oil production.
getTopGasProducers
Convenience: Get top gas producers sorted by cumulative gas production.
searchCompletions
Search well completion records with dates, intervals, and methods.
searchStimulations
Search well stimulation/frac data with proppant and fluid volumes.
searchStimulationSummary
Get aggregated stimulation summary data by well.
searchFracStage
Search individual frac stage data: pressures, rates, proppant, fluid.
searchFracIngredients
Search frac fluid ingredient/chemical data and concentrations.
searchCasings
Search casing string data (surface, intermediate, production) with sizes, weights, depths.
searchPerforations
Search perforation interval data with depths and shot density.
searchPlugs
Search plug data (bridge plugs, frac plugs) with types and depths.
searchPlugAndAbandons
Search plug and abandonment records with P&A details.
searchTubingAndPackers
Search tubing and packer data with sizes and depths.
searchDirectionals
Search directional survey data: MD, TVD, inclination, azimuth.
searchDirectionalStepFormation
Search directional data with formation tops correlated.
searchBoreProfile
Search wellbore profile/trajectory data.
searchBoreProfileReported
Search operator-reported bore profile data.
searchFormations
Search formation/zone data with names and IDs.
searchFormationsReported
Search operator-reported formation tops with depths.
searchHorizon
Search horizon/target formation data and landing points.
searchInterpretedFormation
Search interpreted/normalized formation assignments.
searchCores
Search core sample data with intervals and recovery.
searchInjection
Search injection records (water, CO2, gas) for disposal/injection wells.
searchInjectionSummary
Get cumulative injection summary data.
searchWaterChemicals
Search water chemistry/analysis data for produced water.
searchWaterSummary
Get water production summary data.
searchTests
Search well test data (DST, production tests, formation tests).
searchPermits
Search drilling permit data with numbers, dates, proposed depths.
searchDisposition
Search well disposition/status change data.
searchSpacing
Search well spacing unit data and orders.
searchRigs
Search active rig data with locations, operators, target formations.
searchEnvironmentalIncident
Search environmental incident reports (spills, releases).
searchEnvironmentalIncidentComment
Search comments on environmental incidents.
searchEnvironmentalIncidentSubstance
Search substances involved in environmental incidents.
searchFiles
Search well files and documents (reports, images).
searchFileTags
Search file tags/categories for document classification.
searchHistory
Search well history/event records chronologically.
searchDeletedItems
Search deleted/removed records for audit trail.
searchCounties
Lookup county IDs by name for filtering.
searchStates
Lookup state IDs and FIPS codes.
searchStateCounties
Get counties within a state.
searchCountry
Lookup country information (US, Canada).
searchBasin
Search basin/play data (sedimentary basins).
searchOperatorAliased
Search normalized/standardized operator names.
searchOperatorReported
Search raw operator names as reported to regulators.
searchFieldAliased
Search normalized field names.
searchFieldReported
Search raw field names as reported to regulators.
searchGatherer
Search gas gatherer/pipeline data.
searchStatusAliased
Search normalized well status values (Active, Shut-in, P&A).
searchStatusReported
Search raw well status as reported to regulators.
searchTypeAliased
Search normalized well types (Oil, Gas, Injection).
searchTypeReported
Search raw well types as reported to regulators.
searchLease
Search lease information with names and IDs.
searchShalePlay
Search shale play data (Permian, Eagle Ford, Bakken, etc.).
geoScorecard
Get production scorecard for geographic entities with totals, type curves, operator counts.
operatorScorecard
Get comprehensive operator performance scorecard.
entityScorecard
Get scorecard for any entity type.
wellLifecycleBundle
Get complete well lifecycle data in one call.
geoHierarchyDrilldown
Drill down through geographic hierarchy.
boreProfileLibrary
Get bore profile library data.
getWellLifecycle
Get detailed well lifecycle information.
geoWellTypeMix
Get well type mix for geographic areas.
Code Execution
Execute custom JavaScript/TypeScript code with full WellDatabase connector access for complex queries and workflows.

Requirements

WellDatabase API key
Valid API key from your WellDatabase account
Active WellDatabase account
Active subscription to WellDatabase platform
Compatible AI agent
Works with Claude, ChatGPT, and other MCP-compatible agents

Quick Setup Guide

Follow these steps to connect your AI agents to this connector

Navigate to the Dashboard and add your WellDatabase API key to establish the connection.

Add the WellDatabase MCP server URL to your AI agent's configuration file.

Begin asking your AI agent questions about wells, operators, production data, and geographic analytics. Use direct MCP tools or leverage code execution for custom queries and complex workflows.

Connect to Your AI Assistant

Choose your AI assistant below for specific setup instructions

Follow these steps to connect WellDatabase 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 WellDatabase 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 WellDatabase 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:

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

Example Configuration

Here’s an example using Cambria-MCP:

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