MCP Listings & Channels Tools

Channels Listing Status

channels_listing_status — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.

Which products are listed on which sales-channel accounts and in what state (active, scheduled, previously active, auto-relist), newest product id first. Answers “what is live on X” or “which products are missing from Y”. Paginate with limit/offset – each page fans out across every channel module, so keep pages small. COVERAGE IS PARTIAL and the gap is the point: only channels whose module reports listing state appear here. Covered are Amazon and eBay INCLUDING every regional marketplace they run (AmazonUK, AmazonDE, EbayUK, EbayAU and the rest – each is reported separately, because a jeweller’s listings differ per marketplace), plus Etsy, Bonanza, Rapnet, Sears, Shop, Social and Catalog – Catalog being the client’s own catalog site rather than a marketplace. NOT covered, and silently absent rather than reported empty: Shopify, Walmart, WooCommerce, BigCommerce, Magento, Magento2, Shein, LightspeedPOS, CustomChannel, and the dropship retailers TargetPlus and AAFES. An empty result therefore does NOT mean the product is unlisted everywhere. For anything in that second list use listings_list, which covers all of them. The manager Channels page has exactly the same blind spot.

limit (integer) — Default: 20.

offset (integer) — Default: 0.

Listings Get Detail

listings_get_detail — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.

One listing with its platform-specific options. Which options exist depends entirely on the platform – an eBay listing carries auction and duration settings that a Shopify listing has no equivalent for – so read them from the response rather than assuming a shape. Use it after listings_list to inspect how a single listing is configured. Returns found=false for an unknown listing.

listing_id (integer, required)

Listings List

listings_list — Read-only. Beta: this tool is being rolled out and may not be available on your account yet.

Search this client’s live and past listings across every sales platform they sell on. Returns the platform, the account it belongs to, the linked product, the platform’s own listing id, title, price, status and dates – newest first. Each regional marketplace is its own `channel` value, because a jeweller’s listings on Amazon.co.uk are separate from Amazon.com: filter on AmazonUK, EbayDE and so on, not on a parent brand. Retailers reached through a dropship integration are likewise their own value – Target Plus listings are TargetPlus – so filter on the retailer the jeweller actually sells to. Omit `channel` to search all platforms at once. Prefer this over channels_listing_status when you need listing-level detail, or a platform that tool does not report.

channel (string) — Platform identifier, exactly as listed. Not a brand name and not free text. One of: AAFES, Amazon, AmazonAU, AmazonCA, AmazonCN, AmazonDE, AmazonES, AmazonFR, AmazonIN, AmazonIT, AmazonJP, AmazonMX ….

account_id (integer)

statuses (array) — Match any of these statuses. ACTIVE is the listing the buyer can see and purchase; SOLD, ENDED and OUT_OF_STOCK are the usual reasons one is not selling; FAILED and MISSING_REQUIRED_FIELDS mean the platform rejected it and the jeweller needs to act. Item values: ACTIVE, PROCESSING, ENDED, SCHEDULED, NOT_LISTED, MARKED_FOR_END, INACTIVE, OUT_OF_STOCK, FAILED, MISSING_REQUIRED_FIELDS, READY_TO_SALE, RESERVED ….

only_existing_products (boolean) — Default: true.

limit (integer) — Default: 20.

offset (integer) — Default: 0.