CJ Dropshipping MCP server for your AI

Change an existing order's shipping service.

Re-assign an unshipped CJ order to a different CJ warehouse (e.g.

Confirm a created CJ order so it moves into the payment/fulfilment flow.

CREATE A CJ FULFILMENT ORDER (V3 — the current version; use this one).

DELETE an unpaid CJ order.

Get one CJ order in full: status, the shipping address, every line item (lineItemId, vid, sku, quantity, price), amounts, the chosen logistics service and the tracking number once shipped.

Fetch up to 100 order details in ONE call — far cheaper than looping cjdropshipping_get_order, and the right choice for any bulk sync.

Get carrier proof-of-delivery evidence (e.g.

List the shipping services an EXISTING order can switch to, with price and transit time.

List the connected account's CJ orders, newest first, with optional status and payment-date filters.

Add a CJ catalog product to the connected account's "My Products" list (the CJ-side equivalent of favouriting/importing it so it can be listed to a store).

Get ONE product in full, including every variant and its per-country stock — the tool to call before ordering.

List CJ's full three-level product category tree.

List every CJ global warehouse available for sourcing/shipping: [ { areaId, areaEn (e.g.

List the products the connected account has added to "My Products" in CJ.

List buyer reviews for one CJ product.

List CJ catalog products with structured filters.

SEARCH the CJ product catalog (V2, Elasticsearch-backed) — the best tool for "find me products like X".

List the stores connected to this CJ account: [ { id, name, aliasName, type (shopify / ebay / tiktok / …), status (0 deleted, 1 authorized, 2 deactivated, 3 auth failed, 4 auth expired, 5 in transition), countryCode, storeCountry, currencyCode, marketplace, syncInventory, trackUrlTemplate, … } ].

STEP 3: OPEN a dispute (refund or reissue claim) on a CJ order.

Get one dispute in full: its status, reason, requested outcome, refund type, message thread, evidence and the disputed line items with amounts.

STEP 1 of raising a dispute: list the line items of a CJ order that are eligible for a refund/reissue claim, with their lineItemId, quantity and price.

List the account's disputes, optionally narrowed to one order, dispute id or store order number.

STEP 2: preview what a dispute for these line items would allow — the maximum refundable product price, postage and IOSS tax (maxProductPrice, maxPostage, maxAmount), the permitted expectResultOptionList, the resolved product details, and disputeReasonList[] { disputeReasonId, reasonName } whose id you must pass to cjdropshipping_create_dispute.

CALCULATE SHIPPING OPTIONS between two countries for one or more variants — call this BEFORE creating an order, because its `logisticName` values are the only ones cjdropshipping_create_order accepts (an invented name fails with 1605001 'Logistic invalid').

PRECISE freight quote that accounts for real weight, volume, destination address and product logistics attributes — use it when cjdropshipping_calculate_freight is too coarse.

Track one or more shipments by tracking number.

Get the connected CJ account's prepaid wallet balance (USD).

Get stock for an ENTIRE product in one call: data.inventories[] is the product-level per-warehouse roll-up and data.variantInventories[] breaks it down per variant ({ vid, inventory[] { countryCode, totalInventory, cjInventory, factoryInventory, verifiedWarehouse, stock[] } }).

Check stock by SKU or SPU across every CJ warehouse.

Check stock for ONE variant across every CJ warehouse.

PAY a single CJ order from the account's prepaid balance.

PAY a PARENT/shipment order (V2) from the prepaid balance — the version to use after the cart flow (cjdropshipping_create_parent_order) and for private-inventory (SY) orders.

Get the connected CJ account's profile and API settings: openId, openName, openEmail, the daily quota limits per endpoint (setting.quotaLimits[] with quotaUrl / quotaLimit / quotaType where 0=total 1=year 2=quarter 3=month 4=day 5=hour), the account QPS limit (setting.qpsLimit), the currently configured webhook callback URLs (callback.product / .order), the account tier (root: NO_PERMISSION | GENERAL | VIP | ADMIN) and whether this is a sandbox account (isSandbox).

Get ONE variant by its variant id (vid), optionally with live inventory.

List every variant (SKU) of one product without the rest of the product payload.

Get one CJ warehouse's full detail by its storage id: { id, name, areaId, areaCountryCode, address1/address2, contacts, phone, city, province, logisticsBrandList: [ { id, name } ] }.

Move one or more created CJ orders into the CJ cart, the first step of the cart-based checkout flow (addCart → addCartConfirm → saveGenerateParentOrder → pay).

Confirm the orders currently in the CJ cart.

Create a CJ order using the older V2 endpoint.

Generate the payable PARENT order for a shipment (step 3 of the cart checkout flow).

SANDBOX ONLY: mark a sandbox order as paid without any real money moving.

SANDBOX ONLY: force a sandbox order into a chosen status so you can exercise downstream flows end-to-end.

SANDBOX ONLY: attach an arbitrary tracking number to a sandbox order so tracking webhooks and lookups can be tested.

Replace the print-on-demand artwork on order line items before production starts.

Ask CJ to SOURCE a product that isn't in the CJ catalog yet: submit a name, image and (ideally) the URL of the product on another marketplace, and CJ's sourcing team quotes it.

Check the status/result of previously submitted sourcing requests (read-only despite being a POST).

Get the marketing/demo videos attached to a CJ product (read-only despite being a POST).

Add SKUs to the private-inventory (stock-up) cart.

Convenience: confirmation AND full cost breakdown in one call — the fastest way to quote a private-inventory stock-up.

STEP 4: CREATE the private-inventory (SY) stock-up order.

Read the private-inventory cart.

STEP 1 of buying private inventory (stocking up): confirm a set of SKUs and get back the warehouses that can hold them — availableStorehouseList[].storageId is the value every later step needs.

STEP 3: price a private-inventory stock-up — product cost, freight and the integrated total for a chosen warehouse (and optionally a chosen carrier).

STEP 2: list the shipping services available for a private-inventory stock-up from a chosen warehouse.

List private-inventory (SY) stock-up orders with status and date filters.

Remove SKUs from the private-inventory cart.

Get full detail (including variants and their CJ links) for up to 10 store products at once.

LINK one CJ product to one of your store products, variant by variant, so orders for that store product can be fulfilled by CJ.

List the CJ↔store product links (connections) for a shop — which CJ variant each of your store variants maps to, plus the default warehouse area and logistics chosen for it.

Paged list of the account's store products with their CJ-link status.

Cancel an unfinished outbound order and release its locked inventory.

STEP 4: create (or update) a private-inventory OUTBOUND order — ship units you already own out of the CJ warehouse to a customer.

Get one outbound order's full detail — its address, product lines and lock state.

Poll the async progress of outbound-order creation/submission: inventory-lock results, lock failures, and submit/payment status.

STEP 1 of shipping stock OUT of private inventory: list the address candidates for the connected account.

STEP 2: list the private-inventory units that can actually be shipped out of a warehouse.

STEP 3 (recommended): re-check live availability for the exact lines you are about to submit, so the create call does not fail on a stale quantity.

STEP 5: submit a created outbound order for warehouse processing.

Upsert one of YOUR store's products into CJ so it can be linked to a CJ product.

Upsert your store's product VARIANTS into CJ in one batch.

Remove a CJ↔store product link.

Withdraw an open dispute.

Poll the progress of the auto-match job started by cjdropshipping_match_mergeable_orders.

Read the result of the auto-match job: the groups of orders CJ suggests merging, with their store order info and available shipping options.

Poll the progress of the merge-submit job started by cjdropshipping_submit_merge_orders.

Read the outcome of the merge-submit job: { successGroupCount, successOrderCount, newOrderCodeList[] (the merged order codes), failGroupCount, failOrderCount, mergeFailOrderGroupList[] { errorCode, orderCodes[] } }.

Fetch the warehouse's inbound photos/videos for private-inventory stock orders (proof of what physically arrived).

List the individual stock BATCHES behind one private-inventory SKU (each batch has its own arrival, unit price and remaining quantity).

Paged inventory-movement ledger for private inventory: every inbound, outbound and adjustment record for a SKU, with the business order that caused it.

List the connected account's PRIVATE INVENTORY (stock the merchant has pre-purchased and stored in a CJ warehouse) grouped by product/SPU.

Paged, filterable view of private-inventory SKU detail across warehouses.

List the private-inventory SKUs held under one product.

ASYNC step 1 of order merging: ask CJ to find orders that share a destination and can be combined into one shipment (saving postage).

ASYNC step 2: actually MERGE a group of orders into one combined order.

Freight quote for a merchant-partner order shaped like a real order payload (full destination address + products).

Get the self-shipment logistics template (the carrier options and rates a supplier ships with) for one or more SPUs.

List the products currently subscribed to change notifications, optionally filtered by SPU or product id.

Configure where CJ pushes event callbacks.

Subscribe to product/stock change notifications for specific products, or for the whole catalog.

Stop product/stock notifications for specific products.

Save a new address to the account's address book.

Get COGS (cost-of-goods-sold) basic data for a list of CJ order codes — the per-order product cost, shipping cost and totals used for profit reporting.

List the connected account's saved address book.

Update a saved address.

Replace a previously uploaded label / tracking number on a platform-logistics order.

Upload YOUR OWN carrier label + tracking number for a platform-logistics order (shopLogisticsType 1) so the CJ warehouse can ship it.

Create a payment order for selected make-up bills.

List outstanding MAKE-UP (supplement) bills — the extra charges CJ raises after an order ships, e.g.

Update the CJ developer account's display profile — the openName and openEmail shown by cjdropshipping_get_settings.