`live_ships_in_area`

Pack: vessel-tracking · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/live_ships_in_area for the schema, then POST the same URL with its arguments for the data.

Live ship positions right now in a geographic area, from AIS radio broadcasts — what vessels are

Parameters

Name	Type	Required	Description
`latitude`	number	no	Centre latitude, e.g. 43.3 for Marseille
`longitude`	number	no	Centre longitude, e.g. 5.4 for Marseille
`radius_km`	number	no	Radius around the centre point in km (default 50, max 500)
`south`	number	no	Bounding box southern latitude (alternative to centre+radius)
`west`	number	no	Bounding box western longitude
`north`	number	no	Bounding box northern latitude
`east`	number	no	Bounding box eastern longitude
`ship_type`	string	no	Optional filter on decoded type, e.g. “tanker”, “cargo”, “passenger”, “fishing”, “tug”
`window_seconds`	number	no	How long to listen, 3-25 seconds (default 12). Longer windows hear more vessels, especially
`limit`	number	no	Maximum vessels to return (default 50, max 300)
`_apiKey`	string	no	aisstream.io API key (free at aisstream.io)

Example call

Arguments

{
  "latitude": 43.3,
  "longitude": 5.4,
  "radius_km": 50,
  "_apiKey": "your-vessel-tracking-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/vessel-tracking/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"live_ships_in_area","arguments":{"latitude":43.3,"longitude":5.4,"radius_km":50,"_apiKey":"your-vessel-tracking-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('live_ships_in_area', {
  "latitude": 43.3,
  "longitude": 5.4,
  "radius_km": 50,
  "_apiKey": "your-vessel-tracking-api-key"
});

More examples

{
  "south": 51.4,
  "west": -0.1,
  "north": 51.5,
  "east": 0.1,
  "ship_type": "tanker",
  "window_seconds": 20,
  "_apiKey": "your-vessel-tracking-api-key"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the vessel-tracking pack

{
  "mcpServers": {
    "vessel-tracking": {
      "url": "https://gateway.pipeworx.io/vessel-tracking/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

live_ships_in_area