Coupang Wing

io.github.groove79Published by GitHub account groove79v0.2.0Updated Oct 29, 2026

Coupang Wing seller MCP: products, item stock/price, order sheets, ship confirmation. 쿠팡 윙 MCP.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Coupang Wing seller MCP server that lets an assistant list products and orders, change item stock and price, and acknowledge paid orders.

What you can do
  • List and read products: paged product list with name/status filters, plus product detail with options (vendorItemId, prices, shipping lead time)
  • Change item stock and price: set an option's sellable quantity (0 marks sold out) or its sale price in KRW
  • List and read order sheets: orders by date range and status (paid, preparing, shipped, and later stages), and a single order with the latest receiver address
  • Acknowledge paid orders: move up to 50 orders from paid to preparing, with per-id results
When to use it
For Coupang sellers who want an assistant to check their catalog and incoming orders, adjust option stock or prices, and process paid orders into preparation without opening Wing manually.
Requirements
Runs locally via npx as a stdio process. Needs a Coupang Wing Open API access key, secret key and vendor id (COUPANG_ACCESS_KEY, COUPANG_SECRET_KEY, COUPANG_VENDOR_ID), issued from the seller's Wing account. A correct system clock in UTC is needed for request signing. Optional OKAGENT_API_KEY and APPROVAL_TIMEOUT_SEC enable KakaoTalk approvals.
Before you install
Three write tools change live seller data: stock quantity, sale price, and order acknowledgement, which the README calls irreversible from the API. Price changes beyond Coupang's allowed ratio are rejected unless forced. Writes ask for confirmation by default, but KMCP_WRITE_MODE=direct disables that check. The server holds seller API credentials and, if used, an OK Agent key; order data includes customer delivery addresses.

Installation

In SourceWeft

  1. Open Coupang Wing in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@appmonster/mcp-coupang

MCP server for the Coupang Wing Open API (쿠팡 판매자). Lets an AI agent read products and orders, change item stock/price, and acknowledge paid orders — with every write optionally gated by a human approval (OK Agent).

쿠팡 윙 오픈API용 MCP 서버. 상품·발주서 조회, 옵션 재고/가격 변경, 상품준비중 처리.

Tools

ToolAccessWhat it does
coupang_list_productsread등록 상품 목록 (이름/상태 필터, nextToken 페이징)
coupang_get_productread상품 상세 + 옵션(vendorItemId, 가격, 출고일)
coupang_update_item_quantitywrite옵션 재고 수량 변경 (0 = 품절)
coupang_update_item_pricewrite옵션 판매가 변경
coupang_list_ordersread기간·상태별 발주서 (ACCEPT/INSTRUCT/DEPARTURE/…), 최대 31일
coupang_get_orderread발주서 단건 — 배송 직전 주소 재확인용
coupang_confirm_orderswrite결제완료 → 상품준비중 (최대 50건, 건별 결과)

Setup

  1. Wing → 판매자정보 → 추가판매정보 → OPEN API 키 발급. Access key, Secret key, 그리고 업체코드(A00012345 형태)를 받습니다.
  2. MCP client config:
json
{  "mcpServers": {    "coupang": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-coupang"],      "env": {        "COUPANG_ACCESS_KEY": "…",        "COUPANG_SECRET_KEY": "…",        "COUPANG_VENDOR_ID": "A00012345"      }    }  }}

Human approval for writes (optional, recommended)

Every write tool asks before it runs. By default the agent shows you a preview in the chat and re-calls with a confirm_token once you agree. Add an OK Agent key (free, 200/month) to approve on KakaoTalk instead:

json
"OKAGENT_API_KEY": "ok_…","APPROVAL_TIMEOUT_SEC": "300"

KMCP_WRITE_MODE=direct turns the check off for scripts you fully trust.

Notes

  • Auth is Coupang's CEA HMAC-SHA256 header; the server signs the exact bytes it sends (query string included), so no clock-skew tricks are needed beyond a correct system clock (UTC).
  • Coupang returns HTTP 200 with code: "ERROR" for many business failures — those surface as tool errors with Coupang's message.
  • Order date range is limited to 31 days per call; coupang_list_orders defaults to the last 7 days (KST).
  • Customers can change the delivery address after paying. Call coupang_get_order right before printing a label.

Development

bash
pnpm --filter @appmonster/mcp-coupang test

Tests use an injected fetch; no real network.

Source: packages/coupang/README.md at commit 53af4ba

Tools

7

coupang_list_products

List the seller's registered products on Coupang (paged). 쿠팡 윙에 등록된 상품 목록을 조회합니다. Use first to find sellerProductId before reading details or changing stock/price. Needs nothing; optional name/status filter and nextToken for the next page.

ParametersstatuscreatedAtnextTokenmaxPerPagesellerProductName

coupang_get_product

Get one Coupang product with all its items (options): vendorItemId, name, prices, max buy count, shipping lead time. 상품 상세와 옵션(아이템) 목록을 조회합니다. Use to find the vendorItemId that stock/price changes need. Needs sellerProductId.

ParameterssellerProductIdrequired

coupang_update_item_quantity

Set the sellable quantity of one Coupang item (option). 0 marks it sold out. 옵션(아이템) 재고 수량을 변경합니다. Use after confirming vendorItemId with coupang_get_product. Needs vendorItemId and the new quantity (absolute, not delta).

ParametersquantityrequiredvendorItemIdrequiredconfirm_token

coupang_update_item_price

Change the sale price of one Coupang item (option), in KRW. 옵션(아이템) 판매가를 변경합니다. Coupang rejects changes beyond its allowed ratio from the current price unless forceSalePriceUpdate is true. Needs vendorItemId and the new price.

ParameterspricerequiredvendorItemIdrequiredconfirm_tokenforceSalePriceUpdate

coupang_list_orders

List Coupang order sheets (발주서) in a date range by status: ACCEPT=paid, INSTRUCT=preparing, DEPARTURE=shipped, DELIVERING, FINAL_DELIVERY, NONE_TRACKING. Max 31 days per call, 50 per page. 기간·상태별 발주서 목록을 조회합니다. Use to see new paid orders to prepare, or shipments to track. Needs status; dates default to the last 7 days (KST).

ParameterstofromstatusnextTokenmaxPerPage

coupang_get_order

Get one Coupang order sheet by shipmentBoxId, with the latest receiver address (customers can change it after paying). 발주서 단건을 조회합니다. Use right before shipping to confirm the address, or after coupang_confirm_orders. Needs shipmentBoxId.

ParametersshipmentBoxIdrequired

coupang_confirm_orders

Acknowledge paid Coupang orders — moves them from ACCEPT (결제완료) to INSTRUCT (상품준비중). Up to 50 shipmentBoxIds per call; partial failures are reported per id. 발주서를 상품준비중으로 처리합니다. Use after reviewing new orders with coupang_list_orders. Needs shipmentBoxIds. Irreversible from the API.

Parametersconfirm_tokenshipmentBoxIdsrequired

Version history

2
  1. v0.2.0LatestOct 23, 2026
  2. v0.1.0Oct 21, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts