Introduction

get_wells

List wells with optional filtering by field, operator, or status. Includes optional operation summaries for daily operational context (e.g., current drilling activities and day summaries).

get_well_details

Get detailed information for one or many wells by ID. Retrieve well attributes, performance metrics, asset IDs, and company context for specific wells.

list_wells

List wells with automatic pagination support. Efficiently browse through large well datasets with built-in cursor-based pagination.

get_wells_with_asset_ids

List wells with asset_id, company_id, and name. Optimized for mapping wells to Corva assets for real-time data queries.

get_rigs

List rigs with optional filtering by company, search term, or active well status. Includes optional operation summaries showing current drilling activities on active wells.

get_pads

List pads with optional filtering by company, frac fleet, or search term. View multi-well pad configurations and operational status.

get_frac_fleets

List frac fleets with optional filtering by company, pad, or search term. Track completion equipment and crew assignments.

get_wirelines

Get wireline units including logging crews, e-line units, and perforation teams. Monitor wireline service availability and assignments.

get_drillout_units

Get drillout units including plug drill crews and coiled tubing units. Track post-frac completion equipment.

get_drilling_wits

Get real-time drilling data (WITS) for an asset including depth, hook load, WOB, RPM, and other drilling parameters. Requires asset_id from well details.

get_completion_data

Get real-time completion/frac data including stages, pumping parameters, pressures, and rates. Monitor active frac operations with live telemetry.

list_datasets

List available Corva datasets and collections including schema information, provider details, and data availability.

search_datasets

Search Corva datasets by friendly name with fuzzy matching. Find specific data sources quickly across the Corva platform.

search_collections

Search Corva collections by friendly name with fuzzy matching. Locate time-series data collections efficiently.

get_dataset_schema

Get dataset schema including field definitions, data types, and index information. Essential for custom data queries.

get_collection_schema

Alias for get_dataset_schema. Retrieve collection schema with field metadata.

query_dataset_data

Query time-series data from Corva datasets with filtering, sorting, and projection. Access historical drilling, completion, and operational data.

get_company_info

Get Corva company information by company ID including name, settings, and organizational details.

detect_company_context

Detect available companies and provider context from credentials. Understand account access and available data.

get_wells

List wells with advanced filtering by basin, region, state, operator, trajectory, and dates. Supports smart name conversion (e.g., 'Texas' → 'TX'), Enverus operators (in, not, btw, gt, ge, lt, le), and projection controls. Filter by basin names (MIDLAND, DELAWARE, ANADARKO, WILLISTON), regions (PERMIAN, ROCKIES, MID-CONTINENT), trajectories (HORIZONTAL, VERTICAL, DIRECTIONAL), and date ranges. Returns paginated results with up to 1,000 wells per page.

get_well_headers

Fetch lean well header metadata for quick lookups and efficient well searches. Returns essential well identification without heavy payload fields. Ideal for fast well enumeration and API/ID lookups with minimal payload overhead.

get_rigs

Browse Enverus rig datasets with dedicated feeds for active rigs, recent activity, or full search. Supports three views: 'active' for current active rigs, 'activity' for recent rig activity, and 'search' for advanced filtering by basin, state/province (with smart name conversion), operator, county, region, and rig ID. Includes active rig status, completion IDs, and comprehensive pagination support.

get_production

Retrieve production volumes with operator and play filtering. Access oil, gas, and water production data with flexible pagination. Query by producing operator or play name for basin-level production analysis with comprehensive metadata.

get_token_info

Inspect the Enverus bearer token associated with the current request. Returns token metadata, expiration, and scope information. Useful for debugging credential issues, verifying API access, and understanding token lifecycle.

get_wells_for_rig

Get wells associated with a specific rig by rig name. Simplest way to query wells for a rig without complex filtering. Returns well data with comprehensive metadata.

get_basins

Get list of all valid Enverus basin names (e.g., MIDLAND, DELAWARE, ANADARKO, WILLISTON, GOM OFFSHORE). Essential for understanding valid basin filter values.

get_regions

Get list of all valid Enverus region names (e.g., PERMIAN, ROCKIES, MID-CONTINENT, GULF COAST, EASTERN US). Essential for understanding valid region filter values.

get_state_provinces

Get list of all valid state and province codes (e.g., TX, LA, OK, AB, BC, SK). Includes US states, Canadian provinces, and special codes like NGOM (Gulf of Mexico offshore).

bulk_call

Execute the same Enverus tool across multiple items with shared defaults and per-item overrides. Supports concurrent execution with configurable concurrency limits. Returns per-item success/error results for batch operations.

Code Execution

Execute custom JavaScript/TypeScript code with full Enverus connector access. Build complex queries, aggregate data across multiple API calls, perform calculations, and create custom workflows using all available Enverus API methods. Supports both secretKey (auto-exchanged for bearer token) and direct bearerToken authentication.

analyzeLocation

Comprehensive environmental analysis combining wetlands, flood zones, and water features at a coordinate

checkWellSite

Environmental constraints and regulatory recommendations for proposed well locations

queryAtPoint

Query wetlands at a specific coordinate with buffer distance

queryInBbox

Query wetlands within a bounding box

getServiceInfo

Get NWI service metadata and available layers

queryAtPoint

Query flood zones at a specific coordinate

queryInBbox

Query flood zones within a bounding box

getServiceInfo

Get NFHL service metadata and available layers

queryAtPoint

Query water features at a specific coordinate

queryInBbox

Query water features within a bounding box (flowlines or waterbodies)

getServiceInfo

Get NHD service metadata and available layers

queryByAreaSymbol

Query soil map units by county area symbol (e.g., TX201)

queryByMapUnit

Query detailed soil properties by map unit key

getInterpretations

Get soil interpretations for construction suitability

executeQuery

Execute custom Soil Data Access SQL query

getRoutes

Get available routes for a dataset or list all top-level routes. Discover available datasets and their structure. Call with no arguments to see all top-level categories (electricity, natural-gas, petroleum, coal, etc.).

getData

Get data from any dataset route with filtering and pagination. Supports date ranges (start/end), facets for filtering, frequency (annual/monthly/quarterly/daily), sorting, and pagination (length/offset). This is the universal data retrieval function.

getFacets

Get available filter options (facets) for a dataset. Discover what filters are available for a specific dataset before querying. Returns facet names and their descriptions.

getFacetDetails

Get available values for a specific facet. See all possible filter values for a particular facet (e.g., state IDs, sector codes, fuel types). Essential for building accurate filtered queries.

getElectricityData

Convenience function for electricity datasets including retail-sales, facility-fuel, operating-generator-capacity, state-electricity-profiles, and electric-power-operational-data. Simplifies electricity data queries.

getNaturalGasData

Convenience function for natural gas datasets including summary, storage (underground/LNG), production, consumption, imports/exports, and price data. Supports nested routes for detailed categories.

getCoalData

Convenience function for coal datasets including aggregate-production, consumption-and-quality, exports, imports, mine-production, price, shipments, and stocks data.

getPetroleumData

Convenience function for petroleum datasets including crude-oil-imports, crude-oil-production, exports, imports, prices, product-supplied, refinery-operations, reserves, and weekly stocks data.

getSTEOData

Get Short-Term Energy Outlook (STEO) data for near-term energy market forecasts and projections. Covers prices, supply, demand, and consumption projections for all major energy sources.

getAEOData

Get Annual Energy Outlook (AEO) data for long-term energy projections (25+ years). Includes reference cases and alternative scenarios for comprehensive energy planning.

getIEOData

Get International Energy Outlook (IEO) data for global energy projections. Covers international energy consumption, production, and trade by region and fuel type.

getSEDSData

Get State Energy Data System (SEDS) data for state-level energy statistics. Comprehensive state-by-state energy production, consumption, prices, and expenditures.

getTotalEnergyData

Get Total Energy data for overall U.S. energy statistics. Monthly and annual energy production, consumption, imports, exports, and stocks across all energy sources.

getCO2EmissionsData

Get CO2 Emissions data including aggregates by sector and fuel type, carbon coefficients, and emissions intensities. Essential for carbon footprint and sustainability analysis.

getInternationalData

Get International energy data covering global energy statistics by country and region. Production, consumption, reserves, and trade data for major energy sources worldwide.

getNuclearOutagesData

