Petromcp

Read well logs with Claude without the data ever leaving your machine. petromcp is an MCP server for petroleum data formats, built for teams whose files legally cannot be uploaded to a cloud service. No telemetry, no phone-home, no automatic updates, and a default-deny path allowlist that refuses to open anything you have not explicitly permitted. LAS today; DLIS, SEG-Y, and pump cards next. Its 9 documented tools cover las, dlis, file, units.

People connecting filesystem tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-03 · ★ 2 · #15 OF 34 MAINTAINED FILESYSTEM · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Petromcp

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add ameyxd-petromcp -- uvx petroleum-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ameyxd-petromcp": {
      "command": "uvx",
      "args": [
        "petroleum-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package petroleum-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.ameyxd is GitHub-verified and matches the repo owner

03 · What Petromcp can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 9 documented tools spanning las, dlis, file, units, including read_las_file, summarize_las_curves, read_las_curve, compare_well_logs.

Capability map

Tools grouped from the project's README - what Petromcp lets an agent do.

Las

3 tools - e.g. Header-level summary of a LAS file; Per-curve min, max, mean, stddev, gap percentage; Depths and values for one curve, with sampling cap

read_las_file · summarize_las_curves · read_las_curve

Dlis

3 tools - e.g. DLIS structure: logical files, frames, index types; Every DLIS channel with its frame, units, and length; One DLIS channel's values, with a sampling cap

read_dlis_file · list_dlis_channels · read_dlis_channel

Compare

1 tool - e.g. Common curves, depth overlap, unit consistency, flags

compare_well_logs

Convert

1 tool - e.g. ftm, psikPa, psibar, bblm3, degFdegC, mDm2

convert_units

read & search

1 tool - e.g. Every convertible pair with its physical quantity

list_supported_units

Latest releases

0.8.1 · 2026-07-27

Fixed · The official MCP registry rejected 0.8.0. It verifies that whoever claims · the io.github.ameyxd/ namespace also controls the PyPI package, by looking · for mcp-name: io.github.ameyxd/petromcp in the published…

0.8.0 · 2026-07-27

Added · petromcp install supports five hosts: Claude Desktop, Claude Code, · Cursor, Codex CLI, and VS Code. · petromcp install --client cursor · petromcp install --client vscode --allow-path ~/petroleum/wells · Hosts…

0.7.0 · 2026-07-27

DLIS support. The format the LAS slice's structure was never tested against: · one physical file holds several logging runs, each with several frames, and a · channel name is unique only within a frame. · Added…

04 · Who maintains Petromcp

petromcp is maintained by ameyxd. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/ameyxd/petromcp
website: https://github.com/ameyxd/petromcp
category: filesystem - ranked #15 of 34 actively-maintained filesystem servers as of 2026-08-25.
release cadence: 4 releases in the last 90 days (latest 2026-07-27)
registry: io.github.ameyxd/petromcp (active, first published 2026-07-27)
packages: pypi:petroleum-mcp

06 · Petromcp FAQ

Is Petromcp still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-03 and it shipped 4 releases in the last 90 days. We re-verify nightly.

What can Petromcp do?

An agent gets 9 documented tools spanning las, dlis, file, units, including read_las_file, summarize_las_curves, read_las_curve, compare_well_logs.

How do I install Petromcp?

Run `uvx petroleum-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Petromcp run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Petromcp

Alternatives to Petromcp

Maintained filesystem servers if Petromcp isn't the fit.

More filesystem MCP servers · Cursor Delegate · Hubd · MCP Film Directory

More Python MCP servers · Luxembourg MCP · ENCODE Toolkit · Talamus · YAAC · Anaconda MCP · see all