plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "listadum",
  "version": "0.1.1",
  "description": "Connect to Listadum to work with Etsy stores, listings, orders, reviews, and keyword analytics.",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Listadum",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png",
        "logoDark": "./assets/logo.png",
        "composerIconDark": "./assets/logo.png",
        "brandColor": "#000000",
        "brandColorDark": "#ffffff",
        "shortDescription": "Manage your Etsy stores",
        "longDescription": "Listadum helps Etsy sellers manage daily store operations through their connected Listadum account. Inspect product listings and performance insights, review orders and customer reviews, and research keywords. Update listing titles, descriptions, tags, materials, and inventory; publish draft listings or schedule their publication. Available actions depend on your account permissions and enabled Listadum features. Manage reusable description snippets and preview which listings a snippet update will affect. Order summaries omit buyer identity; fulfillment details are available only when specifically needed.",
        "category": "Business & Operations",
        "defaultPrompt": "Review my Etsy stores and identify listings that need attention.",
        "developerName": "Tadum LLC",
        "websiteURL": "https://www.listadum.com",
        "supportURL": "https://www.listadum.com/help-center",
        "privacyPolicyURL": "https://www.listadum.com/privacy",
        "termsOfServiceURL": "https://www.listadum.com/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Use the connected review account with a Listadum subscription and API Access Add-on. Fixture: listadum store f572afdc-bdd8-40b2-ad76-d11a0ae488f8, draft listing bc5f28c4-e715-4bd7-b61e-f051333dae54 (DEMO - Test Listing (do not delete)). Store discovery and draft diagnosis.",
              "prompt": "Show my accessible stores, then inspect draft listing bc5f28c4-e715-4bd7-b61e-f051333dae54 in listadum, including its quality issues and performance insights.",
              "tools_triggered": "list_stores, get_listing, get_listing_issues, get_listing_insights",
              "expected_behavior": "Report only accessible stores returned by list_stores. Use storeId=f572afdc-bdd8-40b2-ad76-d11a0ae488f8 and listingId=bc5f28c4-e715-4bd7-b61e-f051333dae54 for all listing tools. Identify the draft and summarize returned issues and insights, distinguishing unavailable metrics from zero. Do not modify the listing."
            },
            {
              "description": "Use the connected review account with a Listadum subscription and API Access Add-on. Fixture: listadum store f572afdc-bdd8-40b2-ad76-d11a0ae488f8, draft listing bc5f28c4-e715-4bd7-b61e-f051333dae54 (DEMO - Test Listing (do not delete)). Keyword comparison.",
              "prompt": "Compare keyword data for custom lake map and minimalist lake map.",
              "tools_triggered": "get_keyword_batch",
              "expected_behavior": "Use keywords=[\"custom lake map\", \"minimalist lake map\"]. Compare only returned metrics, state any missing data, and do not fabricate estimates."
            },
            {
              "description": "Use the connected review account with a Listadum subscription and API Access Add-on. Fixture: listadum store f572afdc-bdd8-40b2-ad76-d11a0ae488f8, draft listing bc5f28c4-e715-4bd7-b61e-f051333dae54 (DEMO - Test Listing (do not delete)). Valid empty orders and reviews. This store has no orders or reviews; the recording uses ParciparlaCo for populated examples.",
              "prompt": "Show up to five recent orders and five recent customer reviews from my listadum store.",
              "tools_triggered": "list_orders, list_reviews",
              "expected_behavior": "Use storeId=f572afdc-bdd8-40b2-ad76-d11a0ae488f8, page=1 and limit=5 for both tools. Report empty results honestly; do not invent orders, reviews, or detail identifiers. Do not call get_order or get_review without an actual returned identifier. If data has since been added, summarize only returned records. Order list entries must omit buyerUserId, name, city, state, and zip. For general order detail requests, leave includeBuyerDetails omitted or false; returned transactions must omit personalization. Only request includeBuyerDetails=true when buyer details or personalization are necessary for the user\u2019s request. An empty orders fixture does not validate populated-order privacy; run the supplemental synthetic fixture checks in the reviewer notes."
            },
            {
              "description": "Use the connected review account with a Listadum subscription and API Access Add-on. Fixture: listadum store f572afdc-bdd8-40b2-ad76-d11a0ae488f8, draft listing bc5f28c4-e715-4bd7-b61e-f051333dae54 (DEMO - Test Listing (do not delete)). Reversible draft title and inventory edits; capture current values before changing anything.",
              "prompt": "On draft bc5f28c4-e715-4bd7-b61e-f051333dae54 in listadum, save its current title and full inventory, change the title to DEMO - Reviewer Test Listing and its single variant quantity to 998, verify both changes, then restore the original title and inventory and verify restoration. Keep it a draft.",
              "tools_triggered": "get_listing, update_listing, update_listing_inventory",
              "expected_behavior": "Use storeId=f572afdc-bdd8-40b2-ad76-d11a0ae488f8 and listingId=bc5f28c4-e715-4bd7-b61e-f051333dae54. Read first and confirm draft state and single variant. Snapshot title and complete inventory. Update title and replace inventory preserving price, SKU, enabled state, processing profile, options, scales and variesBy. Read back to verify title and quantity=998, then restore original title and complete inventory and read back again. Final title/inventory must match the initial snapshot; state stays draft. Never publish. Report any failed step or incomplete restoration explicitly."
            },
            {
              "description": "Use the connected review account with a Listadum subscription and API Access Add-on. Fixture: listadum store f572afdc-bdd8-40b2-ad76-d11a0ae488f8, draft listing bc5f28c4-e715-4bd7-b61e-f051333dae54 (DEMO - Test Listing (do not delete)). Schedule and immediately cancel a future publication on the dedicated draft.",
              "prompt": "For draft bc5f28c4-e715-4bd7-b61e-f051333dae54 in listadum, schedule publication for 20:00 UTC on the date 30 days from today, then immediately cancel that schedule and verify it remains an unscheduled draft. Do not publish it now.",
              "tools_triggered": "get_listing, schedule_listing, unschedule_listing",
              "expected_behavior": "Use storeId=f572afdc-bdd8-40b2-ad76-d11a0ae488f8 and listingId=bc5f28c4-e715-4bd7-b61e-f051333dae54. Read first and confirm draft state and no existing schedule; if a schedule already exists, stop and explain rather than replace it. Resolve the future date explicitly in UTC, call schedule_listing with that timestamp, immediately call unschedule_listing, and read back. Final state must be draft and scheduledAt=null. Never call publish_listing. If cancellation fails, clearly report the remaining scheduled publication and retry cancellation where appropriate."
            }
          ],
          "negative": [
            {
              "description": "Unsupported refund action. Explain that this plugin can inspect refund data but cannot issue refunds. Do not invoke any Listadum tools or claim a refund was issued.",
              "prompt": "Issue a full refund for an Etsy order through Listadum."
            },
            {
              "description": "Unsupported buyer messaging. Explain that the plugin cannot send buyer messages. Do not invoke Listadum tools or claim a message was sent.",
              "prompt": "Send an Etsy message to my buyer saying their order ships tomorrow."
            },
            {
              "description": "Unsupported purchasing. Explain that this plugin cannot place purchases. Do not invoke Listadum tools or claim a purchase was placed.",
              "prompt": "Buy a ceramic mug on Etsy for me using this plugin."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Customers create an account on listadum.com and purchase a Listadum subscription and the API Access Add-on there. The API Access Add-on is required to use Listadum API and MCP integrations.",
        "demo_recording_url": "https://www.youtube.com/watch?v=DwH2UDnYNyM",
        "prompts": [
          "Which listings in my store need attention?",
          "Summarize recent order totals and shipping status.",
          "Preview which listings would change if I update a description snippet."
        ]
      },
      "publication": {
        "release_notes": "Resubmission addressing tool annotations and data minimization: all 24 tools explicitly declare readOnlyHint, destructiveHint, idempotentHint, and openWorldHint. Publishing is marked destructive because it makes a listing public and can incur an Etsy fee. Order lists omit buyer identifiers; order details omit buyer identity and personalization unless includeBuyerDetails=true is needed for the user\u2019s request. Invalid order IDs are rejected and unknown orders return a structured error.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Tadum LLC"
  }
}