Summary
Wish Marketplace API v3 for merchants: orders and fulfillment with tracking, products and variations with prices and inventory per warehouse, categories and attributes, customer support tickets, ratings, penalties, warehouses and shipping settings. OAuth access token from a private app.
Guided setup
Connect Wish to Claude, ChatGPT or Copilot in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Wish in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Wish
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Wish, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Wish
Wish Marketplace API v3 for merchants: orders and fulfillment with tracking, products and variations with prices and inventory per warehouse, categories and attributes, customer support tickets, ratings, penalties, warehouses and shipping settings. OAuth access token from a private app.
Setup
Setting up takes about 10 minutes.
- In the Wish merchant dashboard (https://merchant.wish.com) open the Account menu, API Settings, and click Register a private app. Enter a name and an HTTPS redirect URI you own (any page works, the code only has to appear in its address). Wish allows one private app per merchant.
- Open
https://merchant.wish.com/v3/oauth/authorize?client_id=followed by the app's client ID, sign in and approve. Wish redirects to your redirect URI with?code=in the address; the code is valid for 5 minutes and works once. - Exchange the code: open
https://merchant.wish.com/api/v3/oauth/access_token?grant_type=authorization_code&client_id=...&client_secret=...&code=...&redirect_uri=...with your values. Copydata.access_tokenintoWISH_ACCESS_TOKENand keepdata.refresh_tokensafe.
Token lifetime: Wish access tokens expire after 30 days. Before that, open https://merchant.wish.com/api/v3/oauth/refresh_token?grant_type=refresh_token&client_id=...&client_secret=...&refresh_token=... and paste the new access token into the connector (the old one is revoked). Wish renews tokens only with GET requests, which the connector's automatic OAuth renewal does not send, so the renewal is manual for now.
Where to start: wish_test_token checks the token and shows its scopes. wish_list_orders with states APPROVED lists orders to ship; wish_list_products lists the catalog; wish_list_warehouses gives the warehouse ids that inventory needs.
Orders: wish_list_orders, wish_get_order. Ship with wish_fulfill_order (carrier from wish_list_shipping_carriers, tracking number, origin country); the same call corrects tracking later. Shipping and refunds are asynchronous: read the order again for the result. wish_list_refund_reasons shows valid reasons; wish_refund_order refunds the customer and is installed switched off.
Products: wish_list_products, wish_get_product, wish_create_product, wish_update_product (price, inventory per warehouse, status of variations by variation id), wish_create_variation. Categories: wish_get_categories, wish_get_category, wish_get_category_attributes. wish_delete_product is installed switched off; disable variations instead. wish_get_product_rating reads the rating.
Customer tickets: wish_list_tickets (state AWAITING_MERCHANT needs an answer), wish_get_ticket, wish_reply_to_ticket, wish_update_ticket (close, re-open, appeal).
Account: wish_get_account_details, wish_list_penalties, wish_get_shipping_settings, wish_list_warehouses.
Paging: lists return up to limit items sorted by time; for the next page call again with updated_at_max (or created_at_max) set to the last item's time. Every answer has the shape code, message, data; code 0 means success.
Ids and formats: order, product, variation, ticket and warehouse ids are 24-character hex strings. Times are ISO 8601 (2026-11-01T00:00:00Z). Prices are objects with amount and currency_code. The token's scopes decide what works: a missing scope answers 403.
Rate limits: per merchant and app; the header Wish-Rate-Limit-Remaining shows what is left and a 429 carries Wish-Rate-Limit-Reset. Quote the Wish-Request-Id header when contacting Wish about a call.
Prerequisites: WISH_ACCESS_TOKEN
Install the connector locally
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Open http://localhost:3000/connectors/store, pick Wish and paste in the env vars listed under Prerequisites.
Available tools
| Tool | What it does |
|---|---|
wish_test_token | Check that the access token works: returns the merchant id and the token's scopes |
wish_get_account_details | The merchant account: id, display name, contact, country, status and other account details |
wish_list_orders | List orders, most recently updated first by default: id, state (APPROVED to ship, SHIPPED, REFUNDED, REQUIRE_REVIEW), order type, product… |
wish_get_order | One order by id: state, product and variation, quantity, prices and payout, shipping address, fulfillment requirements and deadline… |
wish_list_shipping_carriers | Accepted shipping carriers: all carriers (GENERAL) or those accepted for the Confirmed Delivery policy to a destination country… |
wish_fulfill_order | Mark an order shipped, or update its tracking: carrier, tracking number and origin country. Asynchronous; read the order again to see the… |
wish_list_refund_reasons | Refund reasons valid for one order right now (they change during the order's life). Read them just before a refund |
wish_refund_order | Refund or cancel an order with a reason from wish_list_refund_reasons. The customer gets the money back and it cannot be undone; refunds… |
wish_list_products | List products, most recently updated first by default: id, parent_sku, name, state, category, images, variations (id, sku, price, inventory… |
wish_get_product | One product by id with its variations, prices, inventory per warehouse, images, attributes, shipping and review state |
wish_create_product | Create a product with at least one variation. Needs name, description (plain text, up to 4,000 characters), parent SKU, category, main… |
wish_update_product | Update a product: name, description, tags, category, images, default shipping prices, status, or its existing variations (by variation id… |
wish_delete_product | Delete a product listing. It cannot be undone. Installed switched off; disable variations with wish_update_product instead |
wish_create_variation | Add a variation to an existing product: sku, price, inventory per warehouse, option values and image |
wish_get_categories | The root of Wish's category tree with its child categories (id, name, is_leaf). Walk down with wish_get_category to a leaf for category_id |
wish_get_category | One category by id with its children; leaf categories can be used as category_id |
wish_get_category_attributes | Attributes of a category (name, required, allowed values) to fill attributes and options when creating products |
wish_get_product_rating | Overall rating of a product: average rating and rating counts |
wish_list_tickets | Customer support tickets, most recently updated first: id, type (ORDER, PRE_PURCHASE, POST_CUSTOMER_SUPPORT), state (AWAITING_MERCHANT… |
wish_get_ticket | One support ticket with its messages, related order and state |
wish_reply_to_ticket | Reply to a ticket in state AWAITING_MERCHANT (up to 2,000 characters, Markdown allowed). Wish updates the state after the reply |
wish_update_ticket | Close a ticket (CLOSED), re-open a closed one (AWAITING_MERCHANT, when allowed) or appeal to Wish support (AWAITING_WISH) |
wish_list_penalties | Penalties on the account, newest first: id, type, amount and currency, reason, order or product, created and reversed time. Up to 500 per… |
wish_get_shipping_settings | Merchant shipping settings per destination country Wish ships to: enabled countries, shipping prices and regions |
wish_list_warehouses | The merchant's warehouses: id, name, type (standard warehouse first), address. Warehouse ids are needed for inventory and shipping prices |
Example prompts
- "Which Wish orders need fulfillment today?"
- "Fulfil order 64a1b2c3d4e5 with USPS tracking 9400111899223197428490."
- "Which support tickets are waiting for my reply?"
- "Are there new penalties on my account this month?"
- "What is the rating of product 5f9e8d7c6b5a?"
Next steps
Was this guide helpful?