USCG Maritime Safety and Compliance

naftiko: "1.0.0-alpha1"

info:
  label: "USCG Maritime Safety and Compliance"
  description: >-
    Unified capability for maritime safety compliance workflows combining USCG
    CGMIX vessel documentation, Port State Control inspection records, equipment
    certifications, and incident investigation data. Used by port agents, marine
    surveyors, vessel operators, and compliance professionals to verify vessel
    compliance with U.S. Coast Guard regulations.
  tags:
    - Maritime Safety
    - Port State Control
    - Vessel Compliance
    - Coast Guard
    - Federal Government
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys: {}

capability:
  consumes:
    - import: cgmix
      location: ./shared/cgmix-maritime-information-exchange.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: maritime-safety-api
      description: "Unified REST API for USCG maritime safety and vessel compliance workflows."
      resources:
        - path: /v1/vessels/{vesselId}
          name: vessels
          description: "Vessel summary and profile information"
          operations:
            - method: GET
              name: get-vessel
              description: "Get comprehensive vessel information by official number"
              call: "cgmix.get-vessel-summary"
              with:
                VesselID: "rest.vesselId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/vessels/{vesselId}/particulars
          name: vessel-particulars
          description: "Vessel technical specifications and dimensions"
          operations:
            - method: GET
              name: get-vessel-particulars
              description: "Get vessel dimensions, tonnage, and technical details"
              call: "cgmix.get-vessel-particulars"
              with:
                VesselID: "rest.vesselId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/vessels/{vesselId}/inspections
          name: vessel-inspections
          description: "Port State Control inspection history"
          operations:
            - method: GET
              name: list-vessel-inspections
              description: "List all Port State Control inspection cases for a vessel"
              call: "cgmix.get-vessel-cases"
              with:
                VesselID: "rest.vesselId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/vessels/{vesselId}/deficiencies
          name: vessel-deficiencies
          description: "Vessel inspection deficiencies and operational controls"
          operations:
            - method: GET
              name: list-vessel-deficiencies
              description: "List all inspection deficiencies for a vessel"
              call: "cgmix.get-vessel-deficiencies"
              with:
                VesselID: "rest.vesselId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/vessels/{vesselId}/certificates
          name: vessel-certificates
          description: "Vessel certificates and statutory documents"
          operations:
            - method: GET
              name: list-vessel-certificates
              description: "List all certificates and documents for a vessel"
              call: "cgmix.get-vessel-documents"
              with:
                VesselID: "rest.vesselId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/equipment/{equipmentId}
          name: equipment
          description: "USCG approved marine equipment certifications"
          operations:
            - method: GET
              name: get-equipment-certification
              description: "Get USCG marine equipment approval and certification details"
              call: "cgmix.get-equipment-details"
              with:
                EquipmentId: "rest.equipmentId"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/incidents/{activityId}
          name: incidents
          description: "Marine casualty incident investigation records"
          operations:
            - method: GET
              name: get-incident-investigation
              description: "Get incident investigation report and enforcement referral data"
              call: "cgmix.get-incident-investigation-referral"
              with:
                ActivityId: "rest.activityId"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: maritime-safety-mcp
      transport: http
      description: "MCP server for AI-assisted maritime safety compliance and vessel research."
      tools:
        - name: get-vessel-summary
          description: "Retrieve summary information for a U.S. Coast Guard documented vessel by official number"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-vessel-summary"
          with:
            VesselID: "tools.vessel_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-vessel-particulars
          description: "Retrieve vessel technical specifications including dimensions, tonnage, and propulsion"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-vessel-particulars"
          with:
            VesselID: "tools.vessel_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-vessel-inspections
          description: "List Port State Control inspection history for a vessel"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-vessel-cases"
          with:
            VesselID: "tools.vessel_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-vessel-deficiencies
          description: "List all safety deficiencies found during vessel inspections"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-vessel-deficiencies"
          with:
            VesselID: "tools.vessel_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-vessel-certificates
          description: "List all regulatory certificates and statutory documents for a vessel"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-vessel-documents"
          with:
            VesselID: "tools.vessel_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-equipment-certification
          description: "Look up USCG approval status for marine safety equipment by certification ID"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-equipment-details"
          with:
            EquipmentId: "tools.equipment_id"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-incident-investigation
          description: "Retrieve marine casualty incident investigation referral and enforcement action data"
          hints:
            readOnly: true
            idempotent: true
          call: "cgmix.get-incident-investigation-referral"
          with:
            ActivityId: "tools.activity_id"
          outputParameters:
            - type: object
              mapping: "$."