Servers Playground How we check Submit a server

Clairwave

Working · 2.6 s

io.github.clairwave/clairwavev0.4.0

Ocean acoustics: propagation models, bathymetry, sound speed, vessel noise, live AIS. Open.

Health & Science

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://www.clairwave.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

about

What Clairwave provides, which models/data back each tool, and limits.

This tool takes no arguments.

Clairwave MCP server | mcptry

Tools (13)

about

What Clairwave provides, which models/data back each tool, and limits.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "title": "aboutArguments",
  "properties": {}
}

estimate_detection_range

Sonar detection range along a bearing from a location (lat/lon or `place`). Transmission loss (TL) is ALWAYS computed: RAM parabolic equation with the location's bathymetry, seasonal sound speed (`month`, default: current month) and seabed. Every other sonar-equation term is optional — anything not given gets a stated, typical default listed in `assumptions` with its source. Tell the user which values were assumed. Detection threshold DT is derived from processing gain (unless given): detection index d from `pd`/`pfa` (default 0.5 / 1e-4 → d ≈ 13.8), then passive (incoherent energy detector): DT = 5·log10(d / (B·T)), B = analysis band, T = `integration_time_s` (default 1 s); active (matched filter): DT = 10·log10(d / (2·B·τ)), B = `bandwidth_hz` (default 100 Hz LFM), τ = `pulse_length_s` (default 0.5 s). DT is in-band SNR, so it can be negative — that IS the processing gain. mode="passive": SE = SL − TL − (NL − DI) − DT. Default target = merchant ship (bulk carrier, AIS 70, 200 m @ 12 kn, JOMOPANS-ECHO decidecade band level) at 6 m; receiver ½ water depth (≤ 30 m), omni (DI 0 — give directivity_index_db for an array). `frequency_hz` is optional: the tool always also evaluates the target's MOST DETECTABLE 1/3-octave band in 50–2000 Hz (`best_band`) — ships are loudest there; a user frequency is reported as asked. If you give `source_level_db` without `frequency_hz`, the range is evaluated at 50 Hz. mode="active" (monostatic, `frequency_hz` required): SE = SL − 2·TL + TS − (NL − DI) − DT, TL from the sonar to the target depth. Defaults: hull sonar at 7 m, SL 220 dB, TS 10 dB (large underwater object, beam aspect), target ½ water depth (≤ 50 m), DI 20 dB (hull array). Noise-limited only: reverberation is NOT included (often the limit in shallow water). NL (unless given) = Wenz ambient noise at the CURRENT forecast wind at the point (Clairwave weather), moderate shipping, in the analysis band. Units: dB re 1 µPa (SL @ 1 m).

read-only

Argument	Type	Description
pd	number
lat	any
lon	any
pfa	number
mode	string
month	any
place	any
bearing_deg	number
bandwidth_hz	any
frequency_hz	any
max_range_km	any
noise_level_db	any
pulse_length_s	any
source_depth_m	any
target_depth_m	any

get_bathymetry

Seafloor depth from Clairwave-served global bathymetry (~450 m resolution). Location: lat/lon or `place` (name resolved to a water point, echoed in `location`). Without a bearing: depth at the point. With a bearing (compass degrees, 0 = north): a depth profile along that transect out to range_km.

read-only

Argument	Type	Description
lat	any
lon	any
place	any
n_points	integer
range_km	number
bearing_deg	any

Input schema (JSON)

{
  "type": "object",
  "title": "get_bathymetryArguments",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lat",
      "default": null
    },
    "lon": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lon",
      "default": null
    },
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null
    },
    "n_points": {
      "type": "integer",
      "title": "N Points",
      "default": 100
    },
    "range_km": {
      "type": "number",
      "title": "Range Km",
      "default": 20
    },
    "bearing_deg": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bearing Deg",
      "default": null
    }
  }
}

get_sound_speed_profile

Seasonal sound-speed profile c(z) at a location (lat/lon or `place` name, e.g. "Halifax approaches") for a calendar month (1-12), from Clairwave-served seasonal temperature/salinity climatology, plus the seabed parameters (compressional/shear speed, density ratio, attenuation, sediment type) at the same point. Cached per 0.1 degree.

read-only

Argument	Type	Description
lat	any
lon	any
month*	integer
place	any

Input schema (JSON)

{
  "type": "object",
  "title": "get_sound_speed_profileArguments",
  "required": [
    "month"
  ],
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lat",
      "default": null
    },
    "lon": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lon",
      "default": null
    },
    "month": {
      "type": "integer",
      "title": "Month"
    },
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null
    }
  }
}

