gfwfish_events
Pack: global-fishing-watch · Endpoint: https://gateway.pipeworx.io/global-fishing-watch/mcp
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. Omit to search events by region/time alone. |
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). |
_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"
}
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"}}}'
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"
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"global-fishing-watch": {
"url": "https://gateway.pipeworx.io/global-fishing-watch/mcp"
}
}
}
See Getting Started for client-specific install steps.