mcpField
C
Coupang Wing

Coupang Wing

Local
appmonster.co.krBusiness & Marketing0Updated 6d ago
RepositoryVisit website

About Coupang Wing

Coupang Wing is an Open API MCP server for Coupang sellers. It lets AI agents inspect products and orders, change item stock or prices, and acknowledge paid orders; writes can require human approval.

Key features

  1. 01Paginate and filter product listings
  2. 02View product details and options
  3. 03Change item stock and prices
  4. 04List orders by date and status
  5. 05Mark paid orders as preparing

Use cases

  1. 01Review product options and shipping dates
  2. 02Adjust item stock or prices
  3. 03Filter and verify orders
  4. 04Acknowledge paid orders before fulfillment

MCP support

It exposes Coupang Wing Open API product, order, and write operations as MCP tools; writes can use confirmation tokens or OK Agent approval.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "groove79-mcp-coupang": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-coupang"
      ],
      "env": {
        "COUPANG_ACCESS_KEY": "<COUPANG_ACCESS_KEY>",
        "COUPANG_SECRET_KEY": "<COUPANG_SECRET_KEY>",
        "COUPANG_VENDOR_ID": "<COUPANG_VENDOR_ID>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>",
        "KMCP_WRITE_MODE": "<KMCP_WRITE_MODE>"
      }
    }
  }
}
Run commandnpx -y @appmonster/mcp-coupang
Environment variables to set
COUPANG_ACCESS_KEYSecretWing Open API access key
COUPANG_SECRET_KEYSecretWing Open API secret key
COUPANG_VENDOR_IDSeller vendor id, e.g. A00012345
OKAGENT_API_KEYSecretOK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.
KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@appmonster/mcp-coupang0.2.0

Tools

7

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
statusenumNoIN_REVIEW | SAVED | APPROVING | APPROVED | PARTIAL_APPROVED | DENIED | DELETED
createdAtstringNoRegistered on this day, yyyy-MM-dd
nextTokenstringNoFrom the previous response; omit for the first page
maxPerPageintegerNo
sellerProductNamestringNoName search, ≤20 chars

Details

From the project 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:
{
  "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:

"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

pnpm --filter @appmonster/mcp-coupang test

Tests use an injected fetch; no real network.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.