`gfwfish_events`

Pack: global-fishing-watch · 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/gfwfish_events for the schema, then POST the same URL with its arguments for the data.

Global Fishing Watch vessel events over a date range — apparent fishing, encounters between vessels at sea, loitering, port visits and AIS gaps (transmission switched off). Each event carries its position, start/end time and the vessels involved. Answers “where was this vessel fishing”, “did it meet another vessel at sea”, “did it go dark”. Requires your own free GFW API token, passed as _apiKey.

Parameters

Name	Type	Required	Description
`vessel_id`	string	no	GFW vessel id from gfwfish_vessels_search (comma-separate for several). Omit to search all vessels in the window.
`event_type`	string	no	One of “fishing”, “encounter”, “loitering”, “port_visit”, “gap”. Default “fishing”.
`start_date`	string	yes	Start date, YYYY-MM-DD.
`end_date`	string	yes	End date, YYYY-MM-DD.
`limit`	number	no	Max events to return (1-100, default 20).
`offset`	number	no	Skip this many events (default 0). Events page by offset; the response returns next_offset.
`_apiKey`	string	no	Your own Global Fishing Watch API token (BYO). ${KEY_HELP}

Example call

Arguments

{
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "event_type": "fishing",
  "limit": 3
}

curl

curl -X POST https://gateway.pipeworx.io/global-fishing-watch/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gfwfish_events","arguments":{"start_date":"2024-01-01","end_date":"2024-01-31","event_type":"fishing","limit":3}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('gfwfish_events', {
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "event_type": "fishing",
  "limit": 3
});

More examples

{
  "start_date": "2024-01-01",
  "end_date": "2024-06-30",
  "event_type": "port_visit",
  "vessel_id": "2934e7640-0d19-ad59-bcff-9dedb141149d",
  "limit": 2
}

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 global-fishing-watch pack

{
  "mcpServers": {
    "global-fishing-watch": {
      "url": "https://gateway.pipeworx.io/global-fishing-watch/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

gfwfish_events