petro-mcp
Petroleum Engineering Calculator API — production-ready endpoints for decline curve analysis (Arps DCA, EUR), PVT correlations (Standing, Vasquez-Beggs, Z-factor), petrophysics (Archie Sw, porosity, Vshale), drilling calculations (hydrostatic pressure, ECD, kill sheets), and well economics (NPV, full DCF analysis). Built for petroleum engineers, reservoir engineers, and energy developers.…
4 subscribers
8.6/10 popularity
529 ms avg latency
100% success rate
16 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
petro-mcp endpoints
| Method | Endpoint | Description |
|---|---|---|
| DCA | ||
| POST |
decline_forecast_api_v1_decline_forecast_post /api/v1/decline/forecast |
Generate a month-by-month production rate forecast from given decline parameters. Returns arrays of months and corresponding rates. |
| POST |
decline_eur_api_v1_decline_eur_post /api/v1/decline/eur |
Calculate EUR (Estimated Ultimate Recovery) by integrating the decline curve from time zero to the economic limit or max time. Uses trapezoidal integration for accuracy. |
| POST |
fit_decline_api_v1_decline_fit_post /api/v1/decline/fit |
Fit an Arps decline curve model to time-rate production data using non-linear least squares (scipy curve_fit). Returns fitted parameters, R-squared, and predicted rates. Supports… |
| PVT | ||
| POST |
pvt_bubble_point_api_v1_pvt_bubble_point_post /api/v1/pvt/bubble-point |
Calculate bubble point pressure using the Standing correlation. Input the API gravity, gas specific gravity, temperature, and solution GOR. |
| POST |
pvt_properties_api_v1_pvt_properties_post /api/v1/pvt/properties |
Calculate comprehensive black-oil PVT properties including bubble point pressure, solution GOR, oil FVF, oil viscosity, oil compressibility, and oil density. Supports Standing,… |
| POST |
pvt_z_factor_api_v1_pvt_z_factor_post /api/v1/pvt/z-factor |
Calculate the gas compressibility factor (Z-factor) using Hall-Yarborough or Dranchuk-Abou-Kassem correlations. Supports Wichert-Aziz acid gas correction for H2S and CO2. |
| Petrophysics | ||
| POST |
petrophys_archie_api_v1_petrophys_archie_post /api/v1/petrophys/archie |
Calculate water saturation using the Archie equation: Sw = ((a * Rw) / (phi^m * Rt))^(1/n). Standard parameters for clean, non-shaly formations. |
| POST |
petrophys_porosity_api_v1_petrophys_porosity_post /api/v1/petrophys/porosity |
Calculate porosity from bulk density log using: phi = (rho_matrix - rhob) / (rho_matrix - rho_fluid). Common matrix densities: sandstone=2.65, limestone=2.71, dolomite=2.87 g/cc. |
| POST |
petrophys_vshale_api_v1_petrophys_vshale_post /api/v1/petrophys/vshale |
Calculate shale volume (Vshale) from gamma ray log data. Supports linear, Larionov (Tertiary and Older rocks), and Clavier methods. |
| Drilling | ||
| POST |
drilling_kill_sheet_api_v1_drilling_kill_sheet_post /api/v1/drilling/kill-sheet |
Calculate kill mud weight, Initial Circulating Pressure (ICP), and Final Circulating Pressure (FCP) for the Driller's Method. Essential well control calculation. |
| POST |
drilling_ecd_api_v1_drilling_ecd_post /api/v1/drilling/ecd |
Calculate ECD (Equivalent Circulating Density) by adding annular pressure losses to static mud weight. Critical for avoiding formation fracture while circulating. |
| POST |
drilling_hydrostatic_api_v1_drilling_hydrostatic_post /api/v1/drilling/hydrostatic |
Calculate hydrostatic pressure using: P = 0.052 * mud_weight * TVD. Fundamental drilling calculation for well control and casing design. |
| Economics | ||
| POST |
economics_well_api_v1_economics_well_economics_post /api/v1/economics/well-economics |
Perform a complete discounted cash flow analysis for a well. Calculates NPV, IRR, payout period, and monthly cash flows accounting for royalties, severance taxes, working… |
| POST |
economics_npv_api_v1_economics_npv_post /api/v1/economics/npv |
Calculate NPV from a series of monthly cash flows at a given annual discount rate. Converts annual rate to monthly for discounting. |
| System | ||
| GET |
health_health_get /health |
Health check for load balancers and uptime monitors. |
| GET |
api_catalog_api_v1_docs_get /api/v1/docs |
Returns a JSON catalog of every available endpoint with method, path, summary, description, and tag. Useful for programmatic discovery. |
petro-mcp pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / minute |
|
| PRO | $49 / month | — |
|
| ULTRA | $99 / month | — |
|
