plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "axitrace",
  "version": "1.0.0",
  "description": "Ask about an online store's real revenue, ROAS, campaigns, traffic sources and order journeys, measured by AxiTrace server-side tracking.",
  "author": {
    "name": "AxiTrace",
    "email": "info@axitrace.com",
    "url": "https://axitrace.com"
  },
  "homepage": "https://axitrace.com/mcp/",
  "keywords": [
    "ecommerce",
    "analytics",
    "attribution",
    "roas",
    "shopify",
    "woocommerce",
    "server-side tracking"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "AxiTrace",
        "shortDescription": "E-commerce marketing analytics",
        "longDescription": "AxiTrace is a marketing analytics platform for e-commerce stores on Shopify, WooCommerce, Shopware 6 and Magento 2. It records every order and visit with first-party, server-side tracking and ties each order to the click that brought it. This plugin lets ChatGPT answer questions with that data instead of guesses.\n\nWhat you can ask:\n- Revenue, orders, ad spend, ROAS and conversion rate for any date range, compared with the previous period or a year earlier\n- Which traffic sources and channels earn money: Google Ads, Meta, TikTok, Microsoft Ads, organic search, email, AI assistants and more\n- Campaign performance with spend from the ad platform next to revenue from real orders\n- First click, last click and data-driven attribution side by side\n- The full journey of one order: every visit and ad click before the purchase\n- Common conversion paths across channels\n- Product performance, store health and organic search\n- Leads and which leads turned into orders\n- Ad fraud signals and the health of the Conversions API connections\n\nMost tools are read-only. A small set of write tools manages leads (notes, statuses, linking an order), surveys and custom events, and ChatGPT asks you before using them. The plugin never edits ad campaigns.\n\nYou sign in to AxiTrace with OAuth and choose the workspaces and permissions the connection gets. Buyer contact details are only returned when you grant that permission explicitly.",
        "developerName": "AxiTrace",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://axitrace.com",
        "supportURL": "https://axitrace.com/contact/",
        "privacyPolicyURL": "https://axitrace.com/privacy/",
        "termsOfServiceURL": "https://axitrace.com/terms/",
        "defaultPrompt": [
          "Which traffic sources brought the most revenue last month?",
          "Which ad campaigns had a ROAS below 1 in the last 30 days?",
          "Show the journey of my most recent order."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Headline figures for a period with a comparison",
              "prompt": "Using AxiTrace, show revenue, orders, ad spend and ROAS for the last 30 days compared with the previous 30 days.",
              "tools_triggered": "list_workspaces, get_overview",
              "expected_behavior": "Lists the workspace, then reports revenue, orders, ad spend and ROAS for the last 30 days with the change against the previous period, in the workspace currency."
            },
            {
              "description": "Revenue split by traffic source",
              "prompt": "Using AxiTrace, which traffic sources brought the most revenue last month?",
              "tools_triggered": "list_workspaces, get_traffic_sources",
              "expected_behavior": "Returns the top traffic sources of last month ranked by revenue, with orders, sessions, ad spend and ROAS where known, and each source's share of revenue."
            },
            {
              "description": "Campaigns that lose money",
              "prompt": "Using AxiTrace, which Meta and Google Ads campaigns had a ROAS below 1 in the last 30 days?",
              "tools_triggered": "list_workspaces, list_campaigns",
              "expected_behavior": "Lists the Meta and Google Ads campaigns of the last 30 days whose ROAS on AxiTrace-attributed orders is below 1, with spend, orders and revenue for each."
            },
            {
              "description": "Journey of one order",
              "prompt": "Using AxiTrace, show how the customer behind my most recent order found the store.",
              "tools_triggered": "list_workspaces, list_transactions, get_order_journey",
              "expected_behavior": "Finds the most recent order, then lists its visits and ad clicks oldest first with channel, campaign and landing page, and says which touchpoint each attribution model credited. No buyer contact details are shown."
            },
            {
              "description": "Conversion paths across channels",
              "prompt": "Using AxiTrace, what are the most common channel paths that lead to orders in the last 90 days?",
              "tools_triggered": "list_workspaces, get_conversion_paths",
              "expected_behavior": "Returns the most common channel sequences before an order in the last 90 days, with orders, share of orders, revenue and average days to convert per path."
            }
          ],
          "negative": [
            {
              "description": "Editing an ad campaign is out of scope",
              "prompt": "Using AxiTrace, pause my worst Facebook campaign."
            },
            {
              "description": "Unrelated question that needs no store data",
              "prompt": "What is the capital of Australia?"
            },
            {
              "description": "Sending messages to customers is not supported",
              "prompt": "Using AxiTrace, email every customer who abandoned a cart yesterday."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "First public release of the AxiTrace plugin: store analytics, campaigns, attribution, order journeys, leads and surveys over the AxiTrace MCP server."
      },
      "apps": "./.app.json"
    }
  }
}