Back to Tool Reference
MCP

listing.get

Return a unified listing payload, resolving the channel automatically.

Effectread-onlyScopelisting:readPlanStarter+

Parameters

listing_idstringRequired

UUID of the parent listing (the same handle the dashboard uses across TikTok/Etsy/Shopify).

Returns

Listing dict with at minimum id, channel, status, content (title/description/images), and channel-native fields (e.g. warehouse, tags).

Request
json
{
  "name": "listing.get",
  "arguments": {
    "listing_id": "2cf8d0c6-934e-411e-acc3-89b851958bc9"
  }
}
Response
json
{
  "status": "DRAFT",
  "source": "CREATED",
  "productionPartner": null,
  "productionPartnerProductId": "",
  "productionPartnerSyncStatus": "",
  "gender": null,
  "etsyListingId": null,
  "etsyShopId": null,
  "taxonomyId": "482",
  "taxonomyName": "Gender-Neutral > Tops & Tees > T-shirts",
  "whoMade": "i_did",
  "whenMade": "made_to_order",
  "isSupply": false,
  "tags": [
    "custom photo shirt",
    "dog remembrance gift"
  ],
  "materials": [],
  "occasion": null,
  "style": [],
  "shippingProfileId": null,
  "processingMin": 2,
  "processingMax": 5,
  "isPersonalized": true,
  "personalizationIsRequired": false,
  "personalizationInstructions": null,
  "attributes": {},
  "variants": [
    {
      "sku": "pl-tee-custom-photo-s",
      "price": "19.99",
      "quantity": 999,
      "propertyValues": [
        {
          "values": [
            "S"
          ],
          "scale_id": null,
          "property_name": "Size"
        }
      ],
      "isEnabled": true
    },
    {
      "sku": "pl-tee-custom-photo-m",
      "price": "19.99",
      "quantity": 999,
      "propertyValues": [
        {
          "values": [
            "M"
          ],
          "scale_id": null,
          "property_name": "Size"
        }
      ],
      "isEnabled": true
    }
  ],
  "content": {
    "title": "Custom photo shirt — Personalized Shirt on Bella + Canvas, Your Photo Printed Properly, Free Shipping",
    "description": "Type it. We print it. You wear it.\n\n— WHAT YOU GET —\nA shirt printed to order on a Bella+Canvas 3001 (4.2 oz, 100% Airlume combed cotton). Water-based inks,\nprinted when you order it — no overstock, no warehouse dust.\n\n— HOW TO PERSONALIZE…",
    "images": [],
    "size_chart_image_url": null,
    "video_url": null,
    "channel_snapshot": {}
  },
  "product_design": {
    "id": "4667abde-0c70-4f50-9e6f-417b6b765654",
    "title": "Custom Photo T-Shirt"
  },
  "priceBreakdown": null,
  "created_at": "2026-06-10T14:42:26.581751Z",
  "updated_at": "2026-06-10T14:42:26.581754Z",
  "published_at": null,
  "channel": "etsy",
  "id": "2cf8d0c6-934e-411e-acc3-89b851958bc9"
}