plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "brickfact",
  "version": "1.1.1",
  "description": "Discover LEGO sets and compare monitored retailer offers for LEGO shopping.",
  "author": {
    "name": "Brickfact",
    "email": "info@brickfact.com",
    "url": "https://brickfact.com"
  },
  "homepage": "https://brickfact.com",
  "keywords": [
    "lego",
    "sets",
    "price comparison",
    "collecting"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Brickfact",
        "shortDescription": "Compare LEGO shopping offers",
        "longDescription": "Brickfact helps shoppers discover LEGO sets, compare monitored retailer offers and inspect recorded retailer price history. Search with delivered-price budgets in Germany, Austria, Switzerland, the United Kingdom, United States, France, Netherlands, Spain and Italy. Show available retailer observations with their actual dates even when coverage is shorter than requested. Retail history excludes Amazon and unknown shipping; collector market valuations are a separate EUR series for explicit valuation requests. Show shopping cards, compare sets, find alternatives and prepare app handoffs for alerts and watchlists. Interactive features depend on host support. Offers do not guarantee stock or checkout prices. The plugin does not create account alerts or watchlists. Brickfact comparison pages contain disclosed affiliate links. Brickfact is independent of the LEGO Group.",
        "developerName": "Brickfact",
        "category": "Other",
        "capabilities": [
          "Search LEGO sets with delivered budgets",
          "Show shopping cards and comparisons",
          "Assess recorded retail prices",
          "Find alternatives and gifts",
          "Prepare price-alert and watchlist app handoffs"
        ],
        "websiteURL": "https://brickfact.com",
        "supportURL": "https://brickfact.com/imprint",
        "privacyPolicyURL": "https://mcp.brickfact.com/privacy",
        "termsOfServiceURL": "https://brickfact.com/terms",
        "defaultPrompt": [
          "Find LEGO Star Wars sets under \u20ac100 including shipping to Germany.",
          "Show the retail price history of LEGO 75372 in Germany over the last 12 months, including available shorter coverage.",
          "Help me choose a LEGO gift under \u00a360 delivered in the United Kingdom, for a 10-year-old who likes cars."
        ],
        "brandColor": "#3989E3",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Delivered budget search and shopping cards",
              "prompt": "Find LEGO Star Wars sets under \u20ac100 including shipping to Germany.",
              "tools_triggered": "list_themes, search_sets, render_sets",
              "expected_behavior": "Use market DE and price_basis delivered. Filter budgets before pagination, exclude unknown shipping and show returned set IDs as cards; do not infer stock."
            },
            {
              "description": "Retail history with partial coverage and deal assessment",
              "prompt": "Zeige die H\u00e4ndlerpreisentwicklung von LEGO 75372 in Deutschland in den letzten 12 Monaten und ordne den aktuellen Preis ein.",
              "tools_triggered": "get_retail_price_history, assess_deal",
              "expected_behavior": "Call retail history with market DE and days 365 before any valuation tool. Show all available merchant observations with their actual dates and count even when shorter than 12 months. Assess the current delivered offer only when enough fresh data exists. Do not claim partial coverage is no merchant history, substitute collector market value, fabricate missing months or describe tool failures as empty history. State Amazon exclusion."
            },
            {
              "description": "Gift guidance and comparison",
              "prompt": "Help me choose a LEGO gift under \u00a360 delivered in the United Kingdom, for a 10-year-old who likes cars.",
              "tools_triggered": "list_themes, search_sets, render_sets",
              "expected_behavior": "Retain market GB, GBP delivered budget 60, use returned manufacturer age labels as recommendations, and explain supported matches. Ask only for material missing context; do not promise arrival."
            },
            {
              "description": "Cheaper related sets",
              "prompt": "Find cheaper alternatives to LEGO 75192 delivered in Germany.",
              "tools_triggered": "find_alternatives, render_sets",
              "expected_behavior": "Use cheaper preference and known delivered totals from bounded related candidates. Explain empty results rather than inventing alternatives."
            },
            {
              "description": "Price alert handoff",
              "prompt": "Notify me when LEGO 10311 drops below \u20ac30 in Germany.",
              "tools_triggered": "get_app_handoff",
              "expected_behavior": "Return app steps for price_alert in DE with target 30 EUR and created false. Explain the user must complete setup in the app; no alert is created by the plugin."
            }
          ],
          "negative": [
            {
              "description": "No purchasing or payment capability",
              "prompt": "Buy LEGO 75192 for me using my credit card.",
              "expected_behavior": "Do not request payment details or place an order. Explain the plugin supports public lookups and comparisons only."
            },
            {
              "description": "No private collection access",
              "prompt": "Read my Brickfact account collection and delete all my sets.",
              "expected_behavior": "Do not claim access to private account data or perform writes. Explain that account and collection tools are not included."
            },
            {
              "description": "Unsupported market",
              "prompt": "Find the cheapest LEGO 75192 offer in Australia with Brickfact.",
              "expected_behavior": "Explain AU is unsupported and ask for a supported retailer market. Do not silently substitute another country."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Read-only physical LEGO set discovery and price comparison. Results link to Brickfact comparison pages containing disclosed affiliate links. The plugin does not return retailer affiliate URLs, collect payment details, place orders, embed checkout or sell digital goods. Offer ordering is based on prices rather than commission."
      },
      "publication": {
        "countries": [],
        "release_notes": "Prioritize recorded merchant price history for shopping and price-development questions. Return explicit requested-window and partial-coverage metadata, default to a 365-day window, and keep collector market values separate for explicit requests."
      },
      "apps": "./.app.json"
    }
  },
  "skills": "./skills/"
}