apick-mcp 3.2.1 → 3.3.0

package/CHANGELOG.md

@@ -1,4 +1,18 @@
-# 변경 기록
+# 변경 기록
+
+## 3.3.0 — 2026-09-14
+
+- Seedance 참조 소재의 이미지·영상·오디오 파일 인자를 문서화했습니다.
+- Add video generation version selection documentation and compatibility tests.
+- 영상 생성 버전 선택, 버전별 옵션·요금 안내와 호환 검증을 추가했습니다.
+- Pass version and tier through the existing bridge; no transport change.
+- Document and verify Seedance 2.0 Fast and Mini tier pass-through.
+
+## 3.2.2 - 2026-09-14
+
+- 운전면허 `ghost_num`의 생략·빈값·임의 문자열 허용과 판정 미사용 계약을 한영 문서에 명시했습니다.
+- 운전면허 불일치와 무과금 처리 실패를 구분하고, 응답에 조회 페이지 HTML을 포함하지 않는 계약을 안내합니다.
+- Clarify optional driver-license serial input, match semantics, safe messages, and uncharged processing failures.
 
 ## 3.2.1 - 2026-09-14
 

package/README.md

@@ -267,7 +267,9 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
 `veo_jobs_create` → `veo_jobs_status`
 
 Video generation (`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`) is asynchronous — submit a job, poll status, then download once it's `completed` via the status result's `result_url`. Billed per second (`duration × per-second points`), refunded in full on failure or timeout.
-영상 생성(`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`)은 비동기입니다 — 접수 후 상태를 조회하다가 `completed`가 되면 상태 결과의 `result_url`로 다운로드합니다. 초당 포인트 × 길이(초)로 과금되며 실패·시간 초과 시 전액 환불됩니다.
+영상 생성(`seedance_jobs_create`, `veo_jobs_create`, `kling_jobs_create`)은 비동기입니다 — 접수 후 상태를 조회하다가 `completed`가 되면 상태 결과의 `result_url`로 다운로드합니다. 초당 포인트 × 길이(초)로 과금되며 실패·시간 초과 시 전액 환불됩니다.
+
+Seedance 참조 소재 모드는 지원 버전에서 참조 이미지·영상·오디오(MP3·WAV) URL을 함께 받을 수 있습니다.
 
 ---
 
@@ -402,3 +404,21 @@ MIT — [LICENSE](LICENSE) 참고. 이 저장소(문서와 stdio 브릿지)에
 `tts_jobs_retry` takes `job_id`, `utterance_ids` (such as `["u002"]`), and `idempotency_key`. Reuse the same key and IDs after a lost response. Technical recovery does not add a charge. This tool changes job state (`readOnlyHint: false`).
 
 `tts_jobs_quality`는 작업 ID로 발화 검수와 후보 이력을 조회합니다. `tts_jobs_candidate_audio`는 작업 ID·후보 ID로 WAV를 조회하며 최종 다운로드를 소비하지 않습니다. 후보는 종료 후 72시간 보존됩니다. `tts_jobs_retry`는 발화 ID 목록과 멱등 키로 같은 작업을 추가 과금 없이 재개합니다. 응답 단절 시 동일한 키와 목록을 재사용하세요.
