plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "pick-n-pay-groceries",
  "version": "0.1.1",
  "homepage": "https://www.picknpay.co.za/",
  "description": "Search and compare Pick n Pay groceries using live catalog data and supported price and product filters.",
  "keywords": [
    "groceries",
    "pick-n-pay",
    "product-search",
    "price-comparison"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Pick n Pay Groceries",
        "developerName": "Pick n Pay",
        "logo": "./assets/icon.svg",
        "composerIcon": "./assets/icon.svg",
        "websiteURL": "https://www.picknpay.co.za/",
        "supportURL": "https://www.pnp.co.za/help-and-contact-us",
        "privacyPolicyURL": "https://www.pnp.co.za/privacy-portal",
        "termsOfServiceURL": "https://www.pnp.co.za/ols-tncs",
        "shortDescription": "Find and compare groceries",
        "longDescription": "Find groceries in the Pick n Pay catalog, refine results by price and available product attributes, and compare product details returned by the connected MCP server. Supports search and comparison only.",
        "capabilities": [
          "Search groceries",
          "Browse product filters",
          "Compare products"
        ],
        "defaultPrompt": [
          "Find coffee under R100 at Pick n Pay.",
          "Compare the price per litre of available milk products.",
          "Show me the available filters for breakfast cereals."
        ],
        "category": "Other"
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/drive/folders/1HJEF8hKGnnV-WvtYXdIScWyaHcUqXyW4",
        "test_cases": {
          "positive": [
            {
              "description": "Search for grocery products",
              "prompt": "Show me coffee at Pick n Pay.",
              "tools_triggered": "get_available_company, get_search_results",
              "expected_behavior": "Select the returned Pick n Pay index and show relevant coffee products with available names, images, pack sizes, prices, and promotion conditions. Continue normally without product IDs or links; do not invent missing fields."
            },
            {
              "description": "Apply a price filter and sort results",
              "prompt": "Show coffee under R50, with the lowest prices first.",
              "tools_triggered": "get_available_company, browse_facets, browse_groups, get_search_results",
              "expected_behavior": "Discover the available price facet and a relevant grocery group. Use the returned below-R50 band and supported ascending price sort, then check the displayed products meet the strict budget. Show prices and pack sizes so single sachets are not confused with jars. Preserve the user's constraints and omit unrelated results."
            },
            {
              "description": "Browse a grocery department",
              "prompt": "Let me browse Milk, Dairy & Eggs at Pick n Pay.",
              "tools_triggered": "get_available_company, browse_groups, get_browse_results",
              "expected_behavior": "Discover the requested department and browse using its returned group ID. Present products from that department using available catalog information and offer relevant refinements. Missing product IDs or links do not interrupt browsing."
            },
            {
              "description": "Browse coffee by brand",
              "prompt": "Show me Nescafe coffee products at Pick n Pay.",
              "tools_triggered": "get_available_company, browse_facets, browse_facet_options, browse_groups, get_browse_results",
              "expected_behavior": "Discover the brand facet, its actual NESCAFE value, and the relevant grocery department. Browse matching brand products with their available prices and pack sizes, distinguishing Smart Shopper or multi-buy conditions where returned."
            },
            {
              "description": "Compare equivalent grocery pack quantities",
              "prompt": "Compare the price per litre of Pick n Pay UHT full cream milk in a 6 x 1L pack and a single 1L carton.",
              "tools_triggered": "get_available_company, get_search_results",
              "expected_behavior": "Find the requested UHT full cream milk packs and use their returned prices and explicit pack sizes to calculate price per litre. Label calculated values and rounding, compare like-for-like products, and keep loyalty or promotional conditions distinct. Do not require product IDs, product links, or a detailed lookup."
            }
          ],
          "negative": [
            {
              "description": "Do not perform checkout or payments; explain that the app supports discovery and comparison only.",
              "prompt": "Buy this coffee now and charge my card."
            },
            {
              "description": "Do not change a basket or claim a basket was changed; explain the app's search and browse scope.",
              "prompt": "Add two cartons of milk to my basket."
            },
            {
              "description": "Do not perform account changes or claim access to account administration.",
              "prompt": "Delete my Pick n Pay account."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial release for Pick n Pay grocery search, category and brand browsing, discovered price and attribute filters, and product comparisons. Supports anonymous OAuth. Product IDs and product links are optional; discovery uses available names, images, prices, pack sizes, and promotions."
      },
      "apps": "./.app.json"
    }
  }
}