plugin.json

{
  "version": "1.0.0",
  "description": "Find boat types that fit your lifestyle and needs with a guided quiz, personalized recommendations, boat guides, comparisons, and essential gear guidance.",
  "name": "myboatguru",
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "extensions": {
    "com.openai": {
      "interface": {
        "longDescription": "Find the right boat type for the way you want to spend time on the water. MyBoatGuru helps first-time buyers and experienced boaters research which types fit their lifestyle, favorite activities, and practical needs.\n\nOn clients that support interactive apps, use the guided 10-step boat-finder quiz. Preferences you have already shared can be prefilled. Explore your purpose, boating waters, group size, activities, experience, propulsion, storage, budget, features, and maintenance preferences. Review your top three matches with reasons and tradeoffs, go back to change answers, or start again. Match percentages measure preference fit; they are not guarantees.\n\nPrefer a quick answer? Ask for a text recommendation using the preferences you have shared. You can also explore detailed boat-type guides, compare two types side by side, and review an essential boating gear checklist.\n\nThe plugin recommends boat types. It does not provide live sales listings, process purchases, or make reservations. The linked MyBoatGuru website contains affiliate links; the plugin tools do not return affiliate links or process payments.",
        "defaultPrompt": [
          "Help me find the right boat for my lifestyle with the guided quiz.",
          "Compare a pontoon and a bowrider for family outings.",
          "What boating gear should I plan for my first outing?"
        ],
        "developerName": "Hooman Niktafar",
        "shortDescription": "Find the right boat for you",
        "composerIcon": "./assets/icon-public.png",
        "brandColor": "#0284c7",
        "category": "Education & Research",
        "brandColorDark": "#38bdf8",
        "displayName": "MyBoatGuru",
        "logo": "./assets/icon-public.png",
        "websiteURL": "https://myboatguru.com",
        "supportURL": "https://myboatguru.com/contact",
        "privacyPolicyURL": "https://myboatguru.com/privacy",
        "termsOfServiceURL": "https://myboatguru.com/terms",
        "capabilities": [
          "Guided boat-finder quiz",
          "Boat-type recommendations",
          "Boat guides and comparisons",
          "Boating gear checklist"
        ]
      },
      "review": {
        "commerce": false,
        "commerce_description": "The plugin does not provide affiliate links or process purchases. The linked MyBoatGuru website contains affiliate links.",
        "test_cases": {
          "positive": [
            {
              "prompt": "Help me find the right boat for my lifestyle. I want to explore my options.",
              "description": "Fresh conversation in a client supporting MCP app UI. Complete the 10-step quiz using realistic sample answers; also go Back, change one answer, and test Start Over.",
              "tools_triggered": "boat-quiz",
              "expected_behavior": "Open boat-quiz at step=1 without inventing preferences. Render the first question and progress. Submit all accumulated answers with each step; after the last question return up to three ranked boat types with response-supported reasons, tradeoffs, and preference-fit percentages. Back preserves current selections while permitting edits. Start Over clears answers and returns to step 1. Do not claim the plugin saves a shareable result."
            },
            {
              "prompt": "Walk me through choosing a boat. We are a family of four, new to boating, planning family cruises on a freshwater lake, with a $25,000 to $50,000 purchase budget.",
              "description": "Fresh conversation in a UI-capable client. Inspect prefilled choices on the relevant steps, then complete the quiz.",
              "tools_triggered": "boat-quiz",
              "expected_behavior": "Launch boat-quiz with step=1, purpose=family_cruising, water_type=freshwater_lake, crew_count=3_4, experience=first_time, purchase_budget=25k_50k. The response echoes these answers and the widget preselects them on their relevant questions. Known preferences must not cause the assistant to skip the quiz. Preserve accumulated preferences in subsequent calls and derive final matches from the returned recommendations."
            },
            {
              "prompt": "Give me a quick text answer, without a quiz: what boat types fit fishing in shallow saltwater flats?",
              "description": "Fresh conversation; user explicitly chooses the text-only workflow.",
              "tools_triggered": "recommend-boat-type",
              "expected_behavior": "Call recommend-boat-type with purpose=fishing and water_type=shallow_flats, without fabricated budget or crew size. Explain the returned matches and tradeoffs. Treat percentages as preference-fit scores, not guarantees; do not launch boat-quiz."
            },
            {
              "prompt": "Tell me about pontoon boats, then compare a pontoon and a bowrider for family outings.",
              "description": "Fresh conversation; test details and a two-type comparison without launching the quiz.",
              "tools_triggered": "get-boat-type-details, compare-boat-types",
              "expected_behavior": "Call get-boat-type-details with boat_type=pontoon and compare-boat-types with boat_type_a=pontoon and boat_type_b=bowrider, or reversed. Explain returned strengths, limitations, and comparisons, preserving relevant returned MyBoatGuru links. Do not invent live listings."
            },
            {
              "prompt": "What boating gear should I plan to get before my first outing?",
              "description": "Fresh conversation; test the universal boating gear checklist.",
              "tools_triggered": "get-gear-checklist",
              "expected_behavior": "Call get-gear-checklist with no arguments. Summarize response-supported priorities and items. Identify any costs as estimates and do not claim that safety requirements are identical in all countries."
            }
          ],
          "negative": [
            {
              "prompt": "Buy me a pontoon boat and charge my credit card.",
              "description": "Fresh conversation. No MyBoatGuru tool should be called to purchase or charge a card. Explain that the plugin cannot process purchases; do not claim an order was placed."
            },
            {
              "prompt": "Show me actual boats listed for sale near Miami today, with seller phone numbers.",
              "description": "Fresh conversation. Do not invoke MyBoatGuru tools as a live inventory search. Explain that the plugin advises on boat types and does not provide current listings or seller contacts."
            },
            {
              "prompt": "Book a marina slip for me for next Saturday.",
              "description": "Fresh conversation. Do not invoke MyBoatGuru tools for reservations. Explain that booking marina slips is outside the plugin capabilities; do not claim a reservation was made."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=MiLa_M2dydU"
      },
      "publication": {
        "countries": [],
        "release_notes": "Adds the interactive boat-finder quiz with prefilled preferences, Back and Start Over navigation, retry handling, and top-three results with tradeoffs and preference-fit scores. Updates skill guidance to prefer the quiz on UI-capable clients while retaining direct text recommendations, boat details, comparisons, and gear guidance."
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Hooman Niktafar"
  }
}