Connector guide8-minute read22 MCP tools7 languages

How to Connect Shopee Seller to ChatGPT via MCP

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

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

Shopee Seller

Shopee Seller

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

tools

22

Region

INTL

Category

E-commerce

Authentication

Signed request (HMAC)

Required env vars

SHOPEE_HOSTSHOPEE_PARTNER_IDSHOPEE_PARTNER_KEY
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

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Shopee Seller in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

Try asking

Example prompts for Shopee Seller

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Shopee Seller · 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 → Shopee Seller, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Shopee Seller + ChatGPT

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

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:

SHOPEE_HOST, SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY

Step 1 — Get credentials

Setting up takes about 15 minutes the first time, plus the time Shopee needs to review a new app. You need a Shopee Open Platform app of your own and the seller account of the shop.

  1. Sign in at open.shopee.com, complete the developer registration, then open Console → App List and create an app for your own shop (for example the Seller In House System type). Shopee reviews new apps before they can go live.
  2. On the app's edit page, set the Test Redirect URL Domain and the Live Redirect URL Domain to your AnythingMCP address: https://cloud.anythingmcp.com on AnythingMCP Cloud, or your own server address when self-hosted. Shopee refuses an authorization that comes back to another domain.
  3. Copy the app's Partner ID into SHOPEE_PARTNER_ID and its Partner Key into SHOPEE_PARTNER_KEY. Live and test apps have different keys: use the pair that matches the host.
  4. Set SHOPEE_HOST: https://partner.shopeemobile.com for live shops (Southeast Asia, Taiwan, Latin America and the other markets), https://openplatform.shopee.com.br if your app is served from Brazil, https://openplatform.shopee.cn for developers in China mainland, and https://openplatform.sandbox.test-stable.shopee.sg (or https://partner.test-stable.shopeemobile.com) with test keys and a sandbox test shop.
  5. Install the connector, open it and click Authorize with Provider. On Shopee, sign in with the shop account (a main or merchant account is refused), pick the shop and how long the authorization lasts, and confirm. Then run shopee_get_shop_info: it shows the shop, its region and status, and when the authorization expires.

Tokens renew themselves: the access token lasts about 4 hours and is renewed automatically. The refresh token behind it lasts about 30 days, so a connector that nobody uses for longer than that, or whose authorization was cancelled in Shopee Seller Centre, needs a new authorization. The connector shows this, its owner gets one email, and a click on Authorize with Provider fixes it.

Your Partner Key stays with AnythingMCP: every call is signed with it, and the key itself is never sent. A signature is valid for 5 minutes, so on a self-hosted server with a wrong clock Shopee answers error_sign.

What it reads: the shop and its public profile; your listings with name, SKU, category, status, price, stock, images, weight and logistics, plus sales, views, likes and ratings; the variations of a listing (colour, size and so on) with their own price and stock; orders with buyer, items, amounts, payment method, carrier, packages and address; the orders still waiting to be shipped; how an order can be handed over (pickup slots and drop-off points), tracking numbers and tracking history; your logistics channels; return and refund requests with reason, buyer photos and refund amount; what each order earns you after commission, fees, shipping and vouchers; your discount promotions; and your Shopee Ads balance and daily CPC ads figures (impressions, clicks, spend, orders, GMV and ROAS).

Time windows: Shopee lists orders and returns for windows of at most 15 days, so for a whole month the AI asks twice and adds up. Ads figures cover at most one month per call, within the last 6 months.

Switched off at install: shopee_update_stock and shopee_update_price. They change your live shop: stock is overwritten (it cannot go below what orders have already reserved), and a new price applies at once, while running promotions keep their own price. An administrator turns them on deliberately, and even then the AI shows you every listing or variation with the old and new figure and waits for your yes.

Nothing moves money: no tool ships, cancels, refunds, answers buyers or creates promotions. Arranging a shipment, handling a return and replying to buyers stay in Shopee Seller Centre.

Limits: Shopee limits calls per app. After error_rate_limit or a 429 the AI waits a minute before trying again. Ads tools need the Ads permission on your app.

Common errors: error_sign or invalid_partner_id means the Partner ID, Partner Key and host do not belong together, for example live keys on the sandbox host. error_permission means the app lacks the permission for that API. error_param means a parameter is wrong or a time window is too long. source_ip_undeclared means your app has an IP allowlist in the Console that does not include AnythingMCP's address.

