plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "meerkads",
  "version": "1.0.0",
  "description": "Read your Google Ads, Meta, TikTok, Shopify, GA4 and Search Console performance from Meerkads.",
  "author": {
    "name": "Meerkads",
    "url": "https://meerkads.com"
  },
  "homepage": "https://meerkads.com",
  "keywords": [
    "advertising",
    "marketing",
    "analytics",
    "google ads",
    "meta ads",
    "shopify"
  ],
  "mcpServers": "./mcp.json",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Meerkads",
        "shortDescription": "Ad and store performance",
        "longDescription": "Ask about the ad accounts and store connected to your Meerkads workspace: Google Ads, Meta, TikTok, Shopify, GA4 and Search Console. Compare periods, find top and wasted spend, spot anomalies and creative fatigue, and get budget scenarios. Meerkads is read-only: it never changes campaigns, budgets or settings, and it only reads the workspace you authorize.",
        "developerName": "Meerkads",
        "category": "Productivity",
        "capabilities": [
          "Cross-channel performance summaries",
          "Period-over-period comparisons",
          "Top and worst campaigns, ads and keywords",
          "Anomaly and creative-fatigue detection",
          "Budget what-if scenarios"
        ],
        "websiteURL": "https://meerkads.com",
        "supportURL": "https://meerkads.com/support/contact",
        "privacyPolicyURL": "https://meerkads.com/company/privacy-policy",
        "termsOfServiceURL": "https://meerkads.com/company/terms-conditions",
        "defaultPrompt": [
          "How did my ads perform across all channels in the last 30 days?",
          "Compare this month's Meta results with last month.",
          "Which Google Ads campaigns are wasting the most spend?"
        ],
        "composerIcon": "./assets/icon.svg",
        "composerIconDark": "./assets/icon-dark.svg",
        "logo": "./assets/icon.svg",
        "logoDark": "./assets/icon-dark.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Cross-channel summary for the connected workspace",
              "prompt": "How did my ads perform across all channels in the last 30 days?",
              "tools_triggered": "cross_platform_summary",
              "expected_behavior": "Returns spend, clicks, conversions and revenue per connected channel with blended totals for the last 30 days. Missing values are shown as unavailable, never as zero."
            },
            {
              "description": "Period-over-period comparison",
              "prompt": "Compare this month's Meta Ads results with last month.",
              "tools_triggered": "compare_periods",
              "expected_behavior": "Shows current vs previous period values and the change for Meta spend, conversions, CPA and ROAS."
            },
            {
              "description": "Top entities by a metric",
              "prompt": "What are my top 5 Google Ads campaigns by conversions this month?",
              "tools_triggered": "get_top_entities",
              "expected_behavior": "Lists five Google Ads campaigns ranked by conversions with spend and CPA for each."
            },
            {
              "description": "Wasted spend",
              "prompt": "Where am I wasting ad spend in the last 30 days?",
              "tools_triggered": "waste_ledger",
              "expected_behavior": "Lists campaigns, ads or search terms that spent money without conversions, with the amount spent on each."
            },
            {
              "description": "Anomaly detection",
              "prompt": "Were there any unusual spikes or drops in my ad performance last week?",
              "tools_triggered": "find_anomalies",
              "expected_behavior": "Names the days and metrics that moved unusually, with the size of the change, or says that nothing unusual was found."
            }
          ],
          "negative": [
            {
              "description": "Write action (read-only connector)",
              "prompt": "Pause my worst performing Meta campaign."
            },
            {
              "description": "Budget change (read-only connector)",
              "prompt": "Increase my Google Ads daily budget to $500."
            },
            {
              "description": "Access outside the authorized workspace",
              "prompt": "Show me the ad performance of a competitor's account."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Meerkads does not sell products or process payments in ChatGPT."
      },
      "publication": {
        "release_notes": "Initial release: read-only performance insights across Google Ads, Meta, TikTok, Shopify, GA4 and Search Console.",
        "translations": {
          "tr-TR": {
            "subtitle": "Reklam ve ma\u011faza performans\u0131",
            "description": "Meerkads \u00e7al\u0131\u015fma alan\u0131n\u0131za ba\u011fl\u0131 Google Ads, Meta, TikTok, Shopify, GA4 ve Search Console verilerinizi sorun: d\u00f6nemleri kar\u015f\u0131la\u015ft\u0131r\u0131n, en iyi ve bo\u015fa giden harcamay\u0131 bulun, anomalileri ve kreatif yorgunlu\u011funu g\u00f6r\u00fcn, b\u00fct\u00e7e senaryolar\u0131 al\u0131n. Meerkads yaln\u0131zca okur; kampanya, b\u00fct\u00e7e veya ayar de\u011fi\u015ftirmez ve sadece yetki verdi\u011finiz \u00e7al\u0131\u015fma alan\u0131n\u0131 okur."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}