`gfwfish_4wings_report`

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_4wings_report for the schema, then POST the same URL with its arguments for the data.

Aggregate apparent fishing effort (hours) from Global Fishing Watch over a bounding box and date range, grouped by flag state, gear type or vessel. This is the AIS-derived fishing-pressure layer behind the GFW map — use it for “how much fishing happened in this area, by whose fleet”. Requires your own free GFW API token, passed as _apiKey.

Parameters

Name	Type	Required	Description
`bbox`	string	no	Bounding box as “minLon,minLat,maxLon,maxLat” in WGS84, e.g. “-80,-10,-70,0”. Required unless you pass region_id instead.
`region_id`	string	no	A named GFW region id instead of a bbox — e.g. an EEZ id such as “8371”. Takes precedence over bbox.
`region_dataset`	string	no	Which region dataset region_id belongs to. Default “public-eez-areas”; also “public-mpa-all” and “public-rfmo”.
`start_date`	string	yes	Start date, YYYY-MM-DD.
`end_date`	string	yes	End date, YYYY-MM-DD.
`group_by`	string	no	One of “FLAG”, “GEARTYPE”, “VESSEL_ID”, “FLAGANDGEARTYPE”, “MMSI”. Default “FLAG”.
`temporal_resolution`	string	no	One of “HOURLY”, “DAILY”, “MONTHLY”, “YEARLY”, “ENTIRE”. Default “ENTIRE”.
`spatial_resolution`	string	no	One of “LOW” (0.1 degree) or “HIGH” (0.01 degree). Default “LOW”.
`datasets`	string	no	Comma-separated GFW effort datasets. Default “public-global-fishing-effort:latest”.
`filters`	string	no	Comma-separated upstream filter expressions, e.g. “geartype in (‘trawlers’)”.
`_apiKey`	string	no	Your own Global Fishing Watch API token (BYO). ${KEY_HELP}

Example call

Arguments

{
  "bbox": "-80,-10,-70,0",
  "start_date": "2023-01-01",
  "end_date": "2023-12-31",
  "group_by": "FLAG"
}

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_4wings_report","arguments":{"bbox":"-80,-10,-70,0","start_date":"2023-01-01","end_date":"2023-12-31","group_by":"FLAG"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('gfwfish_4wings_report', {
  "bbox": "-80,-10,-70,0",
  "start_date": "2023-01-01",
  "end_date": "2023-12-31",
  "group_by": "FLAG"
});

More examples

{
  "region_id": "8371",
  "start_date": "2024-01-01",
  "end_date": "2024-03-31",
  "group_by": "GEARTYPE",
  "temporal_resolution": "MONTHLY"
}

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_4wings_report