The connector does not arrange shipments, cancel orders, handle returns or refunds, reply to buyers or chats, create discounts or ads, or upload new listings.

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

  1. Go to chatgpt.com/plugins, click +, then Add custom MCP server.
  2. Enter a name, e.g. Name: Shopee Seller.
  3. Under Connection, enter the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID and keep Authentication on OAuth.
  4. Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
  5. Install the new plugin from your personal plugins, then type @ in a chat and pick it.

Available tools

ToolWhat it does
shopee_get_shop_infoRead the authorized shop: shop_name, region, status (NORMAL, BANNED, FROZEN), whether it is cross-border (is_cb), auth_time and expire_time…
shopee_get_shop_profileRead the shop's public profile: name, logo, description and invoice issuer
shopee_list_itemsList the shop's listings (item ids with status and update_time), 100 per page at most
shopee_search_itemsSearch the shop's listings by name or SKU (an SKU match wins over a name match), or find listings missing attributes
shopee_get_itemsRead up to 50 listings by item id: name, SKU, category, status, price info, stock info (when the listing has no variations), images, weight…
shopee_get_items_extra_infoRead performance figures for up to 50 listings: sales, views, likes, rating_star and comment_count
shopee_get_item_modelsRead the variations (models) of one listing: tier_variation (the option names, e.g. colour and size) and each model with model_id…
shopee_update_stockSet the seller stock of a listing or of its models (up to 50 entries)
shopee_update_priceSet the original price of a listing or of its models (up to 50 entries), in the shop's currency
shopee_list_ordersList orders created (or updated) in a time window of at most 15 days, newest first, up to 100 per page
shopee_get_order_detailsRead up to 50 orders: status, buyer, items, amounts, payment method, shipping carrier, packages, recipient address and cancellation details
shopee_list_orders_to_shipList the orders waiting to be shipped (status READY_TO_SHIP with a shipping document to arrange), up to 100 per page
shopee_get_shipping_parameterRead how an order can be handed over: info_needed per method, the pickup addresses and time slots, and the drop-off branches
shopee_get_tracking_numberRead the tracking number of a shipped order (available once the shipment is arranged), optionally with first and last mile numbers
shopee_get_tracking_infoRead the logistics status and the tracking history (time, description) of an order or one of its packages
shopee_list_logistics_channelsList the shop's logistics channels: id, name, whether each is enabled, fee type, size and weight limits
shopee_list_returnsList return and refund requests, newest first, up to 100 per page, optionally within a creation or update window of at most 15 days
shopee_get_returnRead one return request: reason, buyer text and images, items, refund amount, status, due dates and the linked order_sn
shopee_get_order_incomeRead what an order earns the seller (escrow detail): buyer payment, Shopee commission and service fees, shipping fee and rebates, vouchers…
shopee_list_discountsList the shop's discount promotions by status, with discount_id, name, start and end time
shopee_get_ads_balanceRead the shop's current Shopee Ads credit balance
shopee_get_ads_daily_performanceRead the daily performance of all the shop's CPC ads: impressions, clicks, CTR, expense, orders, GMV and ROAS (direct and broad)

Example prompts

  • "Which orders are waiting to be shipped right now, and which carrier does each one use?"
  • "How much did I actually earn from my orders last week after Shopee commission, fees and vouchers?"
  • "Which listings sold best this month, and which of them are almost out of stock?"
  • "Show me the open return requests with the reason and the refund amount for each."
  • "How did my Shopee Ads do in the last 14 days: spend, orders and ROAS per day?"

FAQ

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?

Your Shopee Seller agent is one click away.

Install the connector, paste the key, prompt ChatGPT. Free for 7 days, no credit card.

Related guides

Connectors

How to Connect Shopee Seller to Claude via MCP

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

Connectors

How to Connect Shopee Seller to Cursor via MCP

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

Connectors

How to Connect Shopee Seller to Gemini via MCP

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

Connectors

How to Connect Shopee Seller to Meta Muse via MCP

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

Connectors

Shopee Seller to MCP: Orders, Listings, Returns and Ads of Your Shopee Shop in any AI Agent

Let your AI work with your Shopee shop: listings and variations, orders, shipping and tracking, returns, order income, discounts and Ads figures, with stock and price updates available on request.

Connectors

How to Connect Avito to ChatGPT via MCP

Let your AI work with your Avito business account: list your ads and change their prices, read views, contacts and calls statistics, check autoload uploads and their errors, the feed format and your wallet, and read Avito Messenger chats. Sending messages and changing autoload settings are optional and off by default.