petro-mcp

A Model Context Protocol server for petroleum engineering calculations.

⚠️ Version notice — do not use pre-1.0.0 releases. Every version before 1.0.0 has been withdrawn: those releases contain critical calculation errors that can produce incorrect engineering results, and their artifacts have been removed from PyPI. Install only 1.0.0 or later — pip install "petro-mcp>=1.0.0". Any copy of an older version obtained from a mirror, cache, or third-party listing should be discarded.

Install

pip install petro-mcp

Run

petro-mcp                              # start the MCP server (stdio)
petro-mcp --list-tools                 # list available tool groups
petro-mcp --tools las,decline          # load only specific groups
petro-mcp --allowed-paths /data/wells  # restrict file reads to a directory

Tool groups

Group	Tools
`las`	Read LAS 2.0 well log files (header, curves, depth-filtered curve data); compare two or more wells
`production`	Load production data from CSV (date, well, oil/gas/water rates)
`decline`	Arps decline-curve fitting (exponential, hyperbolic, harmonic); EUR
`pvt`	Bubble point, black-oil PVT properties, gas Z-factor
`petrophysics`	Shale volume, density porosity, Archie water saturation, net pay
`reservoir`	Volumetric OOIP/OGIP, recovery factor, P/Z gas material balance
`units`	Oilfield unit conversion

Dependencies

mcp >= 1.0
lasio >= 0.31 (LAS file parsing)
numpy >= 1.24
scipy >= 1.10

License

MIT.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

petro_mcp-1.1.2.tar.gz (46.8 kB view details)

Uploaded Aug 17, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

petro_mcp-1.1.2-py3-none-any.whl (35.9 kB view details)

Uploaded Aug 17, 2026 Python 3

File details

Details for the file petro_mcp-1.1.2.tar.gz.

File metadata

Download URL: petro_mcp-1.1.2.tar.gz
Upload date: Aug 17, 2026
Size: 46.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for petro_mcp-1.1.2.tar.gz
Algorithm	Hash digest
SHA256	`08d782a3b686f981aa813dbb0927b1cef4c6eb300bdf72dab70f51c27ab6e041`
MD5	`41e41cc99820f1309ad7929674fed09c`
BLAKE2b-256	`d79261487c12d94c428ae12fc2993b4fa312a33887439f466fb174c4146fd598`

See more details on using hashes here.

File details

Details for the file petro_mcp-1.1.2-py3-none-any.whl.

File metadata

Download URL: petro_mcp-1.1.2-py3-none-any.whl
Upload date: Aug 17, 2026
Size: 35.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.5

File hashes

Hashes for petro_mcp-1.1.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`5a8c6226e67f1730aabb19fbb0004f7f574621c2a1c2792f68c076a6b7fcc856`
MD5	`ac2004a028a59147e05800f745f974da`
BLAKE2b-256	`564ad37280c190af39b8fb58dc2d1f7876625618c577e1177a251b6251e8ef5a`