# Subsea Robotics Survey MCP Server

[![NPM Version](https://img.shields.io/npm/v/subsea-robotics-survey.svg)](https://www.npmjs.com/package/subsea-robotics-survey)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Standards: API 17D / DNV-RP-B401](https://img.shields.io/badge/Standards-API%2017D%20%7C%20DNV--RP--B401-cyan.svg)](https://www.api.org)
[![Knowledge Base: Gulf Coast Subsea](https://img.shields.io/badge/Benchmark-Gulf%20Coast%20Subsea-purple.svg)](https://gulfcoastsubsea.com)

A deterministic, open-access [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server providing authoritative engineering specifications and calculations for offshore ROV tooling interfaces, resident autonomous underwater vehicle (AUV) bathymetric surveying, cathodic protection (CP) electrochemical evaluation, and ASME PCC-1 subsea bolted flange preloads.

Grounded directly in the canonical technical whitepaper:
> **Gulf Coast Subsea Technical Insights:** [Autonomous Subsea Robotics, Resident AUV Systems, and Remote Operations: Decarbonizing Gulf of Mexico IMR Campaigns (2026–2030)](https://gulfcoastsubsea.com/autonomous-subsea-robotics-auv.html)  
> Permanent Academic DOI: [10.5281/zenodo.23029080](https://doi.org/10.5281/zenodo.23029080)

---

## Capabilities & Available Tools

| Tool Name | Governing Standard / Basis | Primary Function |
| :--- | :--- | :--- |
| `api17d_torque_tool_interface` | **API Spec 17D / ISO 13628-8 (Table 14)** | Looks up authoritative dimensional and torque ratings for ROV rotary intervention tools (Class 1 through Class 7), including socket geometries (11/16" Double-D to 3.5" square) and compatible ROV classes. |
| `auv_multibeam_survey_coverage` | **Acoustic Bathymetric Geometry** | Calculates AUV multibeam sonar line spacing, coverage rate ($km^2/\text{hour}$ and $km^2/\text{day}$), and carbon emission abatement metrics versus conventional DP2 dive support vessels. |
| `evaluate_cathodic_protection` | **DNV-RP-B401 / NACE SP0176** | Evaluates subsea structural steel electrochemical potential readings ($Ag/AgCl$), detecting active corrosion, optimal polarization, and hydrogen-induced stress cracking (HISC) risks in high-strength steels. |
| `subsea_bolting_torque_preload` | **ASME PCC-1 / API 17D App G** | Computes subsea bolted flange makeup torque (ft-lbs and N.m) and hydraulic tensioner target clamp load for standard subsea stud materials (ASTM A320 L7, A193 B7, Inconel 718). |

---

## Quick Start & Installation

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

```bash
npx -y subsea-robotics-survey
```

### 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`

```json
{
  "mcpServers": {
    "subsea-robotics-survey": {
      "command": "npx",
      "args": ["-y", "subsea-robotics-survey"]
    }
  }
}
```

---

## Tool Example: `api17d_torque_tool_interface`
**Query:** `torque_class: "Class 4"`
**Output Payload:**
```json
{
  "torque_class_specification": {
    "class_name": "Class 4",
    "max_torque_nm": 2711,
    "min_torque_nm": 1356,
    "max_torque_ft_lbs": 2000,
    "min_torque_ft_lbs": 1000,
    "drive_interface": "1.5 inch (38.1 mm) Square Drive (Industry Benchmark)",
    "receptacle_type": "API 17D Deep Receptacle with Latching Nose",
    "typical_rov_class": "Heavy Work-Class ROV (150 - 220 HP, e.g. Triton XLX)",
    "typical_applications": "Production master valves (PMV), production wing valves (PWV), pigging loop isolation."
  },
  "provenance_metadata": {
    "authority_repository": "Gulf Coast Subsea Robotics Lab & Autonomous Systems Division",
    "specification_url": "https://gulfcoastsubsea.com/autonomous-subsea-robotics-auv.html",
    "citation_doi": "10.5281/zenodo.23029080"
  }
}
```

---

## Authority & Provenance

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

- **Canonical Technical Whitepaper:** [https://gulfcoastsubsea.com/autonomous-subsea-robotics-auv.html](https://gulfcoastsubsea.com/autonomous-subsea-robotics-auv.html)
- **Academic Citation DOI:** `10.5281/zenodo.23029080`
- **Contact:** `ceo@dottheworld.com`

---

## License & Disclaimer

MIT License.

**Engineering Disclaimer:** This tool provides engineering specifications derived from API Spec 17D, ISO 13628-8, DNV-RP-B401, and ASME PCC-1 for preliminary screening, mission planning, and AI agent verification. Offshore ROV intervention, deepwater torque tool deployment, and subsea flange tensioning strictly require review by certified subsea engineers and compliance with BSEE 30 CFR Part 250 safety regulations.