plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "return-helper",
  "version": "1.0.1",
  "description": "Look up cross-border returns, warehouse inventory, shipments, and related account information from ChatGPT.",
  "author": {
    "name": "Return Helper"
  },
  "keywords": [
    "returns",
    "shipping",
    "warehouse",
    "inventory",
    "ecommerce"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Return Helper",
        "shortDescription": "Cross-border returns lookup",
        "longDescription": "Manage your Return Helper returns \u2014 right from ChatGPT.\n\nConnect ChatGPT to your Return Helper account to check on cross-border returns without leaving the chat. This connector lets you:\n\n- Look up return requests and their current status\n- Search warehouse inventory for received goods across your warehouses\n- Track shipments by tracking number, shipment number, or seller reference\n- View shipment status definitions and handling fee calculation types\n- Retrieve return photos and warehouse details\n\nBuilt for merchants and marketplace operators managing cross-border e-commerce returns.",
        "developerName": "Return Helper",
        "category": "Business & Operations",
        "capabilities": [],
        "defaultPrompt": [
          "Show my recent return shipments.",
          "Search warehouse inventory for a SKU.",
          "Explain shipment status codes and handling fee calculation types."
        ],
        "websiteURL": "https://www.returnhelper.com/ai-connector",
        "supportURL": "https://www.returnhelper.com/ai-connector",
        "privacyPolicyURL": "https://www.returnhelper.com/privacy",
        "termsOfServiceURL": "https://www.returnhelper.com/terms-and-service",
        "logo": "./assets/rh-icon-512.png",
        "composerIcon": "./assets/rh-icon-512.png"
      },
      "review": {
        "prompts": [
          "Show my recent return shipments and summarize their latest statuses.",
          "Find received warehouse inventory for SKU DEMO-SKU-001.",
          "Look up shipment tracking number DEMO-TRACK-001 and explain its status."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Dedicated reviewer account has at least two recent shipments, including one linked to a return request. Verify recent shipment lookup and the follow-up request detail use only the authenticated account's data.",
              "prompt": "Show my recent return shipments, then give me the details for the return request linked to the newest shipment.",
              "tools_triggered": "search_shipments, get_return_request",
              "expected_behavior": "Summarize only shipments returned by the account's recent search, state each returned status and tracking detail accurately, then retrieve the matching return request by its returned numeric returnRequestId. Do not invent a request identifier or fields absent from the tool results."
            },
            {
              "description": "Dedicated reviewer account contains received inventory seeded with SKU DEMO-SKU-001. Verify the SKU search and pagination-aware result summary.",
              "prompt": "Find received warehouse inventory for SKU DEMO-SKU-001 and summarize the matching items.",
              "tools_triggered": "search_return_inventory",
              "expected_behavior": "Report matching inventory records and their returned warehouse, RMA, quantity-independent item details, and handling status where available. If there are no matches, say so without fabricating inventory."
            },
            {
              "description": "Dedicated reviewer account contains a shipment with tracking number DEMO-TRACK-001. Verify exact tracking lookup across the available history.",
              "prompt": "Track shipment DEMO-TRACK-001 and tell me its current status and warehouse.",
              "tools_triggered": "search_shipments",
              "expected_behavior": "Return the matching shipment's status, tracking number, and warehouse identifier from tool results. If no match is returned, report no matching shipment rather than guessing."
            },
            {
              "description": "Use the account's live reference definitions; no fixture records are required.",
              "prompt": "Explain the shipment status codes and handling fee calculation types available to my account.",
              "tools_triggered": "list_shipment_statuses, list_handling_fee_calculation_types",
              "expected_behavior": "Explain only status codes and fee calculation types returned by the tools, preserving their descriptions and noting when a list has no entries."
            },
            {
              "description": "Dedicated reviewer account has an accessible warehouse and a received inventory record with a seeded return photo. Verify warehouse lookup followed by inventory detail and photo retrieval.",
              "prompt": "Show my available warehouses, then show the photo for the received inventory item with SKU DEMO-PHOTO-SKU-001.",
              "tools_triggered": "list_warehouses, search_return_inventory, get_return_inventory, get_return_image",
              "expected_behavior": "List only warehouses returned for the account, identify the matching received item from search results, retrieve its details and a returned photo file key, and show the fetched photo when available. Explain clearly if the fixture or image is unavailable; do not invent a photo or expose unrelated account data."
            }
          ],
          "negative": [
            {
              "description": "Creation is outside the Connector's read-only scope. No server tool should be called. Expected result: Explain that the Connector can look up return information but cannot create return requests. Do not claim a request was created and do not call any MCP tool.",
              "prompt": "Create a new return request for order DEMO-ORDER-001."
            },
            {
              "description": "Refunds and payments are outside the Connector's scope. No server tool should be called. Expected result: Explain that the Connector cannot issue refunds or process payments. Do not claim a refund was issued and do not call any MCP tool.",
              "prompt": "Issue a refund for return request RH-DEMO-001."
            },
            {
              "description": "Changing warehouse handling instructions is outside the Connector's read-only scope. No server tool should be called. Expected result: Explain that the Connector can retrieve inventory details but cannot change handling instructions. Do not claim an update was made and do not call any MCP tool.",
              "prompt": "Change the handling instructions for inventory item DEMO-INVENTORY-001 to dispose of it."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin retrieves Return Helper account data only. It does not sell products, purchase services, or process payments.",
        "demo_recording_url": "https://drive.google.com/file/d/1GDK1NGliVS2O_fIVZuqjhbUCjhPDuXhq/view?usp=drive_link"
      },
      "publication": {
        "release_notes": "Initial public package for the existing Return Helper MCP connector. Provides read-only lookup of return requests, received warehouse inventory, shipments, reference definitions, warehouses, and return photos.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}