plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hypd-microsoft-ads",
  "version": "1.0.2",
  "description": "Read connected Microsoft Advertising account structure, campaign and keyword performance, search terms and conversion tracking configuration.",
  "author": {
    "name": "HYPD AI",
    "email": "support@hypd.ai",
    "url": "https://www.hypd.ai"
  },
  "homepage": "https://www.hypd.ai",
  "keywords": [
    "microsoft-advertising",
    "bing-ads",
    "reporting",
    "marketing",
    "microsoft ads",
    "microsoft ads report",
    "microsoft ads reporting",
    "microsoft ads campaigns",
    "microsoft ads keywords",
    "microsoft ads audit",
    "microsoft ads optimization",
    "microsoft advertising",
    "microsoft advertising reporting",
    "microsoft advertising campaigns",
    "bing ads",
    "bing ads report",
    "bing ads reporting",
    "bing ads campaigns",
    "bing ads keywords",
    "bing ads audit",
    "bing ads optimization",
    "bing advertising",
    "bing search ads",
    "search ads",
    "uet tag"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HYPD.AI Search Ads",
        "shortDescription": "Analyze Microsoft Advertising",
        "longDescription": "HYPD.AI Search Ads works with authorized Microsoft Advertising accounts (formerly Bing Ads) to help advertisers, agencies, ecommerce teams, and paid-search specialists analyze performance, audit account structure, diagnose inefficient spend, and prioritize practical campaign improvements.\n\nUse it to:\n\n\u2022 Discover authorized customers and accounts, confirm the correct account, and understand its hierarchy.\n\n\u2022 Review campaign status, type, budget, delivery, and performance to see where spend and results are concentrated.\n\n\u2022 Analyze available impressions, clicks, spend, CTR, CPC, conversions, conversion rate, CPA, revenue, and ROAS for a date range.\n\n\u2022 Compare campaigns, ad groups, ads, and keywords to find strong performers, waste, anomalies, and budget opportunities.\n\n\u2022 Flag areas spending without conversions, exceeding a target CPA, falling below a target ROAS, or declining over time.\n\n\u2022 Review keywords for high costs, low CTR, strong conversions, weak match types, and relevance issues.\n\n\u2022 Analyze search terms for irrelevant or low-intent traffic and prepare negative-keyword suggestions for human review.\n\n\u2022 Compare ad results, identify weak creative, and prioritize headlines, descriptions, offers, or calls to action for testing.\n\n\u2022 Compare reporting periods and investigate whether changes come from costs, engagement, demand, targeting, or post-click results.\n\n\u2022 Audit account structure and budget pacing for inactive entities, fragmented traffic, naming issues, constraints, or underspending.\n\nHYPD.AI is read-only: it analyzes connected Microsoft Advertising data and recommends improvements, but cannot modify campaigns, bids, budgets, ads, keywords, targeting, tracking, users, or account settings.\n\nHYPD.AI is an independent product and is not affiliated with or endorsed by Microsoft. Microsoft, Bing and Microsoft Advertising are trademarks of the Microsoft group of companies.",
        "developerName": "HYPD AI",
        "category": "Data & Analytics",
        "capabilities": [
          "Flag campaigns and keywords that spend without converting",
          "Mine search terms for negative keyword suggestions",
          "Find keywords with high cost, low CTR or weak match types",
          "Compare campaign performance between periods",
          "Audit account structure and budget pacing",
          "Review conversion goals and UET tag status"
        ],
        "defaultPrompt": [
          "Summarize my Microsoft Advertising campaign performance for the last 30 complete days.",
          "Which keywords and search terms have spend but no reported conversions?",
          "Review my Microsoft Advertising conversion goals and UET tracking statuses."
        ],
        "composerIcon": "./assets/composer-icon.png",
        "logo": "./assets/directory-icon.png",
        "websiteURL": "https://www.hypd.ai",
        "supportURL": "https://www.hypd.ai/contact",
        "privacyPolicyURL": "https://www.hypd.ai/privacy",
        "termsOfServiceURL": "https://www.hypd.ai/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover an account and inspect campaign structure and budgets.",
              "prompt": "List my Microsoft Advertising accounts. Ask me to choose if needed, then show its campaigns and shared budgets.",
              "tools_triggered": "init, msads_list_accounts, msads_list_campaigns, msads_list_budgets",
              "expected_behavior": "Use an account_id copied verbatim as a digit string from discovery. Show actual campaign types/statuses and budget settings plus shared budgets; distinguish them. Surface plan_notice and partial_errors, and ask for selection if ambiguous."
            },
            {
              "description": "Read campaign totals and daily trends.",
              "prompt": "Show campaign performance for the last 30 complete days, then its daily trend for the same date window.",
              "tools_triggered": "init, msads_list_accounts, msads_get_campaign_performance",
              "expected_behavior": "Use a discovered account and explicit inclusive YYYY-MM-DD dates. Run Summary and Daily reports sequentially, using returned columns and actual metrics. Parse numeric CSV strings without rounding IDs, avoid unsupported ad/ad-group reports, and disclose truncated results. Do not fabricate absent conversions or revenue."
            },
            {
              "description": "Inspect a Search campaign and diagnose keyword/search-term spend.",
              "prompt": "For one Search campaign, show its ad groups, ads and keywords. Compare account keyword performance and actual search terms for the last 30 complete days with the shared negative keyword lists, then suggest items for human review.",
              "tools_triggered": "init, msads_list_accounts, msads_list_campaigns, msads_list_ad_groups, msads_list_ads, msads_list_keywords, msads_get_keyword_performance, msads_get_search_terms, msads_list_negative_keyword_lists",
              "expected_behavior": "Discover exact campaign/ad-group IDs before structure reads. Reports are account-level: filter or match returned rows to the chosen campaign only when fields allow it. Identify actual searched queries separately from configured keywords; recommend negatives without applying them. State truncation and avoid treating missing conversions as zero."
            },
            {
              "description": "Inspect tracking and audience configuration.",
              "prompt": "For my selected account, show conversion goals, UET tracking statuses and audience definitions. Explain any visible limitations without changing tracking.",
              "tools_triggered": "init, msads_list_accounts, msads_list_conversion_goals, msads_list_uet_tags, msads_list_audiences",
              "expected_behavior": "Read actual configuration and available statuses sequentially; report partial_errors and missing data. Explain observations cautiously rather than guaranteeing end-to-end tracking health. Do not create goals, edit tags or modify audiences."
            },
            {
              "description": "Read Performance Max assets and asset-group performance.",
              "prompt": "Find a Performance Max campaign, show its asset groups and available assets, and report asset-group performance for the last 30 complete days.",
              "tools_triggered": "init, msads_list_accounts, msads_list_campaigns, msads_list_asset_groups, msads_get_asset_group_performance",
              "expected_behavior": "Use a discovered Performance Max campaign_id for the entity read. The performance tool accepts account_id and dates rather than campaign_id: match the returned campaign fields where available. Present actual report metrics and creative/status fields, disclose partial_errors/truncation, and explain absent PMax data without inventing a campaign."
            }
          ],
          "negative": [
            {
              "description": "Do not make campaign or budget changes.",
              "prompt": "Pause underperforming campaigns and raise the winning campaigns\u2019 budgets by 20 percent.",
              "expected_behavior": "Do not invoke this plugin to execute edits. Explain read-only access; it may support a separately requested analysis, but cannot pause campaigns or change budgets."
            },
            {
              "description": "Do not publish creatives or change tracking.",
              "prompt": "Publish a new search ad and create a new conversion goal with a UET tag.",
              "expected_behavior": "Do not invoke read tools as if they implement these writes. Explain that ad publishing and tracking changes are not supported."
            },
            {
              "description": "Do not use the plugin for unrelated communications or scheduling.",
              "prompt": "Email my colleague and add a meeting to my calendar tomorrow.",
              "expected_behavior": "Do not invoke this plugin for email or calendar operations; these capabilities are outside its surface."
            }
          ]
        },
        "demo_recording_url": "https://screen.studio/share/4FWxXgLb",
        "commerce": false,
        "commerce_description": "Provides research or read-only advertising analysis; does not sell products, accept payments or complete purchases."
      },
      "publication": {
        "release_notes": "Updates the plugin keywords. No other changes."
      },
      "apps": "./.app.json"
    }
  }
}