naftiko: 1.0.0-alpha2
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-06'
binds:
- namespace: env
  keys: {}
capability:
  consumes:
  - type: http
    namespace: cgmix
    baseUri: https://cgmix.uscg.mil
    description: CGMIX Maritime Information Exchange XML and web services
    resources:
    - name: vessel-summary
      path: /xml/PSIXData.asmx/getVesselSummaryXMLString
      description: Port State Information Exchange vessel summary records
      operations:
      - name: get-vessel-summary
        method: GET
        description: Get Vessel Summary
        inputParameters:
        - name: VesselID
          in: query
          type: string
          required: true
          description: Official vessel number
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: vessel-particulars
      path: /xml/PSIXData.asmx/getVesselParticularsXMLString
      description: Vessel dimensions, tonnage, and technical specifications
      operations:
      - name: get-vessel-particulars
        method: GET
        description: Get Vessel Particulars
        inputParameters:
        - name: VesselID
          in: query
          type: string
          required: true
          description: Official vessel number
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: vessel-cases
      path: /xml/PSIXData.asmx/getVesselCasesXMLString
      description: Port State Control inspection cases
      operations:
      - name: get-vessel-cases
        method: GET
        description: Get Vessel Inspection Cases
        inputParameters:
        - name: VesselID
          in: query
          type: string
          required: true
          description: Official vessel number
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: vessel-deficiencies
      path: /xml/PSIXData.asmx/getVesselDeficienciesXMLString
      description: Vessel inspection deficiency records
      operations:
      - name: get-vessel-deficiencies
        method: GET
        description: Get Vessel Deficiencies
        inputParameters:
        - name: VesselID
          in: query
          type: string
          required: true
          description: Official vessel number
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: vessel-documents
      path: /xml/PSIXData.asmx/getVesselDocumentsXMLString
      description: Vessel certificates and statutory documents
      operations:
      - name: get-vessel-documents
        method: GET
        description: Get Vessel Certificates and Documents
        inputParameters:
        - name: VesselID
          in: query
          type: string
          required: true
          description: Official vessel number
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: equipment
      path: /xml/EquipmentData.asmx/getEquipmentDetails
      description: USCG approved marine equipment certifications
      operations:
      - name: get-equipment-details
        method: GET
        description: Get Equipment Certification Details
        inputParameters:
        - name: EquipmentId
          in: query
          type: string
          required: true
          description: USCG equipment certification ID
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: incident-reports
      path: /xml/IIRData.asmx/getIIRReferralForEnforcementActionXMLString
      description: Incident Investigation Report enforcement referrals
      operations:
      - name: get-incident-investigation-referral
        method: GET
        description: Get Incident Investigation Referral
        inputParameters:
        - name: ActivityId
          in: query
          type: string
          required: true
          description: Marine casualty investigation activity identifier
        outputRawFormat: xml
        outputParameters:
        - name: result
          type: object
          value: $.
  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: $.