plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "laurence",
  "version": "1.0.0",
  "description": "Read-only access to your company's Laurence data: Amazon sales, advertising, search terms, products and what Laurence changed.",
  "author": {
    "name": "Laurence",
    "email": "support@laurence.com",
    "url": "https://www.laurence.com"
  },
  "homepage": "https://www.laurence.com",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Laurence",
        "shortDescription": "Your Amazon ads and sales",
        "longDescription": "Laurence runs Amazon advertising for e-commerce brands: models set the bids every hour and people review the work. This connector gives your AI assistant read-only access to your company's Laurence data, so you can ask about your Amazon business in your own words.\n\nWhat you can ask about:\nSales: total and daily revenue, units, net profit, product margins and customer acquisition cost.\nAdvertising: spend, ad sales and returns by campaign, product, placement and hour; branded and non-branded ads; campaigns, ad groups, keywords and negative keywords as they stand on Amazon.\nSearch: the search terms shoppers used, market search volume and share, search term popularity and keyword clusters.\nProducts: catalog details, Best Sellers Rank history, FBA inventory, and deals and coupons.\nWhat Laurence did: keywords added, bid and budget changes, the full history of one target, and the account's shared Slack channel with Laurence.\n\nWho it is for: brands with a Laurence account. You need a Laurence login with access to at least one company. On first use you sign in to Laurence and choose the one company the assistant may read.\n\nRead-only: every tool only reads. Nothing can change bids, budgets, campaigns or listings, and nothing is sent to Amazon.\n\nLimits: answers cover the stores of the company you chose, and are as current as Laurence's latest data.",
        "developerName": "Laurence",
        "category": "Data & Analytics",
        "capabilities": [],
        "websiteURL": "https://www.laurence.com",
        "supportURL": "https://www.laurence.com/docs/laurence-for-agents/mcp",
        "privacyPolicyURL": "https://www.laurence.com/privacy",
        "termsOfServiceURL": "https://www.laurence.com/eula",
        "defaultPrompt": [
          "How did my Amazon store do last week?",
          "Which search terms are costing the most right now?",
          "What did Laurence change in my ads this week?"
        ],
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "October sales and the share from ads",
              "prompt": "How much did we sell in October 2026, and how much of it came from ads?",
              "tools_triggered": "get_total_sales",
              "expected_behavior": "Reports $128,907.85 revenue and 6,380 units for October 2026, of which $72,486.81 came from ads and $56,421.04 was organic."
            },
            {
              "description": "October ad spend and what it brought in",
              "prompt": "What did we spend on Amazon ads in October 2026, and what did that spend bring in?",
              "tools_triggered": "get_ad_spend",
              "expected_behavior": "Reports $29,369.50 ad spend, $72,486.81 ad sales and 3,265 orders (about a 2.5x return), mostly Sponsored Products."
            },
            {
              "description": "Most expensive search terms for a week",
              "prompt": "Which search terms cost the most from November 2 to November 8, 2026?",
              "tools_triggered": "get_search_term_data",
              "expected_behavior": "Top term is \"ultrasonic cleaner solution\" at $298.30 cost and $732.69 ad sales; the list continues with terms such as \"wall cleaner\"."
            },
            {
              "description": "What Laurence changed on the account",
              "prompt": "What did Laurence change on the account from November 2 to November 8, 2026?",
              "tools_triggered": "get_system_activity",
              "expected_behavior": "Reports 285,814 bid changes across 44,534 keywords and 8 proposed word bans for November 2 to 8, 2026."
            },
            {
              "description": "Weekly KPI scorecard against the prior week",
              "prompt": "Show me the KPI scorecard for the week of November 2, 2026 against the week before.",
              "tools_triggered": "get_kpi_scorecard",
              "expected_behavior": "Shows ad spend $6,578.80 (+1.5%), ad sales $16,305.37 (-1.7%), revenue $29,492.45, TACOS 22.3% and ROAS 2.48 against the week before."
            }
          ],
          "negative": [
            {
              "description": "Write request: tools are read-only",
              "prompt": "Raise all my bids by 20%.",
              "expected_behavior": "No bid is changed. Every tool is read-only, so the assistant explains it can read the account but cannot change bids."
            },
            {
              "description": "Unrelated question",
              "prompt": "What is the weather in Seattle today?",
              "expected_behavior": "No Laurence tool is called."
            },
            {
              "description": "Another company's data",
              "prompt": "Show me Nike's Amazon sales for October.",
              "expected_behavior": "Answers only for the company chosen at sign-in; no tool returns another company's data."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/G_5smtdR60A"
      },
      "apps": "./.app.json"
    }
  }
}