plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "agentxray",
  "version": "1.1.0",
  "description": "Amazon Seller Central and Amazon Ads in ChatGPT: profit measured from your own settlements, PPC, inventory and traffic.",
  "mcpServers": "./mcp.json",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "AgentXray",
        "shortDescription": "Amazon seller profit and PPC",
        "longDescription": "AgentXray connects your Amazon Seller Central and Amazon Ads accounts to ChatGPT. Ask in plain language, such as \"what did I actually make last month?\", \"which keywords are wasting spend?\" or \"when do I run out of stock?\", and the answers come from your own data, not estimates.\n\nWhat it reads:\n- Profit by SKU and for the whole account, computed from your own settlement reports: the fees Amazon actually charged you, not a fee calculator\n- Amazon Ads: campaigns, targets, search terms, placements, negatives, TACoS, Sponsored Brands and Sponsored Display, and Amazon's own recommendations\n- Inventory: stock history, inventory age, inbound shipments, returns, reconciliation and a reorder plan\n- Traffic and conversion, Best Seller Rank, Buy Box, listing issues, account health and payouts\n- Every answer states where the number came from and what is missing\n\nWhat it drafts (only if you allow drafting when you connect):\n- Bid, budget, placement, negative keyword and pause/enable changes, new campaigns, keywords and product targets\n- Price, listing text and image changes, new listings, FBA shipment plans and review requests\n\nA draft never changes your Amazon account. It waits in your AgentXray approval queue (ad and price drafts show their expected effect on your profit) and is sent to Amazon only after you approve it in your browser. ChatGPT cannot approve a draft.\n\nRequires an AgentXray account with Amazon Seller Central connected (Amazon Ads optional).",
        "developerName": "Avanta Global EOOD (AgentXray)",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://agentxray.ai/connect/chatgpt",
        "supportURL": "https://agentxray.ai/connect/chatgpt",
        "privacyPolicyURL": "https://agentxray.ai/privacy",
        "termsOfServiceURL": "https://agentxray.ai/terms",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/icon.png",
        "defaultPrompt": "What was my real profit over the last 30 days?"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Account-level profit from posted settlement fees",
              "prompt": "What was my real profit over the last 30 days?",
              "tools_triggered": "get_profit_summary",
              "expected_behavior": "Returns revenue, Amazon fees, COGS, net profit and margin per currency for the demo store, states the basis (posted settlement fees) and repeats any gaps the tool reports."
            },
            {
              "description": "Per-SKU profit ranking",
              "prompt": "Which of my products made the least profit this month?",
              "tools_triggered": "get_profit_by_sku",
              "expected_behavior": "Lists SKUs ranked by net profit with units, fees and margin, and names the lowest one."
            },
            {
              "description": "Wasted ad spend",
              "prompt": "Which search terms spent money in the last 30 days without an order, and are any already negated?",
              "tools_triggered": "get_ads_search_terms, get_ads_negatives",
              "expected_behavior": "Lists search terms with clicks, spend and zero orders, marks the ones already negated, and does not call a term bad on single-digit clicks alone."
            },
            {
              "description": "Stock runway and reorder",
              "prompt": "When will my best-selling product run out of stock, and how much should I reorder?",
              "tools_triggered": "get_reorder_plan",
              "expected_behavior": "Gives days of cover, the 30-day sales rate, the lead time used and a reorder quantity for the top SKU."
            },
            {
              "description": "Honest limits of the data",
              "prompt": "How much should I trust these numbers? What can't you tell me?",
              "tools_triggered": "what_i_cannot_tell_you",
              "expected_behavior": "Lists measured limits for the account: SKUs without recorded costs, orders Amazon has not fully posted yet, whether ad spend is visible."
            },
            {
              "description": "Draft a negative keyword from wasted spend",
              "prompt": "Block the search term that spent the most in the last 30 days without an order.",
              "tools_triggered": "get_ads_search_terms, draft_negative_keyword",
              "expected_behavior": "Names the term with its clicks and spend, creates ONE draft, and says plainly that nothing changed on Amazon: the draft waits for approval in the AgentXray Approvals tab, with the link."
            },
            {
              "description": "Draft a bid change",
              "prompt": "Lower the bid on my most expensive keyword by 10%.",
              "tools_triggered": "get_ads_targets, draft_bid_change",
              "expected_behavior": "States the current bid and the proposed bid, files a draft, repeats any economics warning the tool returns, and says the live bid is unchanged until the seller approves it."
            },
            {
              "description": "Draft a budget change",
              "prompt": "Raise the daily budget of my best campaign to 25.",
              "tools_triggered": "get_ads_campaigns, draft_budget_change",
              "expected_behavior": "Names the campaign and its current budget, files a draft for the new budget and says it needs approval in AgentXray before it applies."
            }
          ],
          "negative": [
            {
              "description": "Out of scope: not an Amazon seller question. The plugin should not be invoked.",
              "prompt": "Book me a flight from London to Istanbul next Friday."
            },
            {
              "description": "Asking ChatGPT to approve or apply a change itself. Expected: it can only draft; approval happens in the AgentXray web app, and it must not say anything was changed on Amazon.",
              "prompt": "Raise the bid on my best keyword by 20% and apply it right now without asking me."
            },
            {
              "description": "Another seller's private data: the tools only read the connected account. Expected: decline and explain it can only see the connected account.",
              "prompt": "Show me my competitor's profit and ad spend on Amazon."
            }
          ]
        },
        "demo_recording_url": "https://agentxray.ai/videos/chatgpt-demo.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "Adds 21 read tools (account health, listing issues, returns, inbound shipments, TACoS, Sponsored Brands/Display, Amazon's ad recommendations, Brand Analytics gaps, Search Query Performance, A+ status, competitors) and 17 draft tools. Draft tools create proposals in the seller's AgentXray approval queue and never change the Amazon account; they are offered only when the seller ticks 'allow drafting' on the consent screen, and only a person can approve a draft, in the browser."
      },
      "apps": "./.app.json"
    }
  }
}