MCP Tool Reference

PetroBench MCP Tool Reference

The main tools an agent can call on app.petrobench.com/mcp, grouped by task. Your token scopes and role decide which ones it sees.

Tool call

fleet-wells
{
  "mode": "rank",
  "metric": "latest_gearbox_load_pct"
}

Gearbox load, top 3

Example result

Find and Read Wells

find-wells
Search wells by name, API number, tag or filter.

wells:read Read
get-well
Read identity, status, engineering inputs and activity.

wells:read Read
get-well-equipment
Read the pumping unit, rods, tubing, pump and anchor.

wells:read Read
get-well-geometry
Read the wellbore and directional survey.

wells:read Read
get-well-production
Read production trends, water cut and fluid shots.

wells:read Read
fleet-wells
Compare or rank wells on one metric.

wells:read Read
validate-well-data
Check simulation readiness and operating health.

wells:read Read
detect-data-gaps
List wells missing key data.

wells:read Read
query-equipment
Browse the equipment catalog.

wells:read Read

execute-simulation
Build and run a RodSim or RodSim Dynamics case.

simulations:run Run
poll-job
Check a long-running job.

simulations:read Read
query-simulations
Find simulations and stale or failed runs.

simulations:read Read
get-simulation-results
Read metrics and inputs for one run.

simulations:read Read
compare-simulations
Compare up to ten simulations on chosen metrics.

simulations:read Read
analyze-simulation
Read stress and diagnostic detail for a run.

simulations:read Read
manage-simulation-versions
Manage version history for one simulation.

simulations:read Read

manage-well
Create wells and edit identity and status.

wells:write Change
set-well-details
Edit engineering inputs such as water cut and pressures.

wells:write Change
set-well-rods
Replace the rod string.

wells:write Change
set-well-tubing
Replace the tubing string.

wells:write Change
set-well-pumping-unit
Set the pumping unit.

wells:write Change
set-directional-survey
Create a directional survey.

wells:write Change
manage-field-data
Add or edit production and fluid shots.

wells:write Change
import-well-file
Import one well file.

wells:write Change

Your PetroBench account team turns on MCP access for your organization. Then ask your first question in plain words.

Works in