Petro Mcp

Created By
Groundwork Analytics LLC15 days ago
petro-mcp — Petroleum Engineering MCP Server petro-mcp exposes petroleum engineering workflows to Claude and other MCP-compatible LLMs through natural language. Instead of writing Python scripts, just ask your AI assistant. Capabilities (80+ tools across the full upstream workflow): - Well Logs (LAS): Parse LAS files, extract curves and 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 fits, advanced models (Duong, PLE, SEPD), EUR calculation, Monte Carlo EUR distributions, bootstrap confidence intervals, probabilistic forecasts, price sensitivities. - Rate Transient Analysis (RTA): 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), producing ratios (GOR, WOR, water cut). - PVT & Reservoir: Black-oil correlations (Standing, Beggs-Robinson, Hall-Yarborough, Lee-Gonzalez-Eakin, Sutton), 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. Why petro-mcp? Purpose-built for petroleum engineers. Other energy MCP servers focus on commodity prices; this one runs the actual engineering calculations — log interpretation, decline analysis, reservoir engineering, drilling, production, and economics — all through plain English. Install: pip install petro-mcp → configure in Claude Desktop → ask away. Links: GitHub: https://github.com/petropt/petro-mcp · PyPI: https://pypi.org/project/petro-mcp/ · Web tools: https://tools.petropt.com License: MIT · Author: Groundwork Analytics
Overview

petro-mcp

Petroleum engineering tools for LLMs via the Model Context Protocol.

petro-mcp exposes 80+ petroleum engineering workflows to Claude and other MCP-compatible assistants. Parse LAS well logs, fit decline curves, run RTA, compute PVT correlations, size casing, run nodal analysis, and model well economics — all
through natural language.

Installation

pip install petro-mcp

Claude Desktop Config

{
  "mcpServers": {
    "petro-mcp": {                                                                                                                                                                                                                                
      "command": "petro-mcp",
      "args": []                                                                                                                                                                                                                                  
    }                                                           
  }
}

Capabilities

- Well Logs (LAS): curve/header extraction, Vshale, porosity (density, N-D, sonic, effective), Sw (Archie, Simandoux, Indonesian), permeability (Timur, Coates), net pay                                                                          
- Decline Curve Analysis: Arps exp/hyp/harm, Duong, PLE, SEPD, EUR, Monte Carlo EUR distributions, bootstrap CIs, probabilistic forecasts
- Rate Transient Analysis: Agarwal-Gardner, Blasingame, NPI, flowing material balance, normalized rate, sqrt-time, MBT, permeability, radius of investigation                                                                                     
- Production Analytics: CSV queries, trend/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; brine PVT; bubble point; Co; Z-factor; OOIP/OGIP; recovery factors; Havlena-Odeh; P/Z                                                                   
- Drilling & Wellbore: hydrostatic, ECD, kill mud weight, MAASP, burst/collapse, bit ΔP, nozzle TFA, annular velocity, DLS, vertical section, survey, anticollision, tortuosity                                                                   
- Production Engineering: nodal analysis (Vogel + VLP), Beggs-Brill, choke flow, erosional velocity, Turner/Coleman critical rates, hydrate T/inhibitor, ICP/FCP, HPT                                                                             
- Economics: NPV, IRR, payout, PV10, breakeven price, well economics, operating netback, price sensitivity                                                                                                                                        
- Units: oilfield unit conversions (pressure, rate, volume, length, density, viscosity, …)                                                                                                                                                        
                                                                                                                                                                                                                                                   
Why petro-mcp?                                                                                                                                                                                                                                    
                                                                                                                                                                                                                                                  
Purpose-built for petroleum engineers. Other energy MCP servers focus on commodity prices — petro-mcp runs the actual engineering math: log interpretation, decline analysis, reservoir engineering, drilling, production, and economics.         
 
Links                                                                                                                                                                                                                                             
                                                                
- GitHub: https://github.com/petropt/petro-mcp
- PyPI: https://pypi.org/project/petro-mcp/
- Web tools: https://tools.petropt.com
                                                                                                                                                                                                                                                  
License
                                                                                                                                                                                                                                                  
MIT © Groundwork Analytics LLC

Server Config

{
  "mcpServers": {
    "petro-mcp": {
      "command": "petro-mcp",
      "args": []
    }
  }
}
Project Info
Created At
15 days ago
Updated At
15 days ago
Author Name
Groundwork Analytics LLC
Star
-
Language
-
License
-
Category

Recommend Servers

View All