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 ChatGPT in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Wish in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP's plugin in ChatGPT's directory answers questions from your company databases on AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, read-only): open the listing (opens in a new tab) and click Install plugin. Every other connector is added to ChatGPT as a custom MCP server with your AnythingMCP MCP URL.
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 + ChatGPT
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.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
WISH_ACCESS_TOKEN
Step 1 — Get credentials
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.
Step 2 — Install the adapter
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
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
- Enter a name, e.g. Name:
Wish. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
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?"
FAQ
Does the token renew itself? No. Wish access tokens expire after 30 days, and Wish renews them only with a request the connector's automatic renewal does not send. Renew the token with your refresh token before it expires and paste the new one.
Where does the token come from? From a private app you register in the Wish merchant dashboard under API Settings: authorize it, exchange the code for an access token and paste the token.
Which tools install switched off? wish_refund_order and wish_delete_product. Switch them on on the connector page only if the AI should use them.
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?