get_vessel

Everything about one vessel: live AIS position/track and static particulars, plus its 3D model (unique photo-derived model if generated, else the class archetype) with GLB URL (bow=+Z, up=+Y) and platform links.

read-only

Argument	Type	Description
mmsi*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_vesselArguments",
  "required": [
    "mmsi"
  ],
  "properties": {
    "mmsi": {
      "type": "string",
      "title": "Mmsi"
    }
  }
}

get_vessel_photo

Photograph of a vessel from Wikimedia Commons, with attribution.

read-only

Argument	Type	Description
imo	any
mmsi	any
name	any

Input schema (JSON)

{
  "type": "object",
  "title": "get_vessel_photoArguments",
  "properties": {
    "imo": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Imo",
      "default": null
    },
    "mmsi": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mmsi",
      "default": null
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Name",
      "default": null
    }
  }
}

habitat_received_level

Broadband received level (dB re 1 uPa) at a fixed site — a fish farm, reef, hydrophone or marine protected area — from the ships around it, power-summed. Each vessel's source level comes from its AIS class, speed and size; transmission loss is a fast broadband model, so this is a screening estimate (use run_transmission_loss for exact site physics). hours_back = 0 uses the live snapshot; > 0 reconstructs a time series from the AIS archive in 10-minute bins (max/median/quiet levels). Location: lat/lon or `place`. Show `open_url` to the user as a clickable link.

read-only

Argument	Type	Description
lat	any
lon	any
top	integer
place	any
hours_back	number
max_range_km	number

Input schema (JSON)

{
  "type": "object",
  "title": "habitat_received_levelArguments",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lat",
      "default": null
    },
    "lon": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lon",
      "default": null
    },
    "top": {
      "type": "integer",
      "title": "Top",
      "default": 10
    },
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null
    },
    "hours_back": {
      "type": "number",
      "title": "Hours Back",
      "default": 0
    },
    "max_range_km": {
      "type": "number",
      "title": "Max Range Km",
      "default": 30
    }
  }
}

resolve_place

Turn a place name ('outside Halifax', 'Strait of Hormuz', 'Bergen, Norway') into water coordinates. Maritime gazetteer first (ports resolve to their approaches, straits/seas to a representative point), then OpenStreetMap. Points on land or shallower than min_depth_m are walked seaward along the gazetteer bearing (or the nearest direction) until deep enough; the original point and the snap are reported. offshore_km pushes the point further out along seaward_bearing_deg. All location tools also accept `place` directly, so a separate call is only needed to inspect.

read-only

Argument	Type	Description
place*	string
min_depth_m	number
offshore_km	any
seaward_bearing_deg	any

Input schema (JSON)

{
  "type": "object",
  "title": "resolve_placeArguments",
  "required": [
    "place"
  ],
  "properties": {
    "place": {
      "type": "string",
      "title": "Place"
    },
    "min_depth_m": {
      "type": "number",
      "title": "Min Depth M",
      "default": 10
    },
    "offshore_km": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Offshore Km",
      "default": null
    },
    "seaward_bearing_deg": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Seaward Bearing Deg",
      "default": null
    }
  }
}

run_bellhop_volume

Full 3D transmission-loss volume around a source (lat/lon or `place`) with Bellhop (all bearings), stored on the platform under a run id. Show `open_url` to the user as a clickable link: it opens this run visualized. Returns the run id, the replication metadata (SSP, seabed, bounding box) and file links (uint8 TL cube .npy + JSON sidecar). Any frequency and radius (keep radius <= ~50 km for reasonable run times).

Argument	Type	Description
lat	any
lon	any
month	integer
place	any
radius_km	number
frequency_hz	number
source_depth_m	number

Input schema (JSON)

{
  "type": "object",
  "title": "run_bellhop_volumeArguments",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lat",
      "default": null
    },
    "lon": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lon",
      "default": null
    },
    "month": {
      "type": "integer",
      "title": "Month",
      "default": 6
    },
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null
    },
    "radius_km": {
      "type": "number",
      "title": "Radius Km",
      "default": 10
    },
    "frequency_hz": {
      "type": "number",
      "title": "Frequency Hz",
      "default": 200
    },
    "source_depth_m": {
      "type": "number",
      "title": "Source Depth M",
      "default": 20
    }
  }
}

run_transmission_loss

