Connector guide7-minute read25 MCP tools7 languages

Connect Wish to Meta Muse via MCP: Orders and Products

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.

HCBy HelpCode teamUpdated 7 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Wish

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.

tools

25

Region

INTL

Category

E-commerce

Authentication

Bearer Token

Required env vars

WISH_ACCESS_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

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 Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Wish in the guided setup, then add your MCP URL to Meta Muse. 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.

Wish · live via MCP
Share
Opus 4.7

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 + Meta Muse

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.

  1. 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.
  2. 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.
  3. 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. Copy data.access_token into WISH_ACCESS_TOKEN and keep data.refresh_token safe.

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 Muse

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 shows YOUR_SERVER_ID.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

  1. In Muse, open Settings → Connectors and choose Add custom connector.
  2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
  4. In a chat, ask Muse for something that needs the Wish tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Available tools

ToolWhat it does
wish_test_tokenCheck that the access token works: returns the merchant id and the token's scopes
wish_get_account_detailsThe merchant account: id, display name, contact, country, status and other account details
wish_list_ordersList orders, most recently updated first by default: id, state (APPROVED to ship, SHIPPED, REFUNDED, REQUIRE_REVIEW), order type, product…
wish_get_orderOne order by id: state, product and variation, quantity, prices and payout, shipping address, fulfillment requirements and deadline…
wish_list_shipping_carriersAccepted shipping carriers: all carriers (GENERAL) or those accepted for the Confirmed Delivery policy to a destination country…
wish_fulfill_orderMark an order shipped, or update its tracking: carrier, tracking number and origin country. Asynchronous; read the order again to see the…
wish_list_refund_reasonsRefund reasons valid for one order right now (they change during the order's life). Read them just before a refund
wish_refund_orderRefund 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_productsList products, most recently updated first by default: id, parent_sku, name, state, category, images, variations (id, sku, price, inventory…
wish_get_productOne product by id with its variations, prices, inventory per warehouse, images, attributes, shipping and review state
wish_create_productCreate a product with at least one variation. Needs name, description (plain text, up to 4,000 characters), parent SKU, category, main…
wish_update_productUpdate a product: name, description, tags, category, images, default shipping prices, status, or its existing variations (by variation id…
wish_delete_productDelete a product listing. It cannot be undone. Installed switched off; disable variations with wish_update_product instead
wish_create_variationAdd a variation to an existing product: sku, price, inventory per warehouse, option values and image
wish_get_categoriesThe 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_categoryOne category by id with its children; leaf categories can be used as category_id
wish_get_category_attributesAttributes of a category (name, required, allowed values) to fill attributes and options when creating products
wish_get_product_ratingOverall rating of a product: average rating and rating counts
wish_list_ticketsCustomer support tickets, most recently updated first: id, type (ORDER, PRE_PURCHASE, POST_CUSTOMER_SUPPORT), state (AWAITING_MERCHANT…
wish_get_ticketOne support ticket with its messages, related order and state
wish_reply_to_ticketReply to a ticket in state AWAITING_MERCHANT (up to 2,000 characters, Markdown allowed). Wish updates the state after the reply
wish_update_ticketClose a ticket (CLOSED), re-open a closed one (AWAITING_MERCHANT, when allowed) or appeal to Wish support (AWAITING_WISH)
wish_list_penaltiesPenalties 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_settingsMerchant shipping settings per destination country Wish ships to: enabled countries, shipping prices and regions
wish_list_warehousesThe 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.

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Next steps

Was this guide helpful?

Connect Wish to Meta Muse in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Wish in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.

Related guides

Connectors

Connect Wish to ChatGPT via MCP: Orders and Products

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.

Connectors

Connect Wish to Claude via MCP: Orders and Inventory

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.

Connectors

Connect Wish to Microsoft Copilot via MCP

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.

Connectors

Connect Wish to Cursor via MCP: Orders and Inventory

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.

Connectors

Connect Wish to Gemini CLI via MCP: Orders and Tickets

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.

Connectors

Wish MCP Server: Orders, Products and Tickets

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.