Transport
Data source: BarentsWatch
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/barentswatch/
claude_desktop_config.json
{
"mcpServers": {
"gnist-barentswatch": {
"url": "https://context.gnist.ai/mcp/barentswatch/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/barentswatch/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_vessel", "arguments": {"mmsi": 1}}}'
REST API
API Root
https://context.gnist.ai/rest/barentswatch/
5 endpoints available:
GET /rest/barentswatch/get_vesselGET /rest/barentswatch/vessels_in_areaGET /rest/barentswatch/get_vessel_trackGET /rest/barentswatch/search_vesselGET /rest/barentswatch/report_feedback
Shell
curl "https://context.gnist.ai/rest/barentswatch/get_vessel?mmsi=1" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/barentswatch/get_vessel",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"mmsi": 1
},
)
print(resp.json())
Command Line
Command
gc barentswatch
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
get_vesselGet the current position and details for a vessel by MMSI.
| Parameter | Type | Required | Description |
|---|---|---|---|
mmsi | integer | required | 9-digit Maritime Mobile Service Identity number (e.g. 257338000). |
vessels_in_areaGet all vessels currently in a geographic area.
| Parameter | Type | Required | Description |
|---|---|---|---|
bbox | any | optional | Comma-separated bounding box 'lon_min,lat_min,lon_max,lat_max'. |
port_name | any | optional | Named port (e.g. 'oslo', 'rotterdam', 'singapore', 'hamburg'). |
lon_min | any | optional | Bounding box west edge. |
lat_min | any | optional | Bounding box south edge. |
lon_max | any | optional | Bounding box east edge. |
lat_max | any | optional | Bounding box north edge. |
vessel_type | any | optional | Filter by type: 'cargo', 'tanker', 'passenger', 'fishing', 'tug'. |
limit | integer | optional | Maximum vessels to return (1–200, default 50). (default: 50) |
get_vessel_trackGet the recent position history (track) for a vessel.
| Parameter | Type | Required | Description |
|---|---|---|---|
mmsi | integer | required | 9-digit MMSI number. |
hours | integer | optional | How many hours of history to return (1–168, default 24). (default: 24) |
search_vesselSearch for vessels by name (partial match).
| Parameter | Type | Required | Description |
|---|---|---|---|
name_query | string | required | Vessel name or partial name (e.g. 'Stena', 'Nordic Eagle'). |
flag | any | optional | Optional country filter — ISO 2-letter code (e.g. 'NO', 'NL'). |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |