plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "dev-d8412ffa687081918aec3acc5a9b6bf5",
  "version": "1.0.2",
  "description": "Find current stored US coupons, inspect terms, compare a retailer's basket and display a visual coupon board.",
  "keywords": [
    "coupons",
    "promo-codes",
    "discounts",
    "shopping",
    "free-shipping",
    "basket-savings"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "CouponX",
        "shortDescription": "Coupons with clear terms",
        "longDescription": "CouponX helps shoppers find merchant-published US coupons from a bounded, dated inventory. Search by retailer, storefront domain or code; inspect an offer's terms and source; compare potential savings on one retailer's USD basket; and display interactive coupon cards.\n\nCouponX distinguishes eligible savings from conditional estimates and leaves shipping unknown when it has not been supplied. It does not assume coupon stacking, test checkout, compare product prices, buy goods or manage merchant accounts. An empty result describes CouponX's stored inventory, not all coupons available elsewhere.\n\nThe public connection is read-only and requires no CouponX account. Published offers are not checkout-verified. Inventory freshness, merchant exclusions and final checkout eligibility remain visible.\n\nPurchases and payments occur on retailer websites. Supported offers concern US shopping in USD, including when the plugin is used from another country.",
        "category": "Other",
        "capabilities": [
          "Interactive"
        ],
        "defaultPrompt": [
          "Find current iHerb coupons and show their terms.",
          "Compare offers for my $120 first iHerb order.",
          "Show beauty offers from the stores in your inventory."
        ],
        "websiteURL": "https://couponx.coupons/",
        "privacyPolicyURL": "https://couponx.coupons/privacy",
        "logo": "./assets/couponx-icon.png",
        "composerIcon": "./assets/couponx-icon.png",
        "brandColor": "#304d3b",
        "developerName": "Gigamiga",
        "supportURL": "https://couponx.coupons/support",
        "termsOfServiceURL": "https://couponx.coupons/terms"
      },
      "review": {
        "demo_recording_url": "https://couponx.coupons/review/couponx-demo-2026-10-20.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Search the current US inventory for a named retailer, preserve source/eligibility information, and display the returned offers.",
              "prompt": "Do you have any current iHerb coupons?",
              "tools_triggered": "search_coupon_offers; show_coupon_board",
              "expected_behavior": "Search query iHerb with mode live. Display only returned current offer IDs. Include code or redemption method, restrictions, source and checked date. If no current offers remain, state that CouponX has no current stored match and render an empty board; do not claim no coupons exist elsewhere."
            },
            {
              "description": "Retrieve complete terms by a stable offer identifier. Fixture: live-iherb-new20 is a US iHerb offer, genuinely rechecked on October 20, 2026. The inventory hides evidence older than 72 hours.",
              "prompt": "Show me the complete terms and official source for CouponX offer live-iherb-new20.",
              "tools_triggered": "get_coupon_offer; show_coupon_board",
              "expected_behavior": "Call get_coupon_offer with offerId live-iherb-new20. For an available current offer, display that returned ID and explain first-order eligibility, one-use restriction, product exclusions, unknown expiry, official source and checked date. Do not invent checkout verification. If unavailable or stale, explain the inventory limitation and display no invented offer."
            },
            {
              "description": "Compare one merchant's $120 first-order basket while retaining unknown shipping and unprovided eligibility facts.",
              "prompt": "I'm making my first iHerb order for $120, shipping to the US. Which of your offers could save me the most?",
              "tools_triggered": "compare_basket_offers; show_coupon_board",
              "expected_behavior": "Use merchant iHerb, mode live, subtotalCents 12000, customer new, country US, currency USD. Keep shipping, sale-item and basket-category facts unknown unless supplied. Show the server's eligible versus conditional savings and the same basket on the board. Do not assume stacking, final shipping-inclusive cost or checkout acceptance."
            },
            {
              "description": "Search by supported broad category without pretending that a category match proves product stock or product-level eligibility.",
              "prompt": "Show me beauty offers from the stores in your inventory.",
              "tools_triggered": "search_coupon_offers; show_coupon_board",
              "expected_behavior": "Search category Beauty in live mode, without sending the entire conversation as query. Display up to 12 actual result IDs. Explain that these are merchant offers and do not establish specific product availability or eligibility. Handle an empty current inventory explicitly."
            },
            {
              "description": "Exercise a legitimate no-match lookup using the reserved example.com domain, with an honest recovery message.",
              "prompt": "Do you have coupons for example.com?",
              "tools_triggered": "search_coupon_offers; show_coupon_board",
              "expected_behavior": "Search query example.com in live mode. With no matching stored merchant, return no codes, render the empty board with offerIds [], and explain that CouponX has no current stored offer for that domain. Do not search an unrelated retailer or imply a whole-web search."
            }
          ],
          "negative": [
            {
              "description": "Financial bond coupons are outside shopping-coupon discovery. Explain the financial concept without invoking CouponX tools.",
              "prompt": "How do coupon payments on a ten-year Treasury bond work?"
            },
            {
              "description": "Checkout automation and payment are unsupported, and the user explicitly excluded coupon lookup. Explain the limitation without invoking CouponX tools, applying a code or claiming payment was made.",
              "prompt": "Apply a code in my checkout and submit my payment. Do not search for coupons."
            },
            {
              "description": "The public endpoint does not accept shopper feedback or inventory changes. This is a write-only request: do not invoke read tools as a substitute, attempt report_coupon_outcome or claim the outcome was stored.",
              "prompt": "Mark GOLDUS as verified because it worked for me, and save that result in CouponX."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "CouponX is free to use and helps shoppers discover retail offers. Purchases and payment happen on retailer websites; CouponX does not place orders or collect payment details. The intended business model is affiliate commissions. The current code uses direct official merchant URLs; no affiliate network or tracking destinations have been configured yet."
      },
      "publication": {
        "release_notes": "First public release: current US coupon discovery, source/terms lookup, one-retailer basket comparison and an interactive coupon board. Read-only public MCP with no authentication; supports legacy and 2026-07-28 clients.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Gigamiga"
  }
}