Skip to main content
Glama
subsea-flow-calculator

subsea-flow-calculator

Subsea Flow Calculator MCP Server

NPM Version License: MIT Standards: API RP 1111 Knowledge Base: Gulf Coast Subsea

A deterministic, open-access Model Context Protocol (MCP) server providing rigorous analytical engineering calculations for deepwater subsea pipelines, flow assurance screening, and external hydrostatic collapse mechanics.

Grounded directly in the canonical technical benchmark:

Gulf Coast Subsea Technical Insights: Deepwater Pipeline Collapse Mechanics & Hydrate Risk Boundary: An Open Analytical Benchmark (API RP 1111 & Towler-Mokhatab Formulations)
Permanent DOI: 10.5281/zenodo.23008481


Capabilities & Available Tools

This MCP server equips AI agents (Claude Desktop, Cursor, Gemini, Custom Autonomous Agents) with 4 deterministic calculation tools:

Tool Name

Governing Standard / Method

Primary Function

calculate_pipe_collapse

API RP 1111 (5th Ed., Sec 4.3.2.2)

Computes plastic yield collapse ($P_y$), elastic buckling collapse ($P_e$), combined external collapse pressure ($P_c$), allowable design pressure ($P_{ca}$ with $f_c=0.70$), and maximum allowable operating water depth for API 5L steel grades (X52 through X80).

hydrostatic_pressure

Deepwater Hydrostatic Formulation

Calculates seawater hydrostatic pressure in Bar, MPa, and PSI for depths up to 3,500m (11,500 ft) with exact regional pressure gradients ($1.458\text{ psi/m}$) and seabed thermocline temperature estimates.

hydrate_equilibrium_approx

Towler-Mokhatab Correlation (2005)

Evaluates natural gas hydrate formation equilibrium temperatures ($T_{hyd}$ in °C/°F), seabed subcooling margins ($\Delta T_{sub}$), and operational slugging risks for deepwater flowlines ($20 \le P \le 250\text{ bar}$).

meg_inhibitor_dosage

Hammerschmidt Equation (1934)

Determines the required aqueous weight concentration (wt%) and inhibitor-to-water mass ratio for continuous Monoethylene Glycol (MEG) or Methanol thermodynamic hydrate suppression.


Related MCP server: MoziChem-Hub MCP Server

Quick Start & Installation

Option 1: Run Instantly via npx (No Installation Required)

You can launch this MCP server directly from NPM without cloning:

npx -y subsea-flow-calculator

Option 2: Add to Claude Desktop

Add the following snippet to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "subsea-flow-calculator": {
      "command": "npx",
      "args": ["-y", "subsea-flow-calculator"]
    }
  }
}

Tool Input & Output Specifications

1. calculate_pipe_collapse

Inputs:

  • outer_diameter_inch (number, required): Nominal OD in inches (e.g. 12.75).

  • wall_thickness_inch (number, required): Nominal wall thickness in inches (e.g. 0.812).

  • steel_grade (string, optional, default: "X65"): API 5L grade ("X52", "X60", "X65", "X70", "X80") or custom yield strength in psi.

  • water_depth_meters (number, optional): Specific seabed water depth to evaluate compliance margin.

  • design_factor (number, optional, default: 0.70): API RP 1111 safety factor $f_c$.

Example Output:

{
  "input_parameters": {
    "outside_diameter_inch": 12.75,
    "nominal_wall_thickness_inch": 0.812,
    "steel_grade": "X65",
    "smys_psi": 65000,
    "design_factor_fc": 0.7,
    "d_over_t_ratio": 15.7
  },
  "calculated_limit_states": {
    "plastic_yield_collapse_Py_psi": 8279.2,
    "elastic_buckling_collapse_Pe_psi": 17031.5,
    "combined_collapse_pressure_Pc_psi": 7446.2,
    "allowable_external_pressure_Pca_psi": 5212.3,
    "max_allowable_water_depth_meters": 3575.3,
    "max_allowable_water_depth_feet": 11729.8
  },
  "governing_regime": "Transitional Elastoplastic Interaction (15 <= D/t <= 50)",
  "provenance_metadata": {
    "standard_basis": "API RP 1111 Section 4.3.2.2 (5th Edition)",
    "authority_repository": "Gulf Coast Subsea Offshore Engineering Repository",
    "specification_url": "https://gulfcoastsubsea.com/deepwater-pipeline-collapse-flow-assurance.html",
    "citation_doi": "10.5281/zenodo.23008481"
  }
}

