plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "partmatch-mcp",
  "version": "0.4.2",
  "description": "Find source-backed refrigerator water-filter compatibility and, when requested, a disclosed purchase path for verified filters.",
  "author": {
    "name": "Softflow.cz",
    "url": "https://softflow.cz"
  },
  "homepage": "https://softflow.cz/partmatch/",
  "keywords": [
    "appliances",
    "compatibility",
    "refrigerator",
    "water filters"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "PartMatch",
        "shortDescription": "Verified appliance part fit",
        "longDescription": "PartMatch checks source-backed refrigerator model and replacement-filter compatibility for people who need a reliable fit answer before buying a replacement. It supports verified Samsung refrigerator water-filter mappings, recognizes revision-sensitive model families without guessing, and returns structured recovery guidance when more model detail is required. When a user explicitly asks where to buy a verified filter, the commerce release can provide a PartMatch-owned purchase page for eligible US purchases. That page may contain a clearly disclosed Amazon.com Associates link; PartMatch does not show Amazon prices, collect payment, or complete checkout inside ChatGPT.",
        "developerName": "Softflow.cz",
        "category": "Other",
        "capabilities": [
          "Check appliance-part fit",
          "Find verified replacement filters",
          "Open a verified purchase page"
        ],
        "websiteURL": "https://softflow.cz/partmatch/",
        "supportURL": "https://partmatch-mcp.vercel.app/support",
        "privacyPolicyURL": "https://softflow.cz/partmatch/privacy/",
        "termsOfServiceURL": "https://softflow.cz/partmatch/terms/",
        "defaultPrompt": [
          "Which water filter fits my Samsung refrigerator?",
          "Check whether this refrigerator filter fits my model.",
          "Where can I buy the verified filter for my Samsung refrigerator?"
        ],
        "logo": "./assets/partmatch.svg",
        "composerIcon": "./assets/partmatch.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a verified filter for a supported Samsung refrigerator model.",
              "prompt": "Which water filter fits my Samsung RF23A9675AP/AA refrigerator?",
              "tools_triggered": "find_compatible_parts",
              "expected_behavior": "Return HAF-QIN/EXP as a source-backed compatible filter and identify Samsung as the evidence publisher."
            },
            {
              "description": "Verify an alias of a compatible Samsung filter.",
              "prompt": "Does HAF-QIN fit my Samsung RF27T5201SR/AA?",
              "tools_triggered": "check_part_fit",
              "expected_behavior": "Return compatible and include the verified HAF-QIN/EXP compatibility record."
            },
            {
              "description": "Verify the full replacement-filter part number.",
              "prompt": "Will HAF-QIN/EXP fit a Samsung RF28T5101SR/AA?",
              "tools_triggered": "check_part_fit",
              "expected_behavior": "Return compatible and provide the matching source-backed compatibility evidence."
            },
            {
              "description": "Recognize a revision-sensitive appliance family without guessing.",
              "prompt": "Does EDR4RXD1 fit my Whirlpool WRF535SWHZ refrigerator?",
              "tools_triggered": "check_part_fit",
              "expected_behavior": "Return unknown_model with coverageStatus revision_required, return no compatible part, and ask for the complete model revision instead of inferring a filter from the base family."
            },
            {
              "description": "Provide a purchase path only after re-verifying an explicitly requested physical replacement filter.",
              "prompt": "I have a Samsung RF27T5201SR/AA and need HAF-QIN. Where can I buy the verified filter in the US?",
              "tools_triggered": "get_purchase_page",
              "expected_behavior": "Re-verify compatibility and, only if compatible, return a PartMatch-owned purchasePageUrl. Do not return an Amazon URL, price, stock claim, or checkout inside ChatGPT."
            }
          ],
          "negative": [
            {
              "description": "Creative writing is unrelated to appliance-part compatibility; PartMatch should not be invoked and ChatGPT should answer without PartMatch.",
              "prompt": "Write a poem about refrigerators."
            },
            {
              "description": "Appliance troubleshooting is outside PartMatch's compatibility scope; PartMatch should not be invoked and ChatGPT should provide general troubleshooting guidance without PartMatch.",
              "prompt": "Why is my freezer making a rattling noise?"
            },
            {
              "description": "Nutrition comparison is unrelated to replacement-part compatibility; PartMatch should not be invoked and ChatGPT should answer without PartMatch.",
              "prompt": "Compare the nutritional value of tap water and bottled water."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "PartMatch supports commerce for eligible physical refrigerator water filters only when the user explicitly asks where to buy. The purchase tool re-verifies fit and returns a PartMatch-owned page; that page may contain a clearly disclosed Amazon.com Associates affiliate link. PartMatch does not show Amazon prices or stock, collect payment information, or complete checkout inside ChatGPT.",
        "demo_recording_url": "https://youtu.be/t8LizMOIFf0"
      },
      "publication": {
        "release_notes": "Updates the PartMatch website, privacy policy, and terms links to dedicated pages on Softflow.cz. The MCP server endpoint, published tools, compatibility dataset, and existing opt-in US-only Amazon purchase behavior are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}