plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "commerce-engine",
  "version": "0.1.0",
  "description": "Manage your Commerce Engine catalog, media, offers and marketplace, and read orders through your own account.",
  "author": {
    "name": "Commerce Engine",
    "email": "support@commercengine.io",
    "url": "https://www.commercengine.io"
  },
  "homepage": "https://www.commercengine.io",
  "repository": "https://github.com/commercengine/mcp",
  "license": "MIT",
  "keywords": ["commerce", "ecommerce", "catalog", "marketplace", "mcp"],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Commerce Engine",
        "shortDescription": "Manage your commerce store",
        "longDescription": "Connect your AI app to Commerce Engine to work on your catalog, media, coupons, promotions, sales channels and marketplace, and search and read orders. Sign in with your own Commerce Engine admin account; access follows your existing role and stores. New connections start in Sandbox. Only you can approve a switch to Live in the admin app. Sales channels and marketplace sellers are organisation-wide and affect Live even in Sandbox. The connector cannot cancel, refund or edit orders, edit customers, change payments or user roles, or generate images. Review changes before approving them in your AI app.",
        "developerName": "Commerce Engine",
        "category": "Business & Operations",
        "capabilities": ["Read", "Write"],
        "websiteURL": "https://www.commercengine.io",
        "supportURL": "https://www.commercengine.io/contact-us",
        "privacyPolicyURL": "https://www.commercengine.io/privacy-policy",
        "termsOfServiceURL": "https://www.commercengine.io/terms-of-use",
        "defaultPrompt": [
          "Which environment are you in, and which stores can you reach?",
          "Show me the categories in my store.",
          "Create a coupon WELCOME10 for 10% off."
        ],
        "composerIcon": "./assets/icon-512.png",
        "logo": "./assets/icon-512.png"
      },
      "review": {
        "commerce": false,
        "commerce_description": "No purchases or payments happen in ChatGPT. The plugin lets a merchant manage their own Commerce Engine store, such as its catalog, coupons and promotions, and read its orders.",
        "prompts": [
          "Which environment are you in, and which stores can you reach?",
          "Find the AUREON Nova ANC Headphones and show me their description.",
          "Show me the categories in my store.",
          "How much stock does the Wireless Hi-Fi Speaker have?",
          "Create a coupon REVIEW10 for 10% off."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Connection context. Setup: the reviewer account, which reaches the Little Things demo store in Sandbox. Start a fresh chat. Pass when the environment and accessible stores agree with the tool result; no switch or write occurs.",
              "prompt": "Which environment are you in, and which stores can you reach?",
              "tools_triggered": "ce_state",
              "expected_behavior": "Call ce_state with no arguments. Report the returned environment and accessible stores without inventing access. If sign-in is required, request authentication rather than claiming success."
            },
            {
              "description": "Product lookup. Setup: the Little Things demo store in Sandbox, whose catalog includes the AUREON Nova ANC Headphones. Pass when the answer matches the description get_product returns.",
              "prompt": "Find the AUREON Nova ANC Headphones and show me their description.",
              "tools_triggered": "ce_state, search, get_product",
              "expected_behavior": "Use the store_id from ce_state. Search with type=product and search=AUREON Nova ANC Headphones, then call get_product with the returned id and the same store_id. Report only returned product information, and clarify if several products match."
            },
            {
              "description": "Category listing. Setup: the Little Things demo store in Sandbox, whose categories are Camera, DJ Equipment and Speakers. Pass when the listed categories match the search result and nothing is changed.",
              "prompt": "Show me the categories in my store.",
              "tools_triggered": "ce_state, search",
              "expected_behavior": "Use the store_id from ce_state and call search with type=category and no search term. List the returned categories by name without inventing any."
            },
            {
              "description": "Inventory lookup. Setup: the Little Things demo store in Sandbox, whose catalog includes the Wireless Hi-Fi Speaker. Pass when the reported stock matches the inventory get_product_inventory returns, per variant and warehouse, and nothing is changed.",
              "prompt": "How much stock does the Wireless Hi-Fi Speaker have?",
              "tools_triggered": "ce_state, search, get_product_inventory",
              "expected_behavior": "Use the store_id from ce_state. Search with type=product and search=Wireless Hi-Fi Speaker, then call get_product_inventory with the returned id. Report stock per variant and warehouse as returned, and do not update inventory."
            },
            {
              "description": "Coupon creation. Setup: the Little Things demo store in Sandbox, with no coupon using the code REVIEW10; delete it before a rerun. Coupons don't appear on the demo storefront. Pass when the coupon is created with a 10% discount, or when the connector returns the form's field messages and the agent fixes them or asks for the missing values.",
              "prompt": "Create a coupon REVIEW10 for 10% off.",
              "tools_triggered": "ce_state, create_coupon",
              "expected_behavior": "Confirm Sandbox via ce_state. Call create_coupon with name REVIEW10, coupon_code [REVIEW10], coupon_type discount and a 10% percentage discount, using the store_id from ce_state. Follow the host's approval prompt. Report the created coupon; if the form returns field messages, correct them or ask the merchant, and never claim a coupon was saved when it wasn't."
            }
          ],
          "negative": [
            {
              "description": "Unsupported order mutation. Setup: fresh chat with no pending supported task. Explain that the connector cannot refund or cancel orders and direct the merchant to the admin app. No order lookup or mutation tool should run; an initial ce_state context check is allowed. Never claim a refund succeeded.",
              "prompt": "Refund and cancel my latest order."
            },
            {
              "description": "Unsupported customer editing. Setup: fresh chat with no pending supported task. Explain that customer editing is unavailable through this connector. Do not search for a customer or invoke any mutation tool; an initial ce_state context check is allowed. Do not claim the email changed.",
              "prompt": "Change customer Jane Doe's email address to jane@example.com."
            },
            {
              "description": "Marketplace credentials stay out of the chat. Setup: fresh chat with no pending task. Explain that marketplace channels are set up in the Commerce Engine admin app, so the marketplace's API key never passes through the chat. No channel or other mutation tool should run; an initial ce_state context check is allowed. Do not ask for, accept or repeat an API key.",
              "prompt": "Connect my store to a new marketplace using my API key."
            }
          ]
        }
      },
      "publication": {
        "countries": ["IN"],
        "release_notes": "Initial connector package for the hosted Commerce Engine MCP server, with OAuth discovery and installation instructions for supported agent clients."
      }
    }
  }
}