plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "reporting-ninja",
  "version": "1.0.0",
  "description": "Analyze the marketing data of the client accounts connected in Reporting Ninja and turn the answer into a branded, scheduled client report.",
  "author": {
    "name": "Brainless Lab SL",
    "email": "support@reportingninja.com",
    "url": "https://www.reportingninja.com"
  },
  "homepage": "https://www.reportingninja.com/mcp/chatgpt",
  "keywords": [
    "marketing",
    "analytics",
    "reporting",
    "google ads",
    "meta ads",
    "ga4",
    "seo",
    "agencies"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Reporting Ninja",
        "shortDescription": "Marketing analytics & reports",
        "longDescription": "Reporting Ninja connects ChatGPT to the marketing data of the client accounts you have connected in Reporting Ninja: Google Ads, Meta Ads, GA4, Google Search Console, LinkedIn, TikTok, Microsoft Ads, Shopify, HubSpot, Mailchimp and more than 20 platforms in total.\n\nAsk in plain words and ChatGPT finds the right account, picks the fields and pulls the numbers from each platform's API: which campaigns spent without converting, how a client is pacing against budget, how this month compares with the last one, or a blended view across channels.\n\nWith write access switched on by an account owner or admin, ChatGPT can also build the deliverable inside Reporting Ninja: a report from a template or from scratch, in the client's brand, language and currency, delivered by email on a schedule or published in the client portal. What it creates is an ordinary Reporting Ninja report that you can open, edit and send.\n\nBuilt for marketing agencies, freelancers and in-house marketing teams that report on paid media, analytics, SEO, social, email and ecommerce performance.\n\nGood to know:\n- You need a Reporting Ninja account with at least one data source connected, and you sign in as the account owner or an admin.\n- It is read-only until an account owner or admin enables write access in Reporting Ninja.\n- It only sees the accounts connected to your Reporting Ninja account, and it never changes anything in your advertising or analytics platforms.\n- Deleting something or emailing a client always asks for your confirmation first.",
        "developerName": "Brainless Lab SL",
        "category": "Data & Analytics",
        "capabilities": [
          "Query marketing data from connected ad, analytics, SEO, social, email and ecommerce accounts",
          "Compare periods and blend several accounts or channels in one table",
          "Build branded client reports from templates or from scratch",
          "Schedule report delivery by email",
          "Share reports with clients in the client portal"
        ],
        "websiteURL": "https://www.reportingninja.com/mcp/chatgpt",
        "supportURL": "https://www.reportingninja.com/contact",
        "privacyPolicyURL": "https://www.reportingninja.com/privacy",
        "termsOfServiceURL": "https://www.reportingninja.com/terms",
        "defaultPrompt": [
          "Which of my Google Ads campaigns spent the most last month without converting?",
          "Compare my GA4 sessions and conversions this month with last month, by channel.",
          "Build a monthly SEO report for my client from a template."
        ],
        "brandColor": "#2E90FA",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Read Google Analytics 4 data: the most viewed pages of the reviewer account's GA4 property (reportingninja.com) in the previous calendar month.",
              "prompt": "Which pages on reportingninja.com got the most views last month?",
              "tools_triggered": "list_connections, list_fields, query_data",
              "expected_behavior": "ChatGPT finds the account's GA4 connection, queries page views by page path for the previous calendar month and answers with a ranked list of the top pages and their views. Every figure comes from the tool result. Nothing is created or changed."
            },
            {
              "description": "Compare two periods in Google Search Console for the reviewer account's property (reportingninja.com).",
              "prompt": "Compare Google Search Console clicks and impressions for reportingninja.com in September 2026 versus August 2026.",
              "tools_triggered": "list_connections, query_data",
              "expected_behavior": "ChatGPT returns clicks and impressions for both months with the absolute and percentage change. September 2026 should be in the order of 3,900 clicks and 1.2 million impressions, the same figures the account's 'reportingninja.com - Monthly SEO' report shows. Nothing is created or changed."
            },
            {
              "description": "Blend two sources on a shared dimension: GA4 sessions and Search Console clicks by date.",
              "prompt": "Show daily GA4 sessions next to Google Search Console clicks for reportingninja.com over the last 14 days.",
              "tools_triggered": "list_connections, list_fields, query_blend",
              "expected_behavior": "ChatGPT answers with one table by date that shows GA4 sessions and Search Console clicks side by side for the last 14 days, optionally with a short comment on the trend. Nothing is created or changed."
            },
            {
              "description": "Read what the account already has: its reports and the delivery schedule of the SEO report.",
              "prompt": "List my reports and tell me when the Monthly SEO report is emailed and to whom.",
              "tools_triggered": "list_reports, list_schedules",
              "expected_behavior": "ChatGPT lists the account's reports, including 'reportingninja.com - Monthly SEO', 'reportingninja.com - GA4 overview', 'reportingninja.com - Search Console' and 'reportingninja.com - GA4 by widget', and says the Monthly SEO report is sent monthly on day 2 at 08:00 (account time zone) as a PDF to mcp@reportingninja.com. Nothing is sent or changed."
            },
            {
              "description": "Write action (write access is enabled on the reviewer account): create a report from the system template catalog, bound to the account's GA4 connection.",
              "prompt": "Create a Google Analytics 4 overview report for reportingninja.com from the template catalog.",
              "tools_triggered": "list_template_catalog, list_connections, create_report_from_template",
              "expected_behavior": "ChatGPT creates one new report (it may first ask for permission, depending on the plugin permission setting) in the account from the 'ga4-overview' catalog template, bound to the GA4 connection, and replies with the report's name and the app_url link that opens it in Reporting Ninja. Nothing is emailed or published to the portal. The report can be removed afterwards with delete_report."
            }
          ],
          "negative": [
            {
              "description": "Changing an advertising platform is out of scope. Reporting Ninja only reads data from the platforms and has no tool that pauses, edits or creates campaigns; the reviewer account also has no Google Ads connection. Expected: no write tool is called, and ChatGPT explains that it cannot pause campaigns through Reporting Ninja and, at most, offers to report on campaign performance.",
              "prompt": "Pause the Google Ads campaigns that spent money without converting last month."
            },
            {
              "description": "Billing, plans and payments are out of scope. Reporting Ninja has no tool for subscriptions, plans or payments. Expected: no write tool is called and nothing is charged; ChatGPT says it cannot change the subscription or charge a card through Reporting Ninja and points the user to the billing settings of the app.",
              "prompt": "Upgrade my Reporting Ninja subscription to a bigger plan and charge my card."
            },
            {
              "description": "Data outside the signed-in account is out of scope. The plugin only reaches the accounts connected to the signed-in Reporting Ninja account. Expected: ChatGPT may call list_connections to check, then explains that there is no such connection and that it cannot access another company's advertising accounts; it does not invent figures.",
              "prompt": "Show me the Google Ads spend and conversions of nike.com, my competitor, for last month."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Reporting Ninja does not sell products, process payments or show plans inside ChatGPT. Users sign in to an existing Reporting Ninja account.",
        "demo_recording_url": "https://youtu.be/CCfRkvwpgng"
      },
      "publication": {
        "countries": [],
        "release_notes": "First release in the directory: 83 tools on the Reporting Ninja MCP server (version 1.6.0) to query connected marketing data and, with write access enabled, build, schedule and share client reports."
      },
      "apps": "./.app.json"
    }
  }
}