plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "shipmanager",
  "version": "1.0.3",
  "description": "Ask about your ShipManager fleet in plain language: positions, voyages and SOF times, ISM forms, maintenance, certificates, PSC, crew document expiries and tasks.",
  "author": {
    "name": "Amir Joy",
    "email": "ops@shipmanager.ai",
    "url": "https://shipmanager.ai"
  },
  "homepage": "https://shipmanager.ai",
  "keywords": [
    "shipping",
    "maritime",
    "fleet management",
    "ISM",
    "vessels",
    "voyages",
    "PSC",
    "certificates"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "ShipManager",
        "shortDescription": "Ask about your fleet",
        "longDescription": "ShipManager is fleet management software for shipowners and ship managers, operated and published by Amir Joy (shipmanager.ai). This plugin connects ChatGPT to your company's ShipManager account, so you can ask about your fleet in plain language, in English or Arabic.\n\nAsk what needs attention today, where each ship is and where she is heading, which voyages are open, and what the statement of facts says for a port call. Check which ISM forms are due or waiting for review, which machinery is overdue for overhaul, which certificates and crew documents are about to expire, and how a ship stands before a port state control inspection. Measure sea distances between ports.\n\nYou sign in with your usual ShipManager email and PIN, and you see exactly what your login sees in ShipManager: your own company only, your own ship for a ship login, and only the modules your role allows. Reading is always on. Changes, such as logging running hours, reporting a defect, submitting a noon report or an ISM form, or creating a task, happen only if you tick \"Also make changes\" when you sign in, and every change is recorded in ShipManager's audit log.\n\nThe plugin never reaches money (freight, hire, demurrage, invoices, port dues, wages) or crew personal details, and it never emails or messages anyone outside your company.\n\nYou need a ShipManager account to use this plugin.",
        "developerName": "Amir Joy",
        "category": "Business & Operations",
        "capabilities": [
          "What needs attention today",
          "Ship positions",
          "Voyages and SOF times",
          "ISM forms and reviews",
          "Maintenance and defects",
          "Certificates and PSC",
          "Crew document expiries",
          "Tasks"
        ],
        "websiteURL": "https://shipmanager.ai",
        "supportURL": "https://mcp.shipmanager.ai/support",
        "privacyPolicyURL": "https://mcp.shipmanager.ai/privacy",
        "termsOfServiceURL": "https://mcp.shipmanager.ai/terms",
        "defaultPrompt": [
          "What needs my attention across the fleet today?",
          "Where are our ships right now?",
          "Which certificates expire in the next 90 days?"
        ],
        "brandColor": "#0284C7",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Fleet roll-up of what needs attention",
              "prompt": "What needs my attention across the fleet today?",
              "tools_triggered": "fleet_attention",
              "expected_behavior": "Calls fleet_attention and summarises the items that need attention (due ISM forms, overdue maintenance, expiring certificates and similar) for the signed-in company only."
            },
            {
              "description": "Current ship positions",
              "prompt": "Where are our ships right now, and where is each one heading?",
              "tools_triggered": "vessel_positions",
              "expected_behavior": "Calls vessel_positions and lists each vessel with its latest position, the time of that position and its open voyage or destination where known."
            },
            {
              "description": "Certificates about to expire",
              "prompt": "Which certificates expire in the next 90 days?",
              "tools_triggered": "certificates_expiring",
              "expected_behavior": "Calls certificates_expiring with a 90-day window and lists the certificates by vessel with their expiry dates, soonest first."
            },
            {
              "description": "Sea distance between two ports",
              "prompt": "How far is Constanta from Alexandria by sea, and how many days is that at 12 knots?",
              "tools_triggered": "port_distance",
              "expected_behavior": "Calls port_distance for Constanta to Alexandria, gives the distance in nautical miles and works out the passage time at 12 knots."
            },
            {
              "description": "Open voyages",
              "prompt": "List our open voyages with their load and discharge ports.",
              "tools_triggered": "voyage_list",
              "expected_behavior": "Calls voyage_list and lists the open voyages with vessel, cargo, load port and discharge port. No freight or other money figures appear."
            }
          ],
          "negative": [
            {
              "description": "Creative writing unrelated to the fleet",
              "prompt": "Write a short poem about the sea."
            },
            {
              "description": "General weather question",
              "prompt": "What will the weather be in Rotterdam tomorrow?"
            },
            {
              "description": "Translation unrelated to the fleet's records",
              "prompt": "Translate 'bill of lading' into Arabic."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://youtu.be/nu-jDBnAIo8"
      },
      "publication": {
        "release_notes": "First release: ask about your ShipManager fleet in plain language. Positions, voyages and SOF times, ISM forms, maintenance, certificates, PSC, crew document expiries and tasks, with optional changes when allowed at sign-in."
      },
      "apps": "./.app.json"
    }
  }
}