Delivery Tracking (Korea)

io.github.groove79Published by GitHub account groove79v0.1.0Updated Oct 30, 2026

Parcel tracking for Korean and global carriers (CJ, 우체국, 한진, 롯데, 로젠, 쿠팡, Yamato, DHL…). 택배 조회 MCP.

VerifiedSTDIODesktop onlyLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant look up parcel delivery status and event history for Korean and global carriers via Delivery Tracker.

What you can do
  • Track a single parcel by carrier name or id, returning current status, last event and full event history in KST
  • Track up to 20 parcels in one call with per-parcel status, summary counts and your own reference echoed back
  • List supported carriers with ids and built-in Korean/Japanese aliases, optionally filtered by text
When to use it
Useful when an assistant should answer questions about where an order is, check a batch of shipments sent today, or flag parcels that need attention, especially for Korean carriers such as CJ, 우체국, 한진, 롯데, 로젠 or 쿠팡.
Requirements
Runs locally over stdio, typically via npx with the npm package. Needs a Delivery Tracker account and the environment variables DELIVERY_TRACKER_CLIENT_ID and DELIVERY_TRACKER_CLIENT_SECRET from console.tracker.delivery, plus network access to the Delivery Tracker API. Desktop client only.
Before you install
Requires a client secret (DELIVERY_TRACKER_CLIENT_SECRET) that is shown only once; keep it out of shared configs. Free-plan credentials expire every 21 days and must be recreated. Tracking data is sent to the third-party Delivery Tracker service. The server is described as read-only, but tracking numbers and references you pass are shared with that service.

Installation

In SourceWeft

  1. Open Delivery Tracking (Korea) 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-delivery

MCP server for parcel tracking — Korean carriers (CJ대한통운, 우체국, 한진, 롯데, 로젠, 경동, 쿠팡, 편의점택배…) and global ones (Yamato, Sagawa, Japan Post, DHL, UPS, FedEx, USPS, EMS) through Delivery Tracker. Read-only. Korean carrier names work directly.

택배 조회 MCP 서버 — "이 주문 어디쯤이야?", "오늘 발송분 중 아직 안 간 거?"를 에이전트가 답합니다.

Tools

ToolWhat it does
delivery_track_parcelone parcel → status (접수/집화/이동중/배송출발/배송완료/실패/수령대기/이상), delivered, needsAttention, last event, event history (KST)
delivery_track_manyup to 20 parcels → per-parcel status + counts (delivered / in transit / needs attention); errors isolated per parcel; your ref echoed back
delivery_list_carrierssupported carriers (id + name) with the built-in aliases

Carrier can be a name (CJ대한통운, 우체국, 한진, 야마토, DHL) or an id (kr.cjlogistics). Unknown names fall back to a live search.

Setup (1 minute, free)

  1. https://console.tracker.delivery → sign in (Google/email) → Create Project → Credentials → Create → copy Client ID / Client Secret (the secret is shown once).
  2. Claude Desktop / Cursor:
json
{ "mcpServers": { "delivery": { "command": "npx", "args": ["-y", "@appmonster/mcp-delivery"],  "env": { "DELIVERY_TRACKER_CLIENT_ID": "…", "DELIVERY_TRACKER_CLIENT_SECRET": "…" } } } }

Example prompts

  • "CJ 1234-5678-9012 지금 어디야?" → delivery_track_parcel
  • "어제 발송한 스마트스토어 주문 전부 배송 상태 확인해줘" → naver_list_orders → delivery_track_many (ref = 주문번호)
  • "배송 이상 있는 건만 골라서 고객한테 보낼 문자 초안 써줘" → delivery_track_many → filter needsAttention

Notes

  • Free plan credentials expire every 21 days — the console shows the expiration; create a new pair before then (our nightly canary flags it as AUTH when it lapses). Paid plans get lifetime credentials.
  • Delivery Tracker answers in < 1 s typically; this client gives up after 15 s with a TIMEOUT error instead of hanging the agent.
  • Brand-new labels can take a few hours before the carrier reports anything (NOT_FOUND with a hint).
  • Times are converted to KST (+09:00).

MIT © Appmonster

Source: packages/delivery/README.md at commit f703332

Tools

3

delivery_track_parcel

Track one parcel: current status (접수/집화/이동중/배송출발/배송완료/배송실패/수령대기/이상), last event, full event history with KST times. Carrier can be a Korean or English name (CJ대한통운, 우체국, 한진, 롯데, 로젠, 쿠팡, 야마토, DHL…) or a Delivery Tracker id like kr.cjlogistics. 운송장 1건을 조회합니다. Use for '이 주문 어디쯤이야?' or to confirm delivery before a settlement/CS reply. Needs carrier + trackingNumber; DELIVERY_TRACKER_CLIENT_ID/SECRET env.

ParameterscarrierrequiredmaxEventstrackingNumberrequired

delivery_track_many

Track up to 20 parcels in one call and get a compact table: status per parcel plus counts of delivered / in transit / needs attention. Each item may carry your own reference (orderId) that is echoed back. 여러 운송장을 한 번에 조회합니다. Use after naver_list_orders / coupang_list_orders to answer '오늘 발송분 어디쯤?' or to find stuck parcels. Needs parcels[] of {carrier, trackingNumber, ref?}.

Parametersparcelsrequired

delivery_list_carriers

List carriers Delivery Tracker supports (id + name), optionally filtered by text, plus the built-in Korean/Japanese aliases this server understands. 지원 택배사 목록을 조회합니다. Use when a carrier name is ambiguous or to get the id for delivery_track_parcel. Needs nothing; optional searchText.

ParametersfirstsearchTextcountryCode

Version history

1
  1. v0.1.0LatestOct 22, 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