Run a physically grounded transmission-loss simulation (RAM parabolic equation) from a source at (lat, lon or `place`, depth) along a compass bearing. Bathymetry, the seasonal sound-speed profile (`month`) and seabed parameters are fetched for the location automatically. Returns TL vs range at the receiver depths (default: source depth, 10 m, 100 m, mid-water), grid statistics, and the full replication bundle. Show `open_url` to the user as a clickable link.

read-only

Argument	Type	Description
lat	any
lon	any
month	integer
place	any
range_km	number
bearing_deg*	number
frequency_hz*	number
source_depth_m*	number
receiver_depths_m

search_vessels

Search live AIS vessels by name or MMSI prefix (global feed).

read-only

Argument	Type	Description
limit	integer
query*	string

Input schema (JSON)

{
  "type": "object",
  "title": "search_vesselsArguments",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 8
    },
    "query": {
      "type": "string",
      "title": "Query"
    }
  }
}

vessel_source_level

Underwater radiated-noise source level of a ship (monopole, dB re 1 uPa m, 6 m reference source depth): decidecade spectrum (10 Hz - 100 kHz; model bands to 31.5 kHz, validated 20 Hz - 20 kHz) and broadband level, from the JOMOPANS-ECHO reference spectrum model (MacGillivray & de Jong 2021, J. Mar. Sci. Eng. 9:369), fitted to 1862 measured ship passes. Individual ships scatter about +/-6 dB rms per band. Give an MMSI (live AIS type/speed/length are used) or explicit AIS ship_type / speed / length. vessel_class overrides the AIS mapping (e.g. "vehicle_carrier", which has no AIS type). Missing speed = the class reference speed; missing length = the class mean length of the measured ships. The spectrum is usable directly as `sl_spectrum`.

read-only

Argument	Type	Description
mmsi	any
beam_m	any
draft_m	any
length_m	any
speed_kn	any
ship_type	any
vessel_class	any

Input schema (JSON)

vessels_near

Live AIS vessels within radius_km of a point (lat/lon or `place`), nearest first, with position, course/speed, type, dimensions and last-update time.

read-only

Argument	Type	Description
lat	any
lon	any
limit	integer
place	any
radius_km	number

Input schema (JSON)

{
  "type": "object",
  "title": "vessels_nearArguments",
  "properties": {
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lat",
      "default": null
    },
    "lon": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lon",
      "default": null
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 30
    },
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null
    },
    "radius_km": {
      "type": "number",
      "title": "Radius Km",
      "default": 25
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "title": "estimate_detection_rangeArguments",
  "properties": {
    "pd": {
      "type": "number",
      "title": "Pd",
      "default": 0.5
    },
    "lat": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lat",
      "default": null
    },
    "lon": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Lon",
      "default": null
    },
    "pfa": {
      "type": "number",
      "title": "Pfa",
      "default": 0.0001
    },
    "mode": {
      "type": "string",
      "title": "Mode",
      "default": "passive"
    },
    "month": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Month",
      "default": null
    },
    "place": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Place",
      "default": null
    },
    "bearing_deg": {
      "type": "number",
      "title": "Bearing Deg",
      "default": 0
    },
    "bandwidth_hz": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bandwidth Hz",
      "default": null
    },
    "frequency_hz": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Frequency Hz",
      "default": null
    },
    "max_range_km": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Range Km",
      "default": null
    },
    "noise_level_db": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Noise Level Db",
      "default": null
    },
    "pulse_length_s": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pulse Length S",
      "default": null
    },
    "source_depth_m": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Depth M",
      "default": null
    },
    "target_depth_m": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Target Depth M",
      "default": null
    },
    "source_level_db": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Level Db",
      "default": null
    },
    "receiver_depth_m": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Receiver Depth M",
      "default": null
    },
    "integration_time_s": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Integration Time S",
      "default": null
    },
    "target_strength_db": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Target Strength Db",
      "default": null
    },
    "directivity_index_db": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Directivity Index Db",
      "default": null
    },
    "detection_threshold_db": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Detection Threshold Db",
      "default": null
    }
  }
}

{
  "type": "object",
  "title": "vessel_source_levelArguments",
  "properties": {
    "mmsi": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mmsi",
      "default": null
    },
    "beam_m": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Beam M",
      "default": null
    },
    "draft_m": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Draft M",
      "default": null
    },
    "length_m": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Length M",
      "default": null
    },
    "speed_kn": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Speed Kn",
      "default": null
    },
    "ship_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ship Type",
      "default": null
    },
    "vessel_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Vessel Class",
      "default": null
    }
  }
}