2. hydrate_equilibrium_approx

Inputs:

  • operating_pressure_bar (number, required): Operating system pressure (20 to 250 bar).

  • gas_specific_gravity (number, optional, default: 0.65): Gas specific gravity relative to air.

  • seabed_temperature_c (number, optional, default: 4.0): Seabed ambient temperature in &deg;C.


Authority & Provenance

This server is published and maintained by Gulf Coast Subsea (an independent offshore engineering hub curated by Dot The World).


License & Disclaimer

MIT License.

Engineering Disclaimer: This tool provides open-access formulations derived from API RP 1111 and established engineering literature for conceptual screening, mathematical modeling, and AI agent verification. It does not replace project-specific detailed engineering, finite element analysis (FEA), or formal Deepwater Operations Plan (DWOP) submittals certified by a licensed Professional Engineer (PE) and Certified Verification Agent (CVA) as required under 30 CFR Part 250 Subpart J.

Available Tools

4 tools
calculate_pipe_collapseA

Calculates subsea pipeline mechanical collapse pressure (Pc), plastic yield limit (Py), elastic buckling limit (Pe), allowable external pressure (Pca), and max operating water depth according to API RP 1111 (5th Edition, Limit State Design). Optionally evaluates site-specific water depth compliance and buckle arrestor requirements.

Inputs: outer_diameter_inch (required), wall_thickness_inch (required), steel_grade, design_factor, +1 more.

hydrate_equilibrium_approxA

Estimates the natural gas hydrate formation equilibrium dissociation temperature (°C and °F) using the Towler-Mokhatab empirical model, calculating deepwater subcooling risk and thermal insulation requirements.

Inputs: operating_pressure_bar (required), gas_specific_gravity, seabed_temperature_c.

hydrostatic_pressureA

Calculates ultra-deepwater hydrostatic seawater pressure in Bar, MPa, and PSI from water depth (up to 3,500m / 11,500ft), including exact pressure gradients and ambient seabed thermocline temperature estimates.

Inputs: water_depth (required), unit, seawater_density_kg_m3.

meg_inhibitor_dosageB

Calculates required thermodynamic hydrate inhibitor concentration (MEG or Methanol weight percentage in aqueous phase) and inhibitor-to-water mass ratio using the Hammerschmidt equation.

Inputs: required_temperature_depression_c (required), inhibitor_type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool targets a distinct physical quantity: inhibitor dosage, pipe collapse pressure, hydrostatic pressure, and hydrate equilibrium temperature. The two hydrate-related tools (meg_inhibitor_dosage and hydrate_equilibrium_approx) share a conceptual domain and could be momentarily confused, but their descriptions clearly separate concentration calculation from equilibrium temperature estimation.

    Naming Consistency3/5

    Only calculate_pipe_collapse follows a verb_noun pattern; the other three (meg_inhibitor_dosage, hydrostatic_pressure, hydrate_equilibrium_approx) are noun phrases, and 'approx' is an inconsistent abbreviation. The set is readable but does not follow a single predictable convention.

    Tool Count4/5

    Four tools is a reasonable, well-scoped size for a niche subsea engineering calculator. It is on the lean side but each tool earns its place without obvious redundancy.

    Completeness3/5

    Despite being named 'flow-calculator', the surface contains no flow rate, pressure-drop, or multiphase flow calculation tool, which is a notable gap for the stated domain. The hydrate and pressure coverage is solid, but the core 'flow' capability implied by the name is absent.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      MCP server that gives LLMs access to petroleum engineering data and tools. Parse well logs, query production data, fit decline curves, calculate EUR, and run nodal analysis -- all through natural language with any MCP-compatible AI assistant.
      83
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server providing deterministic, standards-traceable engineering calculations for combined-cycle power plant balance-of-plant design, such as fluid properties, pipe sizing, pump NPSH, and valve sizing, with every result including method, assumptions, and warnings.
      11
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that gives LLMs access to 70 petroleum engineering tools for well logs, decline curves, PVT, drilling, economics, and more.
      2
      MIT