petro-mcp

Petroleum engineering MCP server that gives LLMs access to 70+ tools across the full upstream workflow.

Installation

pip install petro-mcp                                                                                                                                                                                                                             
                                                                
Configuration                               
                                        
{
  "mcpServers": {                                                                                                                                                                                                                                 
    "petro-mcp": {
      "command": "petro-mcp",                                                                                                                                                                                                                     
      "args": []                                                
    }                                       
  }                                     
}
                                                                                                                                                                                                                                                  
Capabilities
                                                                                                                                                                                                                                                  
Well Logs (LAS)                                                 

Parse LAS files, extract curves/headers, compute Vshale, porosity (density, neutron-density, sonic, effective), water saturation (Archie, Simandoux, Indonesian), permeability (Timur, Coates), and net pay.
                                        
Decline Curve Analysis                      
                                                                                                                                                                                                                                                  
Arps exponential/hyperbolic/harmonic, Duong, PLE, SEPD, EUR calculation, Monte Carlo EUR distributions, bootstrap confidence intervals, probabilistic forecasts, price sensitivity.
                                                                                                                                                                                                                                                  
Rate Transient Analysis                                         
                                                                                                                                                                                                                                                  
Agarwal-Gardner, Blasingame, NPI, flowing material balance, normalized rate, sqrt-time, material balance time, permeability estimation, radius of investigation.
                                                                                                                                                                                                                                                  
Production Analytics                                            
                                                                                                                                                                                                                                                  
CSV production data queries, trend analysis, anomaly detection (shut-ins, rate jumps, water breakthrough, GOR blowouts), GOR/WOR/water cut.
                                                                                                                                                                                                                                                  
PVT & Reservoir                                                 
                                                                                                                                                                                                                                                  
Standing, Beggs-Robinson, Hall-Yarborough, Lee-Gonzalez-Eakin, Sutton pseudocriticals, brine PVT, bubble point, oil compressibility, gas Z-factor, volumetric OOIP/OGIP, recovery factors, Havlena-Odeh, P/Z analysis.
                                                                                                                                                                                                                                                  
Drilling & Wellbore                                             
                                                                                                                                                                                                                                                  
Hydrostatic pressure, ECD, kill mud weight, MAASP, burst/collapse pressure, bit pressure drop, nozzle TFA, annular velocity, dogleg severity, vertical section, well survey, anticollision, wellbore tortuosity.
                                                                                                                                                                                                                                                  
Production Engineering                                          
                                                                                                                                                                                                                                                  
Nodal analysis (Vogel IPR + VLP), Beggs-Brill multiphase flow, choke flow, erosional velocity, Turner/Coleman critical rates, hydrate temperature/inhibitor, ICP/FCP, HPT.
                                                                                                                                                                                                                                                  
Economics                                                       
                                                                                                                                                                                                                                                  
NPV, IRR, payout period, PV10, breakeven price, well economics, operating netback, price sensitivity.
                                                                                                                                                                                                                                                  
Units                                                           
                                                                                                                                                                                                                                                  
Oilfield unit conversions across pressure, rate, volume, length, density, viscosity, and more.
                                                                                                                                                                                                                                                  
Links                                                           
                                                                                                                                                                                                                                                  
- PyPI: https://pypi.org/project/petro-mcp/ 
- GitHub: https://github.com/petropt/petro-mcp                                                                                                                                                                                                    
- Web Tools: https://tools.petropt.com                          
- License: MIT