Get Nuclear Outages data including facility-level outages, generator capacity factors, and U.S. nuclear aggregates. Track nuclear plant availability and maintenance schedules.

Code Execution

Execute custom JavaScript/TypeScript code with full EIA connector access. Build complex queries, aggregate data across multiple datasets, perform calculations, create visualizations, and build custom workflows using all available EIA API methods.

getCompanies

Get all companies accessible to the authenticated user. Returns company ID, name, and role (ApiReadUsers or ApiFullAccessUsers).

getFields

Get all fields within a specified company. Returns field ID and name for organizing wells by geographic area.

getWells

Get wells from a company with optional filtering by field ID and date. Returns comprehensive well data including API number, location, coordinates, and status.

getWellStatusOptions

Get valid well status values for a company (e.g., Active, Shut-In, Plugged and Abandoned). Use to interpret well status codes.

getWellDailyProduction

Get daily production data for wells with optional filtering by field, well, and date range. Returns oil (bbl), water (bbl), and gas (mcf) volumes.

Code Execution

Execute custom JavaScript/TypeScript code with full WellOps connector access. Build complex queries, aggregate production data, and create custom reporting workflows.

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.

Execute SQL

Execute SQL queries on your Snowflake data warehouse

List databases

List all accessible databases in your Snowflake account

List tables

List tables in a specific database and schema

Describe table

Get detailed schema information for a table including columns and data types

query

Execute read-only SQL queries with automatic transaction protection

list_tables

List all tables in a database schema with column counts

describe_table

Get detailed column information including data types, constraints, and defaults

list_schemas

List all schemas in the PostgreSQL database

list_devices

List GeoForce tracking devices with latest telemetry, battery status, GPS coordinates, and asset assignments. Returns up to 500 devices per page by default with pagination support.

get_device_by_esn

Fetch a single GeoForce device by Electronic Serial Number (ESN) including latest reading, state, device model, and asset linkage information.

list_repositories

List repositories for the authenticated user or a specific organization

get_repository

Get detailed information about a specific repository

list_issues

List issues for a repository with filtering by state, labels, and assignees

create_issue

Create a new issue in a repository

update_issue

Update an existing issue (title, body, state, labels, assignees)

list_pull_requests

List pull requests for a repository with filtering by state and base branch

get_pull_request

Get detailed information about a specific pull request

create_pull_request

Create a new pull request

list_commits

List commits for a repository or specific branch

get_commit

Get detailed information about a specific commit

list_branches

List branches for a repository

get_file_contents

Get the contents of a file or directory in a repository

search_code

Search for code across repositories

search_issues

Search for issues and pull requests across repositories

list_workflows

List GitHub Actions workflows for a repository

list_workflow_runs

List workflow runs for a repository or specific workflow

get_user

Get information about the authenticated user or a specific user

list_organizations

List organizations for the authenticated user

list_projects

List projects for a user or organization

get_project

Get detailed information about a specific project including fields and views

create_project

Create a new project for a user or organization

update_project

Update project settings (title, description, visibility)

delete_project

Delete a project

list_project_items

List items in a project (issues, pull requests, draft issues)

add_item_to_project

Add an existing issue or pull request to a project

create_draft_issue

Create a draft issue directly in a project

update_project_item

Update a project item's field values (status, priority, dates, etc.)

remove_item_from_project

Remove an item from a project

list_project_fields

List all fields in a project (status, priority, custom fields)

create_project_field

Create a new custom field in a project

update_project_field

Update a project field's settings

list_project_views

List all views in a project (board, table, roadmap)

get_project_view

Get detailed information about a specific view

Plan management

Bucket organization

Task tracking

File access

Document search

Share management

Site access

Document library search

File downloads

Mailbox access

Message search

Read messages

Calendar discovery

Event scheduling

Event updates

Team management

Channel messaging

Chat collaboration

Workbook automation

Worksheet and range updates

Table and chart management

Presentation management

Slide updates

Deck organization

File access

Folder management

Document search

Share management

Document reading

Document creation

Text formatting

Content updates

Spreadsheet automation

Range updates

Formula management

Data analysis

Presentation management

Slide creation

Content updates

Template management

Email reading

Message search

Label management

Thread management

Calendar management

Event scheduling

Event updates

Time management