# BRAINIAC Maritime Intelligence — Port Congestion Analyzer

> BRAINIAC Maritime Intelligence — Port Congestion Analyzer is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-14).

Analyzes port congestion levels using caller-supplied AIS data, vessel data, and port metrics to identify wait times, berth occupancy, and congestion signals.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/maritime-intelligence/port-congestion-analyze?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-maritime-intelligence-port-congestion-analyzer-a8835779
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZUWZBMeC0UYZsIqFkUygs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-maritime-intelligence-port-congestion-analyzer-a8835779 -d '<json body>'
```

Example prompt: Can you analyze port congestion at Singapore (SGSIN) using the AIS data I'm providing — I need to know if it's currently congested, the average wait hours, how many vessels are waiting, and berth occupancy as of today?

## When to prefer this

Use this endpoint when you have caller-supplied AIS position data, vessel identifiers, or port sample metrics and need a structured congestion analysis without requiring an external paid AIS subscription or API key. It is ideal for supply chain agents, maritime logistics platforms, and compliance workflows that already collect AIS or port data and need automated congestion scoring at a low fixed cost ($0.04 USDC). Prefer alternatives if you need live global AIS data with no prior data collection.

## Known failure modes

- Missing required AIS or port data results in empty or low-confidence findings
- Truncated or malformed base64 file input causes parsing failure
- Exceeding maxItems (500 vessels, 20 files) or maxLength constraints returns a validation error
- No real-time external data: if caller omits AIS points, analysis cannot detect live congestion
- Port codes not recognized may return no matching port entries in results

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object containing per-port congestion status (congested true/false), average wait hours, average vessels waiting, average berth occupancy percentage, a list of findings with codes and details, timestamp of analysis, count of ports analyzed, and a list of data limitations and disclaimers about coverage. No paid AIS or external live data is used — analysis is based entirely on caller-supplied inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "fileBase64"
   ],
   "properties": {
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/octet-stream"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "text/plain",
       "text/csv",
       "application/json",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "vessels": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "imo": {
      "type": "string",
      "maxLength": 20
     },
     "flag": {
      "type": "string",
      "maxLength": 80
     },
     "mmsi": {
      "type": "string",
      "maxLength": 20
     },
     "name": {
      "type": "string",
      "maxLength": 200
     },
     "owner": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "callSign": {
      "type": "string",
      "maxLength": 40
     },
     "operator": {
      "type": "string",
      "maxLength": 200
     },
     "vesselType": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 500
  },
  "aisPoints": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "source": "Caller-supplied",
    "portKey": "sgsin",
    "latestAt": "2026-11-04T21:00:00.000Z",
    "portCode": "SGSIN",
    "portName": "Singapore",
    "congested": true,
    "paidAisUsed": false,
    "sampleCount": 1,
    "averageWaitHours": 30,
    "averageVesselsWaiting": 15,
    "averageBerthOccupancyPct": 90,
    "averageWaitHoursSupplied": true,
    "averageVesselsWaitingSupplied": true,
    "averageBerthOccupancyPctSupplied": true
   }
  ],
  "status": "analyzed",
  "findings": [
   {
    "code": "port_congestion",
    "kind": "observation",
    "detail": "Caller-supplied port metrics exceed local congestion thresholds.",
    "subject": "sgsin"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "portCount": 1,
  "limitations": [
   "Vessel identities, AIS points, waypoints, port samples, demurrage cases, sanctions entries, cargo events, and ownership records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.",
   "No paid AIS service is used and no API key is required. Global real-time vessel coverage is not claimed.",
   "Track gaps, route deviations, and ETA values use only supplied positions/speeds and simple geodesic math. Missing values are not invented.",
   "Sanctions signals are name/IMO comparisons only. Exact matches are labeled as signals, not confirmed legal determinations. Possible matches require human review.",
   "Demurrage amounts use only caller-supplied laytime and rate inputs and are not legal invoices."
  ],
  "ofacFetched": false,
  "paidAisUsed": false,
  "apiKeyRequired": false,
  "congestedCount": 1,
  "paidProviderUsed": false,
  "globalRealtimeCoverageClaimed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-maritime-intelligence-port-congestion-analyzer-a8835779/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
