plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "clarmix",
  "version": "1.0.0",
  "description": "Read-only analysis of your Clarmix, Google Ads, Google Merchant Center and Shopify data for Google Shopping, Performance Max and e-commerce PPC.",
  "author": {
    "name": "Clarmix",
    "email": "leo@clarmix.com",
    "url": "https://clarmix.com"
  },
  "homepage": "https://clarmix.com/mcp",
  "keywords": [
    "google ads",
    "google merchant center",
    "google shopping",
    "performance max",
    "pmax",
    "shopify",
    "ppc",
    "e-commerce",
    "product feed",
    "roas"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Clarmix",
        "shortDescription": "Google Ads & Shopping insights",
        "longDescription": "Clarmix is a read-only analytics plugin for Google Shopping advertisers. It connects ChatGPT to your Google Ads, Google Merchant Center (GMC) and Shopify data so you can analyze product-level ad performance, product feed quality and margins, and find what to fix, in plain language. Built for PPC managers, agencies and online merchants running Google Shopping and Performance Max (PMax) campaigns.\n\nWhat you can do:\n- Google Ads: account and campaign performance, ROAS vs target (tROAS), budget-limited campaigns, search terms, Shopping and PMax structure, conversion tracking setup, change history and custom GAQL queries.\n- Product performance: find which products are Profitable, Costly, Zero Conversion or Zombies, follow label trends over time, and check that Clarmix custom labels are actually used in your Shopping and PMax campaigns.\n- Google Merchant Center: account issues, product disapprovals, data sources and product feed health.\n- Product feed quality: content and GEO scores, weak titles, descriptions and attributes, and AI enrichment setup for your product data.\n- Shopify: sales, inventory, profitability and margins (POAS), plus catalog gaps between Shopify, Merchant Center and Google Ads.\n\nClarmix is read-only. ChatGPT can analyze your data but never changes campaigns, budgets, feeds or products; changes are made in Clarmix, Google Ads or Merchant Center.\n\nRequirements: a Clarmix account (app.clarmix.com) with Google Ads and/or Google Merchant Center connected. Shopify is optional and enables the sales, inventory and margin tools. Only the accounts the signed-in Clarmix user owns or has agency access to are visible.",
        "developerName": "Clarmix",
        "category": "Data & Analytics",
        "capabilities": [],
        "websiteURL": "https://clarmix.com/mcp",
        "supportURL": "https://clarmix.com/mcp",
        "privacyPolicyURL": "https://clarmix.com/privacy-policy",
        "termsOfServiceURL": "https://clarmix.com/terms",
        "defaultPrompt": [
          "Which products wasted the most Google Ads spend last month?",
          "How can I improve my product catalog?",
          "Are my Clarmix labels used in my Performance Max campaigns?"
        ],
        "brandColor": "#5B7CFA",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "commerce": false,
        "demo_recording_url": "https://youtu.be/hcy7oXWMB1s",
        "test_cases": {
          "positive": [
            {
              "description": "List the Clarmix accounts available to the signed-in user.",
              "prompt": "List my Clarmix accounts.",
              "tools_triggered": "list_accounts",
              "expected_behavior": "Returns the account 'Test Google Ads' (Merchant Center 'Test GMC') with its currency and connected sources, and offers a deeper analysis."
            },
            {
              "description": "Find products that spend on Google Ads without converting.",
              "prompt": "Which products spent the most on Google Ads in the last 30 days without any conversion?",
              "tools_triggered": "list_accounts, ads_product_performance",
              "expected_behavior": "Returns a ranked list of products with cost, clicks and zero conversions for the stated period, in the account currency, and suggests where to act (Clarmix labels, Google Ads)."
            },
            {
              "description": "Check whether Clarmix product labels reach Merchant Center and are used in campaigns.",
              "prompt": "Are my Clarmix product labels actually used in my Performance Max and Shopping campaigns?",
              "tools_triggered": "list_accounts, check_label_delivery",
              "expected_behavior": "Walks through the label chain step by step (computed, published, connected to Merchant Center, applied, used in campaigns), says which step breaks if any and where to fix it."
            },
            {
              "description": "Diagnose Merchant Center product disapprovals.",
              "prompt": "Why are some of my products disapproved in Google Merchant Center, and what should I fix first?",
              "tools_triggered": "list_accounts, gmc_product_issues",
              "expected_behavior": "Returns product status counts per destination and country and the most frequent item issues with affected product counts and resolution hints, prioritized."
            },
            {
              "description": "Prioritize product content enrichment by ad spend.",
              "prompt": "Which of my products have the weakest titles and descriptions, and which should I enrich first based on their Google Ads spend?",
              "tools_triggered": "list_accounts, get_content_quality",
              "expected_behavior": "Returns content quality scores and an enrichment plan ranking weak attributes by ad spend on poor-content products, with the Clarmix action for each."
            }
          ],
          "negative": [
            {
              "description": "General question unrelated to advertising or e-commerce data.",
              "prompt": "What is the weather in Paris tomorrow?"
            },
            {
              "description": "Creative writing request that does not need the user's advertising data.",
              "prompt": "Write a short poem about autumn."
            },
            {
              "description": "Generic advertising copy request for another platform, not about the user's Google Ads or Merchant Center data.",
              "prompt": "Write three Facebook ad headlines for a summer sale on sandals."
            }
          ]
        }
      },
      "onboardingSkill": "./skills/getting-started/SKILL.md",
      "apps": "./.app.json"
    }
  }
}