+
+## Video model versions
+
+Omitting `version` preserves Seedance 2.5, Veo 3.1 and Kling 3.0. Set `version` and `tier` explicitly to select a generation; jobs are never silently switched to another version. Submission and status responses include `version`.
+
+Available generations: Seedance 1.0/1.5/2.0/2.5, including Seedance 2.0 Standard/Fast/Mini; Veo 3.1 (Standard/Fast/Lite); Kling 1.6/2.0/2.1/2.5/2.6/3.0/O1/O3. Veo 3.0 is unavailable. Modes, tiers, resolutions, durations, audio, file limits and prices vary by combination. See the [Seedance](https://apick.app/dev_guide/seedancejobs), [Veo](https://apick.app/dev_guide/veojobs) and [Kling](https://apick.app/dev_guide/klingjobs) version tables. Unsupported combinations are rejected before submission.
+
+## 영상 모델 버전 선택
+
+`version`을 생략하면 Seedance 2.5, Veo 3.1, Kling 3.0을 사용합니다. 버전과 등급을 명시하면 해당 조합으로 생성하며 다른 모델로 자동 대체하지 않습니다. 생성과 상태 응답의 `version`으로 확인할 수 있습니다.
+
+| 제품 | 제공 버전 | 제약과 요금 |
+|---|---|---|
+| Seedance | 2.5, 2.0(Standard·Fast·Mini), 1.5, 1.0 | [버전별 지원표](https://apick.app/dev_guide/seedancejobs) |
+| Veo | 3.1 (Standard, Fast, Lite) | [버전별 지원표](https://apick.app/dev_guide/veojobs) |
+| Kling | 3.0, O3, O1, 2.6, 2.5, 2.1, 2.0, 1.6 | [버전별 지원표](https://apick.app/dev_guide/klingjobs) |
+
+등급·해상도·길이·오디오·파일 개수와 초당 포인트는 선택 조합별로 다릅니다. Seedance 2.0은 Standard·Fast·Mini를 제공하며 Mini는 480p·720p와 4~15초를 지원합니다. 무음 전용 모델은 `audio=false`, 오디오 필수 모델은 `audio=true`만 허용합니다. Veo 3.0은 현재 제공하지 않습니다. 지원하지 않는 조합은 접수 전에 거절됩니다.

package/TOOLS.md

@@ -434,9 +434,13 @@ Verify the authenticity of a Korean resident registration card (jumin-deungnokje
 
 ### `identi_card2` — [Text] 운전면허증 진위 확인
 
-Verify the authenticity of a Korean driver license using text input.
+Check Korean driver license number and personal details. `ghost_num` is optional: omit it, send an empty string, or send any string. Its content is not used in the match decision. This tool does not verify the serial number itself or the physical document's authenticity.
 
-운전면허증의 기재 정보를 입력해 진위 여부를 확인합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 모두 필수이며, ghost_num(식별번호)과 rrn1, rrn2는 선택 입력입니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
+운전면허번호와 인적사항의 일치 여부를 조회합니다. birth_y, birth_m, birth_d, name과 면허번호 4구획(licen_no0~licen_no3)은 필수입니다. ghost_num(식별번호)은 생략·빈값·임의 문자열 모두 허용하며 전달값은 판정에 사용하지 않습니다. rrn1, rrn2도 선택 입력입니다. 암호일련번호 자체나 실물 면허증의 위·변조 여부는 검증하지 않습니다. 정보주체의 동의 등 적법한 처리 근거를 확보한 경우에만 사용하십시오.
+
+`result=0` means a mismatch and `result=1` means a match. An unconfirmed result returns HTTP 424 (`result=2`); a timeout returns HTTP 408 (`result=3`). These processing failures are not charged. Responses contain short public messages, never source-page HTML.
+
+`result=0`은 불일치, `result=1`은 일치입니다. 판정 확인 실패는 HTTP 424(`result=2`), 시간 초과는 HTTP 408(`result=3`)이며 과금되지 않습니다. 응답에는 짧은 안내 문구만 포함되고 조회 페이지 HTML은 포함되지 않습니다.
 
 > 읽기 전용 / read-only · 외부 데이터 조회 / external lookup · server `identity`
 
@@ -450,7 +454,7 @@ Verify the authenticity of a Korean driver license using text input.
 | `licen_no1` | `string` | **필수 / required** | 면허번호 2구획 (예: 19) |
 | `licen_no2` | `string` | **필수 / required** | 면허번호 3구획 (예: 174133) |
 | `licen_no3` | `string` | **필수 / required** | 면허번호 4구획 (예: 01) |
-| `ghost_num` | `string` | 선택 / optional | 식별번호 (면허증 우측 표기, 예: 8H1X3Y) |
+| `ghost_num` | `string` | 선택 / optional | 생략·빈값 허용, 전달값은 판정에 사용하지 않음 / May be omitted or empty; not used in the match decision |
 | `rrn1` | `string` | 선택 / optional | 주민등록번호 앞 6자리 (선택) |
 | `rrn2` | `string` | 선택 / optional | 주민등록번호 뒤 7자리 (선택) |
 
@@ -1837,34 +1841,81 @@ Polish a text (up to 100,000 characters) by fixing grammar, spelling, and awkwar
 
 <a id="seedance-jobs-create"></a>
 
-### `seedance_jobs_create` — Seedance 영상 작업 접수
-
-Submit an asynchronous Seedance video generation job combining text, image, or reference inputs into up to a 30-second video.
-
-Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `seedance_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(해상도별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
-
-> **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
-
-| Parameter | Type | Required | Description 설명 |
-| --- | --- | --- | --- |
-| `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
-| `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
-| `duration` | `integer` | 선택 / optional | 영상 길이(초), 4~30, 기본 5 |
-| `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` 중 하나, 기본 16:9 |
-| `resolution` | `string` | 선택 / optional | 해상도 — `480p`, `720p`, `1080p` 중 하나, 기본 720p. 해상도별로 초당 포인트가 다릅니다(요금 절 참고, 높을수록 비용 증가) |
-| `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true. 생성된 오디오가 정책(저작권 등) 검수에서 거부되면 작업이 실패하고 전액 환불됩니다 |
-| `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
-| `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_video_url` | `string` (file) | 선택 / optional | reference 모드에서 동작을 참조할 영상 URL — https URL, video/mp4, video/quicktime, video/webm, 최대 50MB |
-
-```json
-{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"seedance_jobs_create","arguments":{"prompt":"<prompt>"}}}
-```
-
+### `seedance_jobs_create` — Seedance 영상 작업 접수
+
+Submit an asynchronous Seedance video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Seedance 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, seedance_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 포인트(해상도별로 다름, resolution 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
+
+기본 버전 기준: 초당 480p 560P·720p 1,250P·1080p 2,810P × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `version` | `string` | 선택 / optional | 영상 모델 버전. 생략 시 2.5. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. `2.5`, `2.0`, `1.5`, `1.0` |
+| `prompt` | `string` | 필수 / required | 영상 생성 프롬프트, 최대 2,000자 |
+| `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text `text`, `image`, `reference` |
+| `duration` | `integer` | 선택 / optional | 영상 길이(초), 전체 버전 범위 2~30. 허용 값과 기본값은 버전·등급별로 다릅니다. |
+| `aspect_ratio` | `string` | 선택 / optional | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` |
+| `resolution` | `string` | 선택 / optional | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. `480p`, `720p`, `1080p` |
+| `audio` | `boolean` | 선택 / optional | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
+| `tier` | `string` | 선택 / optional | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. `standard`, `fast`, `mini`, `pro` |
+| `seed` | `integer` | 선택 / optional | 재현성을 위한 시드 값 |
+| `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
+| `image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL |
+| `last_image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) |
+| `reference_image_url` | `string (file)` | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL |
+| `reference_image_url_2` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(2번째) |
+| `reference_image_url_3` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(3번째) |
+| `reference_video_url` | `string (file)` | 선택 / optional | reference 모드에서 동작을 참조할 영상 URL |
+| `reference_image_url_4` | `string (file)` | 선택 / optional | 참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_5` | `string (file)` | 선택 / optional | 참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_6` | `string (file)` | 선택 / optional | 참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_7` | `string (file)` | 선택 / optional | 참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_8` | `string (file)` | 선택 / optional | 참조 이미지 URL(8번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_9` | `string (file)` | 선택 / optional | 참조 이미지 URL(9번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_10` | `string (file)` | 선택 / optional | 참조 이미지 URL(10번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_11` | `string (file)` | 선택 / optional | 참조 이미지 URL(11번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_12` | `string (file)` | 선택 / optional | 참조 이미지 URL(12번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_13` | `string (file)` | 선택 / optional | 참조 이미지 URL(13번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_14` | `string (file)` | 선택 / optional | 참조 이미지 URL(14번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_15` | `string (file)` | 선택 / optional | 참조 이미지 URL(15번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_16` | `string (file)` | 선택 / optional | 참조 이미지 URL(16번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_17` | `string (file)` | 선택 / optional | 참조 이미지 URL(17번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_18` | `string (file)` | 선택 / optional | 참조 이미지 URL(18번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_19` | `string (file)` | 선택 / optional | 참조 이미지 URL(19번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_20` | `string (file)` | 선택 / optional | 참조 이미지 URL(20번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_21` | `string (file)` | 선택 / optional | 참조 이미지 URL(21번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_22` | `string (file)` | 선택 / optional | 참조 이미지 URL(22번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_23` | `string (file)` | 선택 / optional | 참조 이미지 URL(23번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_24` | `string (file)` | 선택 / optional | 참조 이미지 URL(24번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_25` | `string (file)` | 선택 / optional | 참조 이미지 URL(25번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_26` | `string (file)` | 선택 / optional | 참조 이미지 URL(26번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_27` | `string (file)` | 선택 / optional | 참조 이미지 URL(27번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_28` | `string (file)` | 선택 / optional | 참조 이미지 URL(28번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_29` | `string (file)` | 선택 / optional | 참조 이미지 URL(29번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_30` | `string (file)` | 선택 / optional | 참조 이미지 URL(30번째). 버전별 최대 개수를 확인하세요. |
+| `reference_video_url_2` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_3` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_4` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_5` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_6` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_7` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_8` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_9` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_10` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_2` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_3` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_4` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_5` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_6` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_7` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_8` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_9` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_audio_url_10` | `string (file)` | 선택 / optional | 참조 오디오 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+
+```json
+{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"seedance_jobs_create","arguments":{"prompt":"A red sports car racing through a rainy city","version":"2.0","tier":"mini","duration":4,"resolution":"480p"}}}
+```
+
 <a id="seedance-jobs-status"></a>
 
 ### `seedance_jobs_status` — Seedance 영상 작업 상태
@@ -1885,36 +1936,35 @@ Seedance 영상 작업의 진행 상태를 조회합니다. 완료되면 응답
 
 <a id="veo-jobs-create"></a>
 
-### `veo_jobs_create` — Veo 영상 작업 접수
-
-Submit an asynchronous Veo video generation job combining text, image, or reference images into a 4/6/8-second high-quality video.
-
-Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `veo_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(등급별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
-
-> **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
-
-| Parameter | Type | Required | Description 설명 |
-| --- | --- | --- | --- |
-| `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
-| `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지로 주체 지정). 기본 text |
-| `duration` | `integer` | 선택 / optional | 영상 길이(초). 4, 6, 8 중 하나만 허용, 기본 8 |
-| `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `9:16` 중 하나, 기본 16:9 |
-| `resolution` | `string` | 선택 / optional | 해상도 — `720p`, `1080p`, `4k` 중 하나, 기본 720p |
-| `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true |
-| `tier` | `string` | 선택 / optional | 품질/속도 등급 — `standard`, `fast` 중 하나, 기본 standard |
-| `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
-| `seed` | `integer` | 선택 / optional | 재현성을 위한 시드 값 |
-| `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
-| `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-| `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 50MB |
-
-```json
-{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"veo_jobs_create","arguments":{"prompt":"<prompt>"}}}
-```
-
+### `veo_jobs_create` — Veo 영상 작업 접수
+
+Submit an asynchronous Veo video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Veo 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, veo_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 900포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
+
+기본 버전 기준: 초당 900포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `version` | `string` | 선택 / optional | 영상 모델 버전. 생략 시 3.1. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. `3.1` |
+| `prompt` | `string` | 필수 / required | 영상 생성 프롬프트, 최대 2,000자 |
+| `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text `text`, `image`, `reference` |
+| `duration` | `integer` | 선택 / optional | 영상 길이(초), 전체 버전 범위 4~8. 허용 값과 기본값은 버전·등급별로 다릅니다. |
+| `aspect_ratio` | `string` | 선택 / optional | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. `16:9`, `9:16` |
+| `resolution` | `string` | 선택 / optional | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. `720p`, `1080p`, `4k` |
+| `audio` | `boolean` | 선택 / optional | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
+| `tier` | `string` | 선택 / optional | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. `standard`, `fast`, `lite` |
+| `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
+| `seed` | `integer` | 선택 / optional | 재현성을 위한 시드 값 |
+| `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
+| `image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL |
+| `last_image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) |
+| `reference_image_url` | `string (file)` | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL |
+| `reference_image_url_2` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(2번째) |
+| `reference_image_url_3` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(3번째) |
+
+```json
+{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"veo_jobs_create","arguments":{"prompt":"A boat crossing the sea","version":"3.1"}}}
+```
+
 <a id="veo-jobs-status"></a>
 
 ### `veo_jobs_status` — Veo 영상 작업 상태
@@ -1935,36 +1985,43 @@ Veo 영상 작업의 진행 상태를 조회합니다. 완료되면 응답의 `r
 
 <a id="kling-jobs-create"></a>
 
-### `kling_jobs_create` — Kling 영상 작업 접수
-
-Submit an asynchronous Kling video generation job combining text, image, or reference subjects into a 3-15 second video.
-
-Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, `kling_jobs_status` Tool로 상태를 조회하고 완료되면 응답의 `result_url`(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 `duration × 초당 포인트`(등급별 단가는 요금 절 참고)가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
-
-> **부작용 있음 / has side effects** · 외부 데이터 조회 / external lookup · server `ai`
-
-| Parameter | Type | Required | Description 설명 |
-| --- | --- | --- | --- |
-| `prompt` | `string` | **필수 / required** | 영상 생성 프롬프트, 최대 2,000자 |
-| `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text |
-| `duration` | `integer` | 선택 / optional | 영상 길이(초), 3~15, 기본 5 |
-| `aspect_ratio` | `string` | 선택 / optional | 가로세로 비율 — `16:9`, `9:16`, `1:1` 중 하나, 기본 16:9 |
-| `resolution` | `string` | 선택 / optional | image 모드 전용 해상도(다른 모드에서는 지원하지 않음) — `720P`, `1080P-SR`, `1440P-SR`, `1080P` 중 tier별 허용 목록에서 선택, 기본은 std=720P·pro=1080P |
-| `audio` | `boolean` | 선택 / optional | 오디오 생성 여부, 기본 true |
-| `tier` | `string` | 선택 / optional | 품질/속도 등급 — `std`, `pro` 중 하나, 기본 std |
-| `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
-| `cfg_scale` | `number` | 선택 / optional | 프롬프트 반영 강도(0~1), 기본 0.5 |
-| `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
-| `image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
-| `last_image_url` | `string` (file) | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
-| `reference_image_url` | `string` (file) | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
-| `reference_image_url_2` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(2번째) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
-| `reference_image_url_3` | `string` (file) | 선택 / optional | reference 모드 참조 이미지 URL(3번째) — https URL, image/png, image/jpeg, image/webp, 최대 10MB |
-
-```json
-{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kling_jobs_create","arguments":{"prompt":"<prompt>"}}}
-```
-
+### `kling_jobs_create` — Kling 영상 작업 접수
+
+Submit an asynchronous Kling video generation job. Select version and tier; supported modes, durations and prices depend on the selected version. Kling 영상 생성 작업을 비동기로 접수합니다. text/image/reference 세 가지 mode를 지원하며, kling_jobs_status Tool로 상태를 조회하고 완료되면 응답의 result_url(REST 다운로드 주소, 7일 이내 유효)로 다운로드합니다. 접수 시 duration × 초당 410포인트가 예약 차감되고 완료 시 확정, 실패·시간 초과 시 전액 환불됩니다.
+
+기본 버전 기준: 초당 410포인트 × duration(초). 다른 버전은 개발가이드의 버전별 요금표 참고.
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `version` | `string` | 선택 / optional | 영상 모델 버전. 생략 시 3.0. 등급·해상도·길이·오디오·파일 제약과 요금은 선택 버전별 개발가이드 표를 확인하세요. `3.0`, `o3`, `o1`, `2.6`, `2.5`, `2.1`, `2.0`, `1.6` |
+| `prompt` | `string` | 필수 / required | 영상 생성 프롬프트, 최대 2,000자 |
+| `mode` | `string` | 선택 / optional | 입력 방식 — 'text'(텍스트만) \| 'image'(첫 프레임 이미지 지정) \| 'reference'(참조 이미지·영상으로 주체 지정). 기본 text `text`, `image`, `reference` |
+| `duration` | `integer` | 선택 / optional | 영상 길이(초), 전체 버전 범위 3~15. 허용 값과 기본값은 버전·등급별로 다릅니다. |
+| `aspect_ratio` | `string` | 선택 / optional | 출력 화면 비율. 선택 버전·등급·모드에서 허용하는 값만 사용하세요. `16:9`, `9:16`, `1:1` |
+| `resolution` | `string` | 선택 / optional | 출력 해상도. 전체 버전의 값 목록이며 허용 조합·기본값·요금은 버전별 개발가이드를 따릅니다. `720p`, `1080p`, `720P`, `1080P-SR`, `1440P-SR`, `1080P` |
+| `audio` | `boolean` | 선택 / optional | 오디오 생성 여부. 선택 가능한 버전은 기본 true, 무음 전용 버전은 false, 오디오 필수 버전은 true만 허용합니다. |
+| `tier` | `string` | 선택 / optional | 품질·속도 등급. 지원 등급과 생략 시 기본값은 version과 mode에 따라 다릅니다. `std`, `pro`, `turbo`, `4k`, `standard`, `master` |
+| `negative_prompt` | `string` | 선택 / optional | 제외할 요소를 설명하는 텍스트 |
+| `cfg_scale` | `number` | 선택 / optional | 프롬프트 반영 강도(0~1), 기본 0.5 |
+| `idempotency_key` | `string` | 선택 / optional | 같은 요청의 재전송으로 인한 중복 접수·과금을 막는 고유 키 |
+| `image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 첫 프레임 이미지 URL |
+| `last_image_url` | `string (file)` | 선택 / optional | image 모드에서 사용할 마지막 프레임 이미지 URL(선택) |
+| `reference_image_url` | `string (file)` | 선택 / optional | reference 모드에서 주체를 지정할 참조 이미지 URL |
+| `reference_image_url_2` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(2번째) |
+| `reference_image_url_3` | `string (file)` | 선택 / optional | reference 모드 참조 이미지 URL(3번째) |
+| `reference_image_url_4` | `string (file)` | 선택 / optional | 참조 이미지 URL(4번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_5` | `string (file)` | 선택 / optional | 참조 이미지 URL(5번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_6` | `string (file)` | 선택 / optional | 참조 이미지 URL(6번째). 버전별 최대 개수를 확인하세요. |
+| `reference_image_url_7` | `string (file)` | 선택 / optional | 참조 이미지 URL(7번째). 버전별 최대 개수를 확인하세요. |
+| `reference_video_url` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_2` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_3` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+| `reference_video_url_4` | `string (file)` | 선택 / optional | 참조 영상 URL. 지원 버전과 개수 제한은 개발가이드를 확인하세요. |
+
+```json
+{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"kling_jobs_create","arguments":{"prompt":"A boat crossing the sea","version":"3.0"}}}
+```
+
 <a id="kling-jobs-status"></a>
 
 ### `kling_jobs_status` — Kling 영상 작업 상태
@@ -2015,3 +2072,21 @@ Video generation is billed per second of output (`duration × per-second points`
 `tts_jobs_retry` takes `job_id`, `utterance_ids` (such as `["u002"]`), and `idempotency_key`. Reuse the same key and IDs after a lost response. Technical recovery does not add a charge. This tool changes job state (`readOnlyHint: false`).
 
 `tts_jobs_quality`는 작업 ID로 발화 검수와 후보 이력을 조회합니다. `tts_jobs_candidate_audio`는 작업 ID·후보 ID로 WAV를 조회하며 최종 다운로드를 소비하지 않습니다. 후보는 종료 후 72시간 보존됩니다. `tts_jobs_retry`는 발화 ID 목록과 멱등 키로 같은 작업을 추가 과금 없이 재개합니다. 응답 단절 시 동일한 키와 목록을 재사용하세요.
+
+## Video model versions
+
+Omitting `version` preserves Seedance 2.5, Veo 3.1 and Kling 3.0. Set `version` and `tier` explicitly to select a generation; jobs are never silently switched to another version. Submission and status responses include `version`.
+
+Available generations: Seedance 1.0/1.5/2.0/2.5, including Seedance 2.0 Standard/Fast/Mini; Veo 3.1 (Standard/Fast/Lite); Kling 1.6/2.0/2.1/2.5/2.6/3.0/O1/O3. Veo 3.0 is unavailable. Seedance 2.0 Mini supports 480p/720p and 4–15 seconds. Modes, tiers, resolutions, durations, audio, file limits and prices vary by combination. See the [Seedance](https://apick.app/dev_guide/seedancejobs), [Veo](https://apick.app/dev_guide/veojobs) and [Kling](https://apick.app/dev_guide/klingjobs) version tables. Unsupported combinations are rejected before submission.
+
+## 영상 모델 버전 선택
+
+`version`을 생략하면 Seedance 2.5, Veo 3.1, Kling 3.0을 사용합니다. 버전과 등급을 명시하면 해당 조합으로 생성하며 다른 모델로 자동 대체하지 않습니다. 생성과 상태 응답의 `version`으로 확인할 수 있습니다.
+
+| 제품 | 제공 버전 | 제약과 요금 |
+|---|---|---|
+| Seedance | 2.5, 2.0(Standard·Fast·Mini), 1.5, 1.0 | [버전별 지원표](https://apick.app/dev_guide/seedancejobs) |
+| Veo | 3.1 (Standard, Fast, Lite) | [버전별 지원표](https://apick.app/dev_guide/veojobs) |
+| Kling | 3.0, O3, O1, 2.6, 2.5, 2.1, 2.0, 1.6 | [버전별 지원표](https://apick.app/dev_guide/klingjobs) |
+
+등급·해상도·길이·오디오·파일 개수와 초당 포인트는 선택 조합별로 다릅니다. Seedance 2.0은 Standard·Fast·Mini를 제공하며 Mini는 480p·720p와 4~15초를 지원합니다. 무음 전용 모델은 `audio=false`, 오디오 필수 모델은 `audio=true`만 허용합니다. Veo 3.0은 현재 제공하지 않습니다. 지원하지 않는 조합은 접수 전에 거절됩니다.

package/package.json

@@ -1,89 +1,89 @@
-{
-  "name": "apick-mcp",
-  "version": "3.2.1",
-  "description": "APICK MCP — 97 Korean data, AI, image & video tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·영상 생성·파일변환·검색·LLM.",
-  "type": "module",
-  "license": "MIT",
-  "author": "APICK",
-  "homepage": "https://apick.app/dev_guide/mcp",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lead788/apick-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/lead788/apick-mcp/issues"
-  },
-  "mcpName": "app.apick/all",
-  "bin": {
-    "apick-mcp": "src/index.js"
-  },
-  "exports": {
-    ".": "./src/bridge.js"
-  },
-  "files": [
-    "src",
-    "README.md",
-    "TOOLS.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "test": "node --test"
-  },
-  "keywords": [
-    "mcp",
-    "modelcontextprotocol",
-    "model-context-protocol",
-    "mcp-server",
-    "mcp-tools",
-    "claude",
-    "claude-code",
-    "claude-desktop",
-    "cursor",
-    "cline",
-    "windsurf",
-    "ai-agent",
-    "llm",
-    "apick",
-    "korea",
-    "korean",
-    "korea-api",
-    "business-registry",
-    "business-registration-number",
-    "identity-verification",
-    "kyc",
-    "kyb",
-    "id-card-verification",
-    "pii-masking",
-    "ocr",
-    "korean-ocr",
-    "parcel-tracking",
-    "delivery-tracking",
-    "shipment-tracking",
-    "bank-account-verification",
-    "account-holder-lookup",
-    "real-estate-price",
-    "address-search",
-    "holiday-api",
-    "whois",
-    "dns-lookup",
-    "ip-geolocation",
-    "web-scraping",
-    "screenshot-api",
-    "google-search",
-    "pdf-conversion",
-    "docx",
-    "excel",
-    "watermark",
-    "speech-to-text",
-    "face-detection",
-    "face-blur",
-    "nsfw-detection",
-    "image-similarity",
-    "image-generation",
-    "image-editing"
-  ]
-}
+{
+  "name": "apick-mcp",
+  "version": "3.3.0",
+  "description": "APICK MCP — 97 Korean data, AI, image & video tools for AI agents. 사업자조회·신분증·OCR·배송조회·이미지 생성·편집·영상 생성·파일변환·검색·LLM.",
+  "type": "module",
+  "license": "MIT",
+  "author": "APICK",
+  "homepage": "https://apick.app/dev_guide/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lead788/apick-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lead788/apick-mcp/issues"
+  },
+  "mcpName": "app.apick/all",
+  "bin": {
+    "apick-mcp": "src/index.js"
+  },
+  "exports": {
+    ".": "./src/bridge.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "TOOLS.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "model-context-protocol",
+    "mcp-server",
+    "mcp-tools",
+    "claude",
+    "claude-code",
+    "claude-desktop",
+    "cursor",
+    "cline",
+    "windsurf",
+    "ai-agent",
+    "llm",
+    "apick",
+    "korea",
+    "korean",
+    "korea-api",
+    "business-registry",
+    "business-registration-number",
+    "identity-verification",
+    "kyc",
+    "kyb",
+    "id-card-verification",
+    "pii-masking",
+    "ocr",
+    "korean-ocr",
+    "parcel-tracking",
+    "delivery-tracking",
+    "shipment-tracking",
+    "bank-account-verification",
+    "account-holder-lookup",
+    "real-estate-price",
+    "address-search",
+    "holiday-api",
+    "whois",
+    "dns-lookup",
+    "ip-geolocation",
+    "web-scraping",
+    "screenshot-api",
+    "google-search",
+    "pdf-conversion",
+    "docx",
+    "excel",
+    "watermark",
+    "speech-to-text",
+    "face-detection",
+    "face-blur",
+    "nsfw-detection",
+    "image-similarity",
+    "image-generation",
+    "image-editing"
+  ]
+}

package/src/index.js

@@ -1,92 +1,92 @@
-#!/usr/bin/env node
-// apick-mcp - run the APICK MCP server over stdio.
-//
-// Usage:
-//   apick-mcp [--server <name>]
-//
-// Environment:
-//   APICK_API_KEY     APICK license key. Optional: tools/list works without one,
-//                     tools/call needs it.
-//   APICK_MCP_SERVER  Which server to expose (default: all).
-//   APICK_MCP_URL     Base URL override (default: https://apick.app/mcp).
-
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { createBridge, DEFAULT_ENDPOINT, SERVERS } from './bridge.js';
-
-const HELP = `apick-mcp - APICK MCP server over stdio
-
-  apick-mcp [--server <name>]
-
-Options
-  --server, -s <name>  ${SERVERS.join(', ')}  (default: all)
-  --version, -v        print version
-  --help, -h           print this message
-
-Environment
-  APICK_API_KEY        APICK license key (get one at https://apick.app)
-  APICK_MCP_SERVER     same as --server
-  APICK_MCP_URL        base URL override (default: ${DEFAULT_ENDPOINT})
-
-Clients that support remote MCP can skip this bridge and connect straight to
-${DEFAULT_ENDPOINT}/all with an Authorization: Bearer header.
-Docs: https://apick.app/dev_guide/mcp
-`;
-
-function parseArgs(argv) {
-	const args = { server: process.env.APICK_MCP_SERVER || 'all' };
-	for (let i = 0; i < argv.length; i++) {
-		const arg = argv[i];
-		if (arg === '--help' || arg === '-h') args.help = true;
-		else if (arg === '--version' || arg === '-v') args.version = true;
-		else if (arg === '--server' || arg === '-s') args.server = argv[++i];
-		else if (arg.startsWith('--server=')) args.server = arg.slice('--server='.length);
-		else args.unknown = arg;
-	}
-	return args;
-}
-
-async function main() {
-	const args = parseArgs(process.argv.slice(2));
-
-	if (args.help) {
-		process.stdout.write(HELP);
-		return;
-	}
-	if (args.version) {
-		const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
-		process.stdout.write(JSON.parse(readFileSync(pkgPath, 'utf8')).version + '\n');
-		return;
-	}
-	if (args.unknown) {
-		process.stderr.write('apick-mcp: unknown argument ' + args.unknown + '\n\n' + HELP);
-		process.exitCode = 2;
-		return;
-	}
-	if (!SERVERS.includes(args.server)) {
-		process.stderr.write(
-			'apick-mcp: unknown server "' + args.server + '". Available: ' + SERVERS.join(', ') + '\n'
-		);
-		process.exitCode = 2;
-		return;
-	}
-
-	const bridge = createBridge({
-		server: args.server,
-		apiKey: process.env.APICK_API_KEY,
-		endpoint: process.env.APICK_MCP_URL
-	});
-
-	if (!process.env.APICK_API_KEY) {
-		process.stderr.write(
-			'apick-mcp: no APICK_API_KEY set - tool discovery works, tool calls will ask you to sign in at https://apick.app\n'
-		);
-	}
-
-	await bridge.attach(process.stdin);
-}
-
-main().catch((err) => {
-	process.stderr.write('apick-mcp: ' + err.message + '\n');
-	process.exitCode = 1;
-});
+#!/usr/bin/env node
+// apick-mcp - run the APICK MCP server over stdio.
+//
+// Usage:
+//   apick-mcp [--server <name>]
+//
+// Environment:
+//   APICK_API_KEY     APICK license key. Optional: tools/list works without one,
+//                     tools/call needs it.
+//   APICK_MCP_SERVER  Which server to expose (default: all).
+//   APICK_MCP_URL     Base URL override (default: https://apick.app/mcp).
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { createBridge, DEFAULT_ENDPOINT, SERVERS } from './bridge.js';
+
+const HELP = `apick-mcp - APICK MCP server over stdio
+
+  apick-mcp [--server <name>]
+
+Options
+  --server, -s <name>  ${SERVERS.join(', ')}  (default: all)
+  --version, -v        print version
+  --help, -h           print this message
+
+Environment
+  APICK_API_KEY        APICK license key (get one at https://apick.app)
+  APICK_MCP_SERVER     same as --server
+  APICK_MCP_URL        base URL override (default: ${DEFAULT_ENDPOINT})
+
+Clients that support remote MCP can skip this bridge and connect straight to
+${DEFAULT_ENDPOINT}/all with an Authorization: Bearer header.
+Docs: https://apick.app/dev_guide/mcp
+`;
+
+function parseArgs(argv) {
+	const args = { server: process.env.APICK_MCP_SERVER || 'all' };
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === '--help' || arg === '-h') args.help = true;
+		else if (arg === '--version' || arg === '-v') args.version = true;
+		else if (arg === '--server' || arg === '-s') args.server = argv[++i];
+		else if (arg.startsWith('--server=')) args.server = arg.slice('--server='.length);
+		else args.unknown = arg;
+	}
+	return args;
+}
+
+async function main() {
+	const args = parseArgs(process.argv.slice(2));
+
+	if (args.help) {
+		process.stdout.write(HELP);
+		return;
+	}
+	if (args.version) {
+		const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
+		process.stdout.write(JSON.parse(readFileSync(pkgPath, 'utf8')).version + '\n');
+		return;
+	}
+	if (args.unknown) {
+		process.stderr.write('apick-mcp: unknown argument ' + args.unknown + '\n\n' + HELP);
+		process.exitCode = 2;
+		return;
+	}
+	if (!SERVERS.includes(args.server)) {
+		process.stderr.write(
+			'apick-mcp: unknown server "' + args.server + '". Available: ' + SERVERS.join(', ') + '\n'
+		);
+		process.exitCode = 2;
+		return;
+	}
+
+	const bridge = createBridge({
+		server: args.server,
+		apiKey: process.env.APICK_API_KEY,
+		endpoint: process.env.APICK_MCP_URL
+	});
+
+	if (!process.env.APICK_API_KEY) {
+		process.stderr.write(
+			'apick-mcp: no APICK_API_KEY set - tool discovery works, tool calls will ask you to sign in at https://apick.app\n'
+		);
+	}
+
+	await bridge.attach(process.stdin);
+}
+
+main().catch((err) => {
+	process.stderr.write('apick-mcp: ' + err.message + '\n');
+	process.exitCode = 1;
+});