plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "secure-access-for-magento",
  "version": "1.0.0",
  "description": "Connect to Magento and Adobe Commerce through miniOrange for store data, inventory, orders, shipment lookups and analytics.",
  "author": {
    "name": "miniOrange"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Secure Access for Magento",
        "shortDescription": "Access and analyze store data",
        "longDescription": "Connect to your store running Magento or Adobe Commerce through miniOrange. Search products, check inventory levels, review orders, view shipment tracking, and analyze sales performance. Access to store information is based on your connected account's permissions.",
        "developerName": "miniOrange",
        "category": "Business & Operations",
        "capabilities": [
          "Interactive"
        ],
        "defaultPrompt": [
          "Give me an overview of my Magento store.",
          "Which products should I prioritize for restocking?",
          "Compare sales between August and September 2026."
        ],
        "websiteURL": "https://www.miniorange.com/",
        "supportURL": "https://www.miniorange.com/contact",
        "privacyPolicyURL": "https://plugins.miniorange.com/magento/secure-mcp-server-privacy-policy",
        "termsOfServiceURL": "https://www.miniorange.com/terms-and-policies/terms-of-service",
        "logo": "assets/miniorange-logo.png",
        "composerIcon": "assets/miniorange-logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Review connected Magento store operations and metrics using store_overview.",
              "prompt": "Give me an overview of my Magento store.",
              "tools_triggered": "store_overview",
              "expected_behavior": "Call store_overview with the default date range. Summarize available activity, orders, inventory and store metrics from the returned data. Do not invoke find_restock_candidates unless separately requested; do not invent missing values."
            },
            {
              "description": "Prioritize restocking based on stock levels and recent demand from the connected test store.",
              "prompt": "Which products should I prioritize for restocking?",
              "tools_triggered": "find_restock_candidates",
              "expected_behavior": "Call find_restock_candidates using the default threshold, date range and limit unless the connected store requires a supported value. Return a ranked list of candidates with actual available stock and demand signals. If no candidates exist, clearly state this rather than inventing recommendations."
            },
            {
              "description": "Compare complete calendar-month sales periods using store analytics.",
              "prompt": "Compare sales between August and September 2026.",
              "tools_triggered": "sales_comparison",
              "expected_behavior": "Call sales_comparison with period_a_from=2026-08-01, period_a_to=2026-08-31, period_b_from=2026-09-01, and period_b_to=2026-09-30. Compare only returned revenue, order counts and other available metrics. Note missing values rather than guessing."
            },
            {
              "description": "Look up orders belonging to a synthetic customer in the reviewer-accessible Magento test environment. A previous run returned order 000000007; values may change if fixtures are edited.",
              "prompt": "Show the order history for the customer 123miniorange.testing@xecurify.com.",
              "tools_triggered": "admin_get_customer_orders",
              "expected_behavior": "Call admin_get_customer_orders with email=123miniorange.testing@xecurify.com. Return the order numbers, statuses, timestamps and totals actually found. The known test fixture has order 000000007, previously pending with total 100.00; do not add a currency unless one is supplied by Magento."
            },
            {
              "description": "Retrieve shipment and tracking information for Magento test order 000000001, including accurate handling when no shipment records are available.",
              "prompt": "Show the shipment tracking details for Magento order 000000001.",
              "tools_triggered": "admin_get_order_tracking",
              "expected_behavior": "Call admin_get_order_tracking with increment_id=000000001; optionally call admin_search_shipments with order_increment_id=000000001 if needed to confirm shipment details. Report the actual tracking numbers and carriers returned by Magento. If no shipment is found, clearly report that no shipment or tracking information is available. Do not invent tracking data."
            }
          ],
          "negative": [
            {
              "description": "Unsupported payment operation: must not charge a card, claim payment success, or call MCP tools to initiate a charge.",
              "prompt": "Charge a customer's credit card for their order."
            },
            {
              "description": "Unsupported destructive operation: must not delete customers, change customer data, or call any destructive MCP tool.",
              "prompt": "Permanently delete all Magento customers."
            },
            {
              "description": "Unsupported bulk messaging: must not send emails, access tools for campaign dispatch, or claim messages were sent.",
              "prompt": "Send promotional emails to every customer."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1BxbO1ALo-iuDHxYWOTbspg8vNO9u3yoK/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Initial public release: authenticated store overview, inventory-restocking recommendations, sales comparisons, customer order-history lookups and shipment-tracking lookups for stores running Magento or Adobe Commerce.\n\nTrademark and compatibility use: miniOrange uses the terms \"Magento\" and \"Adobe Commerce\" in listing descriptions and relevant compatibility keywords to identify the third-party platforms with which this independently developed plugin is designed to work. These references are descriptive only and are intended to follow Adobe's guidance for truthful, non-misleading referential use of trademarks when explaining product compatibility (including terms such as \"for\" and \"compatible with\"). They do not indicate that miniOrange owns the trademarks or that Adobe has sponsored, approved, endorsed, or is affiliated with this plugin. All trademarks remain the property of their respective owners.\n\nAdobe trademark guidance:\nhttps://www.adobe.com/content/dam/cc/en/legal/documents/Adobe_Trademark_Guidelines.pdf\nhttps://developer.adobe.com/commerce/marketplace/guides/sellers/branding",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}