Wellsite

Documentation

MCP Connector Docs

Connect Claude, ChatGPT, or any MCP-enabled AI client to the Wellsite oil & gas data lake.

Connect

MCP Server URL

https://mcp.wellsite.com

How to connect

Add https://mcp.wellsite.com as a remote MCP server in your AI client settings. You'll be prompted to sign in with your Wellsite account via OAuth — no API keys required.

A Wellsite account is required. Sign up at app.wellsite.com.

No API keys needed. OAuth handles authentication securely.

Alert and export features require a Premium subscription ($50/month).

Capabilities

What Claude can do

Look up wells

Search by API number, lease name, or operator. Retrieve completion date, formation, depth, plugged status, and cumulative production.

Pull production history

Monthly oil, gas, and condensate for a well, operator, or county. Up to 60 months of history.

Benchmark performance

Compare a well to its county average or offset operators. Identify outperformers and underperformers.

Screen operators

Rank by production, growth rate, well count, or cumulative output. Narrow by county or district.

Track permits

Find permits by operator, district, county, or proximity. Resolve a permit to its wellbore and back.

Set alerts

Premium

Notify by email, SMS, or webhook when a production threshold is crossed — a heads-up for you or a trigger for your systems. Set once, Wellsite watches continuously.

Reports

Premium

Generate a downloadable report (CSV). Works for any query — wells, production history, permit searches, operator rankings.

Data conventions

Units & formats

Oil volumeBarrels (bbl)
Gas volumeThousand cubic feet (mcf)
Production cyclesYYYYMM strings — e.g. 202511
API numbers8-digit strings
Operator numbers6-digit strings
DistrictsZero-padded — e.g. '08'

Tool reference

Available tools

Full list of MCP tools exposed by the Wellsite connector.

Wells & wellbores

get_wellboreFull wellbore record by API number
find_wellboresSearch by operator, field, county, district, well type, plugged status
find_wellbore_by_permitResolve a permit number to its wellbore(s)
wellbore_statsCounts and depth ranges for an operator, county, or district

Production

get_well_production_historyMonthly oil/gas/condensate for a well
get_operator_production_historyTotal monthly production across an operator's wells
get_county_production_historyCounty-level production rollup
get_well_production_summaryLifetime cumulative and 12-month averages
get_operator_production_summaryOperator rollup with growth/decline rate

Search & rankings

find_wells_by_operatorWells for an operator, highest cumulative oil first
find_wells_by_nameSearch wells by lease name
find_wells_by_countyWells in a county, optionally filtered by operator
find_countiesCounties ranked by cumulative production
find_leasesSearch leases by name, operator, or county
find_leases_by_operatorAll leases for an operator
get_lease_production_historyMonthly production for a lease
get_production_rankingsTop producers for a county or district
get_operator_growth_ratesOperators ranked by growth or decline rate
find_operators_by_nameFind an operator number by name

Permits

get_drilling_permitA permit by number with GPS if available
find_drilling_permitsFilter permits by operator, district, county, month
find_permits_nearPermits within a radius of a lat/long

Premium

create_alertSet a production threshold alert (email, SMS, or webhook)Premium
list_alertsList active alertsPremium
delete_alertRemove an alertPremium
start_exportExport query results to CSVPremium

Support

Questions or integration help?

Reach us at support@wellsite.com