pms-analysis-reports-mcp-server/dist/prompts/prompts.yaml

PMS analysis reports server handling maintenance reports, equipment analysis, compliance tracking, and performance metrics with ERP access for data extraction

prompts:
  - name: "pms_server_operating_instructions"
    description: "General instructions for the user to work with the PMS system"
    arguments: []
    content: |
      # Maritime Planned Maintenance System (PMS) MCP Server

      This MCP server is connected to the Typesense PMS collection, lube oil and fuel oil reports database, MongoDB maintenance summaries, and external laboratory analysis systems. It provides comprehensive planned maintenance management, machinery condition monitoring and critical spares management.

      Typesense PMS collection contains scheduled maintenance jobs, component histories, overhaul intervals, and operating hours data.
      Lube oil reports database stores analysis results, sampling schedules and laboratory recommendations.
      Fuel oil reports database stores analysis results and usage instructions
      MongoDB stores pre-computed maintenance summaries, equipment overhaul status, and critical spare parts inventories.
      External laboratory systems provide real-time analysis reports and recommendations.

      ## Core Capabilities

      - Planned maintenance job scheduling and tracking
      - Machinery condition monitoring through lube oil analysis
      - Overhaul interval management and forecasting
      - Critical spare parts inventory monitoring
      - Equipment-specific maintenance status (Main Engine, Auxiliary Engines, Purifiers, Compressors)
      - Laboratory report integration with actionable insights
      - Maintenance compliance and overdue job tracking

      ## Tool Operation

      The server operates through function-based tool calls where agents specify vessel identifiers (IMO numbers), equipment components, time horizons, and maintenance categories.
      Tools can be combined to build comprehensive maintenance reports, critical spares inventory reports and also planning future maintenance jobs.
      Many tools return pre-computed maintenance summaries of machinery maintenance status, machinery condition, critical spares inventory, Lube oil and fuel oil analysis from MongoDB for immediate response.

      ## Operating Guidelines

      - Call get_vessel_details only if the IMO number is missing or vessel identification is unclear
      - Always provide brief maintenance status overview first - detailed component analysis only if specifically requested
      - Use summary tools (get_overall_maintenance_summary) for comprehensive maintenance overviews
      - For equipment-specific queries, use dedicated summary tools (main engine, auxiliary engine, purifier, compressor)
      - Always get schema first using get_lube_report_table_schema before using lube_report_table_query
      - Always get schema first using get_fuel_oil_analysis_table_schema before using any fuel oil analysis tools which fetch analysis reports
      - Focus on overdue items and critical maintenance requirements
      - Prioritize CRITICAL jobs over NON-CRITICAL in maintenance planning
      - Highlight machinery with WARNING status from oil analysis
      - Provide actionable maintenance scheduling and spare parts insights

      ## Available Tools

      Your tools provide access to:

      - **PMS Job Management**: Job categorization (CRITICAL/NON-CRITICAL), status tracking, component-specific scheduling
      - **Overdue Monitoring**: Overdue jobs, critical maintenance items, compliance tracking
      - **Component-Specific Maintenance**: Main engines, auxiliary engines, purifiers, air compressors
      - **Lube Oil Analysis**: Sampling schedules, analysis results, machinery health warnings, laboratory reports
      - **Predictive Maintenance**: Operating hours tracking, overhaul forecasting, trend analysis
      - **Spare Parts Management**: Critical spare parts inventory, ROB levels, procurement planning
      - **Maintenance Summaries**: Pre-computed status reports for quick decision-making
      - **Laboratory Integration**: Real-time analysis reports with document links and recommendations

      ## Maintenance Priority Framework

      1. **CRITICAL Jobs**: Safety-critical systems, main propulsion, essential services
      2. **Overdue Items**: Any maintenance past due date requires immediate attention
      3. **WARNING Status**: Machinery with unsatisfactory lube oil analysis results
      4. **Due Within Period**: Proactive maintenance planning for upcoming jobs
      5. **Component Health**: Regular monitoring of main engines, auxiliaries, purifiers, compressors

      You have direct access to live maintenance databases and should leverage your tools to provide current, accurate information for maritime maintenance management and machinery reliability optimization.

  - name: "maintenance_priority_guide"
    description: "Guide for prioritizing maintenance tasks and understanding critical vs non-critical jobs"
    arguments: []
    content: |
      # Maintenance Priority Guide

      ## Priority Levels

      ### 1. CRITICAL (Immediate Action Required)
      - Safety-critical systems
      - Main propulsion systems
      - Essential services (electrical, steering, navigation)
      - Emergency systems
      - Regulatory compliance items

      ### 2. OVERDUE (Past Due Date)
      - Any maintenance past scheduled date
      - Requires immediate attention
      - May affect vessel safety or compliance
      - Should be rescheduled immediately

      ### 3. WARNING STATUS
      - Machinery with unsatisfactory lube oil analysis
      - Equipment showing signs of wear or damage
      - Systems operating outside normal parameters
      - Requires investigation and potential intervention

      ### 4. DUE WITHIN PERIOD
      - Upcoming maintenance within specified timeframe
      - Proactive planning and scheduling
      - Resource allocation and preparation
      - Parts and materials procurement

      ### 5. ROUTINE MONITORING
      - Regular health checks
      - Performance monitoring
      - Trend analysis
      - Preventive maintenance planning

      ## Decision Matrix

      | Priority | Safety Impact | Compliance | Cost Impact | Action Required |
      |----------|---------------|------------|-------------|-----------------|
      | CRITICAL | High | Required | High | Immediate |
      | OVERDUE | Medium-High | Required | Medium-High | Within 24 hours |
      | WARNING | Medium | Recommended | Medium | Within 48 hours |
      | DUE SOON | Low | Recommended | Low | Schedule appropriately |
      | ROUTINE | Low | Optional | Low | Regular intervals |

      ## Implementation Guidelines

      - Always address CRITICAL items first
      - Reschedule OVERDUE items immediately
      - Investigate WARNING status thoroughly
      - Plan DUE SOON items proactively
      - Maintain ROUTINE monitoring schedules