pyResToolbox MCP Server

MCP serverCommunity

Wraps the pyResToolbox library as 108 typed MCP tools for PVT, IPR, nodal analysis, decline curves and simulator tables. By Gabriel Serrão.

46 starsUpdated 8 months agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: pyResToolbox
How it connects: Drives a running copy of the tool
Access: Read-only
Tool versions: pyResToolbox v3.0.4
Operating systems: Windows, macOS, Linux
Needs a pyResToolbox licence: No
Transport: Local (stdio), Remote (HTTP)
AI clients documented: Claude Desktop, Claude Code
Licence: GPL-3.0
Language: Python

What it can do

Gives each calculation its own tool with validated inputs, covering oil and gas PVT, brine and CO2 solubility, IPR, VLP and operating point, decline curves, material balance and geomechanics.
Generates ECLIPSE-style tables such as PVTO, PVDG, PVTW, SWOF and SGOF, AQUTAB influence functions and VFPPROD or VFPINJ lift tables.
Switches between field and metric (ECLIPSE METRIC) units with a flag on each tool.
Ships a companion skill that lists exact parameter names and valid method codes for the tools.

Limitations

Pinned to pyResToolbox v3.0.4; some library functions are only used internally and not exposed as tools.
Correlation-based calculators only; it doesn't run or read a reservoir simulator.
Claude Desktop needs absolute paths to uv and the project folder in its config.

Install

git clone https://github.com/gabrielserrao/pyrestoolbox-mcp.git
cd pyrestoolbox-mcp
make uv-install
make uv-test

Source: github.com/gabrielserrao/pyrestoolbox-mcp#installation

{
  "mcpServers": {
    "pyrestoolbox": {
      "command": "/absolute/path/to/uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/pyrestoolbox-mcp",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

Source: github.com/gabrielserrao/pyrestoolbox-mcp#connect-to-claude-desktop

MCP servers and skills run code on your computer. Review the source before installing.

Skills that come with it

SkillCommunity

pyrestoolbox-mcp skillby Gabriel Serrão

A SKILL.md and parameter reference that teach the agent the exact arguments and method codes of the pyResToolbox MCP tools.

46· updated 8 months ago

AI-generated models, drawings and results must be checked by a qualified engineer before use.