apick-mcp 2.0.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # 변경 기록
 
+## 2.2.0 - 2026-09-01
+
+- 운영 MCP에 비동기 TTS 접수·상태·취소·MP3·ASS 자막 Tool 5종을 동기화했습니다.
+- 전체 83개, Convert 그룹 19개 Tool 계약으로 갱신했습니다.
+- TTS 입력 한도를 실제 계약인 800자로 바로잡고, MP3·ASS를 각각 한 번 다운로드하는 규칙을 반영했습니다.
+- 허용 IP 공란·CIDR·즉시 반영과 `tools/list`의 무인증 범위를 한영 문서에 추가했습니다.
+
+## 2.1.2 - 2026-08-31
+
+- `tts_jobs_cancel`이 `waiting`뿐 아니라 `processing` 작업도 취소하는 계약을 한영 문서에 반영했습니다.
+- 실행 중 취소에도 접수 시 과금액은 환불되지 않습니다.
+- 17개 TTS `voice_id`의 사용자 표시 이름을 공개 문서와 도구 설명에 추가했습니다.
+
+## 2.1.1 - 2026-08-30
+
+- TTS 결과 다운로드 계약을 ZIP에서 MP3(`audio/mpeg`)로 맞췄습니다.
+
+## 2.1.0 - 2026-08-30
+
+- 비동기 TTS 작업 접수·상태 조회·대기 취소·1회 결과 다운로드 Tool 4종을 추가했습니다.
+- 17개 중립 내레이션 `voice_id`, 접수 시 과금, 취소 시 미환불, 결과 즉시 소모 계약을 문서화했습니다.
+- 운영 `tools/list`와 공개 카탈로그를 전체 82개, Convert 그룹 18개로 확장했습니다.
+
+## 2.0.1 - 2026-08-30
+
+- 종료된 기존 동기 TTS Tool과 사용법을 공개 문서·키워드에서 제거했습니다.
+- 운영 `tools/list`와 공개 카탈로그를 전체 78개, Convert 그룹 14개로 동기화했습니다.
+
 ## 2.0.0 - 2026-08-30
 
 - 종료된 이미지 기능과 관련 문서·메타데이터를 제거했습니다.

package/README.md

@@ -2,7 +2,7 @@
 
 <img src="https://raw.githubusercontent.com/lead788/apick-mcp/main/assets/logo-400.png" alt="APICK" width="88" height="88">
 
-# APICK MCP — 79 Korean Data & AI Tools
+# APICK MCP — 83 Korean Data & AI Tools
 
 **Korean business registry, ID verification, OCR, parcel tracking, file conversion, web intelligence and LLM — as MCP tools for any AI agent.**
 
@@ -22,9 +22,9 @@
 
 ## What is this? / 이게 뭔가요?
 
-**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **79 tools** that let Claude, ChatGPT, Cursor, Cline and any other MCP client look up Korean business registries, verify ID documents, track parcels, run OCR, convert files, query DNS/WHOIS, search the web, and call LLMs — using one API key, billed per call.
+**EN** — APICK is a Korean data and AI API platform. This MCP server exposes **83 tools** that let Claude, ChatGPT, Cursor, Cline and any other MCP client look up Korean business registries, verify ID documents, track parcels, run OCR, create asynchronous TTS jobs, convert files, query DNS/WHOIS, search the web, and call LLMs — using one API key, billed per call.
 
-**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 79개**를 열어, Claude·ChatGPT·Cursor·Cline 등 MCP 클라이언트가 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 파일 변환, DNS/WHOIS 조회, 웹 검색, LLM 호출을 **인증키 하나로** 직접 수행하게 합니다. 호출당 과금입니다.
+**KO** — 에이픽(APICK)은 대한민국 데이터·AI API 플랫폼입니다. 이 MCP 서버는 **Tool 83개**를 열어, Claude·ChatGPT·Cursor·Cline 등 MCP 클라이언트가 사업자 조회, 신분증 진위확인, 택배 배송조회, OCR, 비동기 TTS, 파일 변환, DNS/WHOIS 조회, 웹 검색, LLM 호출을 **인증키 하나로** 직접 수행하게 합니다. 호출당 과금입니다.
 
 **The server is hosted by APICK. Nothing to install, build, or keep running.**
 **서버는 에이픽이 운영합니다. 설치할 것도, 띄워둘 것도 없습니다.**
@@ -42,8 +42,11 @@ https://apick.app/mcp/all
 Sign up at **[apick.app](https://apick.app)** and copy your license key from the dashboard. New accounts get **1,000 free points**.
 **[apick.app](https://apick.app)** 에서 가입하고 대시보드에서 인증키를 복사하세요. 신규 가입 시 **1,000포인트 무료**.
 
-> `tools/list` works **without** a key — a client can connect and discover all 79 tools before you sign up. Only `tools/call` needs the key.
-> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 79개 Tool을 확인할 수 있고, `tools/call`부터 키가 필요합니다.
+> `tools/list` works **without** a key — a client can connect and discover all 83 tools before you sign up. Only `tools/call` validates the key and allowed IP.
+> `tools/list`는 **인증 없이** 동작합니다. 가입 전에도 클라이언트가 연결해 83개 Tool을 확인할 수 있고, 키와 허용 IP는 `tools/call`부터 검증합니다.
+
+Leave the allowed-IP list blank for unrestricted access. To restrict access, register the public IPv4 address seen by APICK as an exact address or CIDR such as `/32`. Changes apply immediately with no separate synchronization.
+마이페이지의 허용 IP가 공란이면 제한 없이 사용할 수 있습니다. 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화는 필요하지 않습니다.
 
 ### 2. Connect / 연결
 
@@ -146,10 +149,10 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 | Server 서버 | Endpoint | Tools | Coverage 범위 |
 | --- | --- | --- | --- |
-| **All 통합** | `https://apick.app/mcp/all` | **79** | 아래 전부 |
+| **All 통합** | `https://apick.app/mcp/all` | **83** | 아래 전부 |
 | [Business 사업자·커머스](TOOLS.md#business) | `https://apick.app/mcp/business` | 16 | 사업자·법인 조회, 택배 배송조회, 부동산 실거래가, 차량 이력, 유효성 검사 |
 | [Identity 신분증](TOOLS.md#identity) | `https://apick.app/mcp/identity` | 16 | 주민등록증·운전면허증·여권·외국인등록증 진위확인, 실명확인, 개인정보 마스킹 |
-| [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 15 | PDF·DOCX·엑셀 변환, STT, TTS, 워터마크 |
+| [Convert 파일변환](TOOLS.md#convert) | `https://apick.app/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, STT, 비동기 TTS, 워터마크 |
 | [Web 웹·검색](TOOLS.md#web) | `https://apick.app/mcp/web` | 13 | 도메인·IP·WHOIS, 웹페이지 수집, 구글 검색, 유튜브 |
 | [Vision 이미지·영상](TOOLS.md#vision) | `https://apick.app/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출 |
 | [OCR 문자인식](TOOLS.md#ocr) | `https://apick.app/mcp/ocr` | 6 | 이미지 텍스트 추출, 신분증 항목 추출 |
@@ -158,8 +161,8 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 ### Every tool / 전체 Tool
 
-**[→ TOOLS.md](TOOLS.md)** — all 79 tools with parameters, types, and copy-paste JSON-RPC examples.
-**[→ TOOLS.md](TOOLS.md)** — 79개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
+**[→ TOOLS.md](TOOLS.md)** — all 83 tools with parameters, types, and copy-paste JSON-RPC examples.
+**[→ TOOLS.md](TOOLS.md)** — 83개 전체를 파라미터·타입·호출 예시까지 정리했습니다.
 
 <details>
 <summary><b>Tool names at a glance / Tool 이름 한눈에 보기</b></summary>
@@ -174,7 +177,7 @@ Connect to `all` for everything, or to one server to keep the tool list short an
 
 **Web** `nslookup` `reverse_ip` `location` `ip_history` `whois` `url_html` `url_screenshot` `url_similarity` `google_search` `google_image_search` `google_lens_search` `crawl_youtube` `download_youtube_video`
 
-**Convert** `stt` `tts` `voice_change` `face_blur` `pdf_to_docx` `pdf_to_image` `pdf_merge` `html_to_pdf` `docx_to_pdf` `json_to_excel` `base64_to_image` `set_watermark` `get_watermark` `draw_watermark_pdf` `draw_watermark_image`
+**Convert** `stt` `tts_jobs_create` `tts_jobs_status` `tts_jobs_cancel` `tts_jobs_result` `tts_jobs_subtitles` `voice_change` `face_blur` `pdf_to_docx` `pdf_to_image` `pdf_merge` `html_to_pdf` `docx_to_pdf` `json_to_excel` `base64_to_image` `set_watermark` `get_watermark` `draw_watermark_pdf` `draw_watermark_image`
 
 **Vision** `nsfw_detection` `image_similarity` `video_to_mp3` `extract_video_thumbnail` `word_cloud` `face_detection`
 
@@ -223,8 +226,8 @@ Auto-detects the carrier from the number alone across **33 Korean carriers** (CJ
 
 `pdf_merge` → `draw_watermark_pdf` → `pdf_to_docx`
 
-Also: `html_to_pdf` for invoices and reports, `json_to_excel` for data exports, `stt`/`tts` for audio.
-견적서·리포트는 `html_to_pdf`, 데이터 내보내기는 `json_to_excel`, 음성은 `stt`/`tts`.
+Also: `html_to_pdf` for invoices and reports, `json_to_excel` for data exports, and `stt` for speech recognition.
+견적서·리포트는 `html_to_pdf`, 데이터 내보내기는 `json_to_excel`, 음성 인식은 `stt`를 사용합니다.
 
 ### 5. Domain & fraud investigation — 도메인·사기 조사
 
@@ -262,22 +265,30 @@ Built for phishing and copycat-site investigation: resolve the host, trace its I
 | **Transport** | Streamable HTTP — one endpoint per server, JSON-RPC 2.0 over HTTPS POST, stateless | 서버당 단일 엔드포인트, HTTPS POST로 JSON-RPC 2.0, 세션 없이 요청 단위 |
 | **Protocol** | MCP `2026-07-28`, auto-compatible with earlier client versions | MCP `2026-07-28` 기본, 이전 규격 클라이언트 자동 호환 |
 | **Discovery** | `tools/list` returns every tool with JSON Schema, description and live price — no key needed | `tools/list`가 스키마·설명·실시간 단가를 반환, 인증 불필요 |
-| **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. Only 3 of 79 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 79개 중 부작용은 3개뿐 |
-| **Results** | Text (JSON) + `structuredContent`. Images as image content, files as base64 up to 8MB | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 파일은 8MB까지 base64 |
+| **Annotations** | Every tool declares `title`, `readOnlyHint`, `openWorldHint`. Only 7 of 83 are not read-only | 전 Tool이 `title`·`readOnlyHint`·`openWorldHint` 선언. 83개 중 부작용은 7개뿐 |
+| **Results** | Text (JSON) + `structuredContent`. Images as image content; files up to 8MB as base64 | 텍스트(JSON)와 `structuredContent` 동시 반환. 이미지는 이미지 콘텐츠, 8MB 이하 파일은 base64 |
 | **File input** | File-taking tools accept a public `https` URL (`image_url`, `pdf_url`, …) — APICK downloads and processes it | 파일 Tool은 공개 `https` URL을 받습니다. 에이픽 서버가 내려받아 처리합니다 |
 | **Errors** | Delivered via `isError`; identity masking also preserves `structuredContent.error_code` | `isError`로 전달되며 신분증 마스킹은 `structuredContent.error_code`도 보존합니다 |
 | **Auth** | `Authorization: Bearer <key>`; `X-API-Key` also accepted | `Authorization: Bearer 인증키`, `X-API-Key`도 지원 |
 
 ### Tools with side effects / 부작용이 있는 Tool
 
-76 of 79 tools are read-only. These 3 change something in the real world and carry `readOnlyHint: false` so your client can require approval:
-79개 중 76개는 조회입니다. 아래 3개만 현실에 영향을 주며 `readOnlyHint: false`가 붙어 클라이언트가 승인을 요구할 수 있습니다.
+76 of 83 tools are read-only. These 7 change state, charge points, cancel work, or consume a one-time result and carry `readOnlyHint: false` so your client can require approval:
+83개 중 76개는 조회입니다. 아래 7개는 과금·취소·1회 결과 소모 등 상태를 바꾸므로 `readOnlyHint: false`가 붙어 클라이언트가 승인을 요구할 수 있습니다.
 
 | Tool | What it does / 하는 일 |
 | --- | --- |
 | `transfer_1won` | Deposits 1 KRW into a bank account · 실제로 1원을 입금합니다 |
 | `req_pccc` | Sends a verification SMS to the person · 본인 휴대폰으로 인증 SMS를 발송합니다 |
 | `get_pccc` | Consumes a one-time verification code · 1회용 인증 응답을 소모합니다 |
+| `tts_jobs_create` | Accepts and charges a TTS job once · TTS 작업을 접수하고 1회 과금합니다 |
+| `tts_jobs_cancel` | Cancels a waiting or processing job without a refund · 대기·생성 중 작업을 환불 없이 취소합니다 |
+| `tts_jobs_result` | Permanently consumes the one-time result · 1회용 결과 원본을 영구 소모합니다 |
+| `tts_jobs_subtitles` | Permanently consumes the one-time ASS subtitles · 1회용 ASS 자막 원본을 영구 소모합니다 |
+
+TTS 보이스 표시 이름: `narrator_m_01` 태준, `narrator_m_02` 민석, `narrator_m_03` 도현, `narrator_m_04` 강우, `narrator_m_05` 성훈, `narrator_f_10s_01` 서아, `narrator_f_10s_02` 하린, `narrator_f_10s_03` 예린, `narrator_m_20s_01` 도윤, `narrator_f_20s_01` 지안, `narrator_f_20s_02` 서윤, `narrator_f_20s_03` 소연, `narrator_f_20s_04` 유나, `narrator_m_30s_01` 현우, `narrator_m_30s_02` 준혁, `narrator_m_40s_01` 정우, `narrator_m_80s_01` 영수.
+
+TTS 작업 입력은 최대 800자입니다. 완성된 MP3와 ASS 자막은 서로 독립된 1회용 원본이므로, 결과를 저장할 준비가 된 뒤 `tts_jobs_result`와 `tts_jobs_subtitles`를 각각 한 번만 호출하세요.
 
 ### Try it with curl / curl로 바로 확인
 
@@ -340,11 +351,11 @@ Prepaid points, charged per call, at the same rate as the APICK REST API. No sub
 
 ## Keywords / 검색 키워드
 
-Korean business registry API · 사업자등록번호 조회 API · business registration number lookup · 휴폐업 조회 · 법인등록번호 · 벤처기업 조회 · Korean ID verification · 신분증 진위확인 API · 주민등록증 진위확인 · 운전면허증 진위확인 · 여권 진위확인 · 외국인등록증 · 실명확인 · 주민번호 마스킹 · 개인정보 비식별화 · Korean OCR API · 신분증 OCR · 문자인식 · parcel tracking API Korea · 택배 배송조회 API · 운송장 조회 · CJ대한통운 한진 롯데택배 우체국 로젠 · 계좌 실명조회 · 예금주 조회 · 1원 인증 API · 개인통관고유부호 · PCCC · 부동산 실거래가 API · 침수차 조회 · 폐차 조회 · 도로명주소 검색 API · 공휴일 API · WHOIS API · DNS lookup · IP 위치조회 · 웹페이지 스크린샷 API · 구글 검색 API · 구글 이미지 검색 · 구글 렌즈 · 유튜브 크롤링 · PDF 변환 API · PDF to DOCX · HTML to PDF · 엑셀 변환 · 워터마크 API · STT 음성인식 API · TTS 음성합성 API · 얼굴 인식 API · 얼굴 블러 · 유해이미지 판별 · NSFW detection · 이미지 유사도 · 워드클라우드 · LLM API
+Korean business registry API · 사업자등록번호 조회 API · business registration number lookup · 휴폐업 조회 · 법인등록번호 · 벤처기업 조회 · Korean ID verification · 신분증 진위확인 API · 주민등록증 진위확인 · 운전면허증 진위확인 · 여권 진위확인 · 외국인등록증 · 실명확인 · 주민번호 마스킹 · 개인정보 비식별화 · Korean OCR API · 신분증 OCR · 문자인식 · parcel tracking API Korea · 택배 배송조회 API · 운송장 조회 · CJ대한통운 한진 롯데택배 우체국 로젠 · 계좌 실명조회 · 예금주 조회 · 1원 인증 API · 개인통관고유부호 · PCCC · 부동산 실거래가 API · 침수차 조회 · 폐차 조회 · 도로명주소 검색 API · 공휴일 API · WHOIS API · DNS lookup · IP 위치조회 · 웹페이지 스크린샷 API · 구글 검색 API · 구글 이미지 검색 · 구글 렌즈 · 유튜브 크롤링 · PDF 변환 API · PDF to DOCX · HTML to PDF · 엑셀 변환 · 워터마크 API · STT 음성인식 API · 얼굴 인식 API · 얼굴 블러 · 유해이미지 판별 · NSFW detection · 이미지 유사도 · 워드클라우드 · LLM API
 
 ## Hashtags
 
-`#MCP` `#ModelContextProtocol` `#MCPServer` `#MCPTools` `#AIAgent` `#ClaudeMCP` `#ClaudeCode` `#ClaudeDesktop` `#ChatGPT` `#Cursor` `#Cline` `#Windsurf` `#VSCode` `#APICK` `#에이픽` `#OpenAPI` `#RESTAPI` `#KoreaAPI` `#한국API` `#사업자조회` `#사업자등록번호조회` `#휴폐업조회` `#신분증진위확인` `#실명확인` `#본인인증` `#개인정보마스킹` `#OCR` `#문자인식` `#택배조회` `#배송조회` `#운송장조회` `#계좌실명조회` `#1원인증` `#통관고유부호` `#부동산실거래가` `#도로명주소` `#공휴일API` `#WHOIS` `#DNS` `#IP조회` `#웹크롤링` `#구글검색API` `#스크린샷API` `#PDF변환` `#DOCX변환` `#엑셀변환` `#워터마크` `#STT` `#TTS` `#음성인식` `#음성합성` `#얼굴인식` `#얼굴블러` `#유해이미지` `#NSFW` `#이미지유사도` `#LLM` `#AI이미지생성` `#KYC` `#KYB` `#핀테크` `#이커머스` `#물류자동화` `#업무자동화`
+`#MCP` `#ModelContextProtocol` `#MCPServer` `#MCPTools` `#AIAgent` `#ClaudeMCP` `#ClaudeCode` `#ClaudeDesktop` `#ChatGPT` `#Cursor` `#Cline` `#Windsurf` `#VSCode` `#APICK` `#에이픽` `#OpenAPI` `#RESTAPI` `#KoreaAPI` `#한국API` `#사업자조회` `#사업자등록번호조회` `#휴폐업조회` `#신분증진위확인` `#실명확인` `#본인인증` `#개인정보마스킹` `#OCR` `#문자인식` `#택배조회` `#배송조회` `#운송장조회` `#계좌실명조회` `#1원인증` `#통관고유부호` `#부동산실거래가` `#도로명주소` `#공휴일API` `#WHOIS` `#DNS` `#IP조회` `#웹크롤링` `#구글검색API` `#스크린샷API` `#PDF변환` `#DOCX변환` `#엑셀변환` `#워터마크` `#STT` `#음성인식` `#얼굴인식` `#얼굴블러` `#유해이미지` `#NSFW` `#이미지유사도` `#LLM` `#KYC` `#KYB` `#핀테크` `#이커머스` `#물류자동화` `#업무자동화`
 
 ---
 

package/TOOLS.md

@@ -1,7 +1,7 @@
 # APICK MCP — Full Tool Catalog / 전체 Tool 목록
 
-**79 tools** across **8 domain servers**, plus the combined `all` server.
-**Tool 79개**, 분야별 서버 8개와 통합 서버 `all`.
+**83 tools** across **8 domain servers**, plus the combined `all` server.
+**Tool 83개**, 분야별 서버 8개와 통합 서버 `all`.
 
 Official site 공식 사이트: **<https://apick.app>** · Docs 연동 가이드: **<https://apick.app/dev_guide/mcp>**
 
@@ -17,12 +17,12 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
 | [OCR · OCR 문자인식](#ocr) | `/mcp/ocr` | 6 | 이미지 텍스트 추출과 신분증 항목 추출. |
 | [Finance · 금융 · 계좌확인](#finance) | `/mcp/finance` | 3 | 계좌 예금주 실명조회와 1원 인증. |
 | [Web & Search · 웹 · 검색](#web) | `/mcp/web` | 13 | 도메인·IP 조회, WHOIS, 웹페이지 수집, 구글 검색, 유튜브. |
-| [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 15 | PDF·DOCX·엑셀 변환, 음성인식(STT), 음성합성(TTS), 워터마크. |
+| [File Conversion · 파일 변환 · 워터마크](#convert) | `/mcp/convert` | 19 | PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크. |
 | [Vision · 이미지 · 영상 분석](#vision) | `/mcp/vision` | 6 | 얼굴 검출, 이미지 유사도, 유해이미지 판별, 영상 추출. |
 | [AI & LLM · AI · LLM](#ai) | `/mcp/ai` | 4 | LLM 챗(다중 모델), 텍스트 요약·교정. |
-| **All 통합** | `/mcp/all` | **79** | 아래 전부 |
+| **All 통합** | `/mcp/all` | **83** | 아래 전부 |
 
-<details><summary><b>All 79 tool names / 전체 Tool 이름</b></summary>
+<details><summary><b>All 83 tool names / 전체 Tool 이름</b></summary>
 
 `biz_detail` · `venture_biz_info` · `land_rt_price` · `req_pccc` · `get_pccc` · `check_pccc` · `get_car_flooding` · `get_car_scrap` · `parcel_tracking` · `parcel_tracking_auto` · `check_email_valid` · `check_phone_valid` · `check_spam_number` · `holiday_info` · `search_juso` · `info`
 
@@ -34,7 +34,7 @@ Endpoint pattern: `https://apick.app/mcp/{server}` — connect to `all` for ever
 
 `nslookup` · `reverse_ip` · `location` · `ip_history` · `whois` · `url_html` · `url_screenshot` · `url_similarity` · `google_search` · `google_image_search` · `google_lens_search` · `crawl_youtube` · `download_youtube_video`
 
-`stt` · `tts` · `voice_change` · `face_blur` · `pdf_to_docx` · `pdf_to_image` · `pdf_merge` · `html_to_pdf` · `docx_to_pdf` · `json_to_excel` · `base64_to_image` · `set_watermark` · `get_watermark` · `draw_watermark_pdf` · `draw_watermark_image`
+`stt` · `tts_jobs_create` · `tts_jobs_status` · `tts_jobs_cancel` · `tts_jobs_result` · `tts_jobs_subtitles` · `voice_change` · `face_blur` · `pdf_to_docx` · `pdf_to_image` · `pdf_merge` · `html_to_pdf` · `docx_to_pdf` · `json_to_excel` · `base64_to_image` · `set_watermark` · `get_watermark` · `draw_watermark_pdf` · `draw_watermark_image`
 
 `nsfw_detection` · `image_similarity` · `video_to_mp3` · `extract_video_thumbnail` · `word_cloud` · `face_detection`
 
@@ -1199,16 +1199,20 @@ Download a publicly available YouTube video and return it as an MP4 file.
 
 ## File Conversion · 파일 변환 · 워터마크
 
-`https://apick.app/mcp/convert` — 15 tools
+`https://apick.app/mcp/convert` — 19 tools
 
-PDF, DOCX, Excel, speech-to-text, text-to-speech, and watermarking.
+PDF, DOCX, Excel, speech-to-text, asynchronous TTS jobs, and watermarking.
 
-PDF·DOCX·엑셀 변환, 음성인식(STT), 음성합성(TTS), 워터마크.
+PDF·DOCX·엑셀 변환, 음성인식(STT), 비동기 TTS, 워터마크.
 
 | Tool | 기능 | Required 필수 |
 | --- | --- | --- |
 | [`stt`](#stt) | 오디오 텍스트 변환(STT) | `audio_url` |
-| [`tts`](#tts) | 텍스트 오디오 변환(TTS) | `content` |
+| [`tts_jobs_create`](#tts-jobs-create) | TTS 작업 접수 | `voice_id`, `text` |
+| [`tts_jobs_status`](#tts-jobs-status) | TTS 작업 상태 조회 | `job_id` |
+| [`tts_jobs_cancel`](#tts-jobs-cancel) | TTS 대기·생성 중 작업 취소 | `job_id` |
+| [`tts_jobs_result`](#tts-jobs-result) | TTS 결과 1회 다운로드 | `job_id` |
+| [`tts_jobs_subtitles`](#tts-jobs-subtitles) | TTS ASS 자막 1회 다운로드 | `job_id` |
 | [`voice_change`](#voice-change) | 음성 변조 | `type`, `media_url` |
 | [`face_blur`](#face-blur) | 얼굴 모자이크 처리 | `image_url` |
 | [`pdf_to_docx`](#pdf-to-docx) | PDF 파일 DOCX 변환 | `pdf_url` |
@@ -1242,23 +1246,87 @@ Convert a speech audio file to text (STT).
 {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"stt","arguments":{"audio_url":"https://example.com/file"}}}
 ```
 
-<a id="tts"></a>
+<a id="tts-jobs-create"></a>
 
-### `tts` — 텍스트 오디오 변환(TTS)
+### `tts_jobs_create` — TTS 작업 접수
 
-Convert text to a speech audio file (TTS, MP3).
+17개 중립 내레이션 목소리 중 하나로 유료 비동기 TTS 작업을 접수합니다. 접수 성공 시 즉시 과금되며 취소해도 환불되지 않습니다. `text`는 최대 800자입니다.
 
-텍스트를 오디오(MP3) 파일로 변환합니다. 한글/영어 최대 1,000자까지 입력할 수 있으며, 결과는 MP3 파일로 반환됩니다.
+표시 이름: `narrator_m_01` 태준, `narrator_m_02` 민석, `narrator_m_03` 도현, `narrator_m_04` 강우, `narrator_m_05` 성훈, `narrator_f_10s_01` 서아, `narrator_f_10s_02` 하린, `narrator_f_10s_03` 예린, `narrator_m_20s_01` 도윤, `narrator_f_20s_01` 지안, `narrator_f_20s_02` 서윤, `narrator_f_20s_03` 소연, `narrator_f_20s_04` 유나, `narrator_m_30s_01` 현우, `narrator_m_30s_02` 준혁, `narrator_m_40s_01` 정우, `narrator_m_80s_01` 영수.
 
-> 읽기 전용 / read-only · 입력 변환 / transforms your input · server `convert`
+> **부작용 있음 / has side effects** · 접수 시 과금 / charged on acceptance · server `convert`
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `voice_id` | `string` | **필수 / required** | 지원 `voice_id`. `narrator_m_01`–`05`, `narrator_f_10s_01`–`03`, `narrator_m_20s_01`, `narrator_f_20s_01`–`04`, `narrator_m_30s_01`–`02`, `narrator_m_40s_01`, `narrator_m_80s_01` |
+| `text` | `string` | **필수 / required** | 합성할 한국어 텍스트, 최대 800자 |
+
+```json
+{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tts_jobs_create","arguments":{"voice_id":"narrator_m_03","text":"오늘의 이야기를 시작합니다."}}}
+```
+
+<a id="tts-jobs-status"></a>
+
+### `tts_jobs_status` — TTS 작업 상태 조회
+
+작업의 `waiting`, `processing`, `completed`, `cancelled`, `failed` 공개 상태와 결과 준비 여부를 조회합니다. 추가 과금은 없습니다.
+
+> 읽기 전용 / read-only · server `convert`
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `job_id` | `string` | **필수 / required** | 작업 접수에서 받은 32자리 ID |
+
+```json
+{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"tts_jobs_status","arguments":{"job_id":"<job_id>"}}}
+```
+
+<a id="tts-jobs-cancel"></a>
+
+### `tts_jobs_cancel` — TTS 대기·생성 중 작업 취소
+
+`waiting` 또는 `processing` 상태에서 취소할 수 있으며 접수 시 과금된 금액은 환불되지 않습니다.
+
+> **부작용 있음 / has side effects** · 환불 없음 / no refund · server `convert`
 
 | Parameter | Type | Required | Description 설명 |
 | --- | --- | --- | --- |
-| `content` | `string` | **필수 / required** | 오디오로 변환할 텍스트 (한글/영어 최대 1,000자) |
-| `language` | `string` | 선택 / optional | 언어 코드 (예: ko, en). 기본값 ko |
+| `job_id` | `string` | **필수 / required** | 취소할 32자리 ID |
 
 ```json
-{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tts","arguments":{"content":"<content>"}}}
+{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"tts_jobs_cancel","arguments":{"job_id":"<job_id>"}}}
+```
+
+<a id="tts-jobs-result"></a>
+
+### `tts_jobs_result` — TTS 결과 1회 다운로드
+
+완료된 MP3(`audio/mpeg`) 결과를 base64로 반환합니다. Tool 호출로 다운로드가 시작되는 즉시 서버 원본이 폐기되므로, 호출 실패나 전송 중단을 포함해 재다운로드할 수 없습니다. 결과를 받을 준비가 된 클라이언트에서 한 번만 호출하세요.
+
+> **파괴적 부작용 / destructive side effect** · 재실행 불가 / not idempotent · server `convert`
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `job_id` | `string` | **필수 / required** | `completed` 상태인 32자리 ID |
+
+```json
+{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"tts_jobs_result","arguments":{"job_id":"<job_id>"}}}
+```
+
+<a id="tts-jobs-subtitles"></a>
+
+### `tts_jobs_subtitles` — TTS ASS 자막 1회 다운로드
+
+완료된 ASS 타이밍 자막(`text/x-ass`)을 base64로 반환합니다. MP3와 별도의 1회용 원본이므로 MP3를 먼저 다운로드해도 자막을 한 번 받을 수 있습니다. Tool 호출로 자막 다운로드가 시작되는 즉시 자막 원본이 폐기되므로, 호출 실패나 전송 중단을 포함해 재다운로드할 수 없습니다.
+
+> **파괴적 부작용 / destructive side effect** · 재실행 불가 / not idempotent · server `convert`
+
+| Parameter | Type | Required | Description 설명 |
+| --- | --- | --- | --- |
+| `job_id` | `string` | **필수 / required** | `completed` 상태인 32자리 ID |
+
+```json
+{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"tts_jobs_subtitles","arguments":{"job_id":"<job_id>"}}}
 ```
 
 <a id="voice-change"></a>
@@ -1759,3 +1827,5 @@ Prepaid points, charged per call, identical to the APICK REST API rate. No subsc
 포인트 선불, 호출당 차감이며 단가는 에이픽 REST API와 동일합니다. 구독료·좌석당 요금 없음. **실패한 호출은 과금되지 않습니다.** 각 Tool의 현재 단가는 `tools/list` 응답의 설명에 자동으로 붙으므로 AI가 호출 전에 비용을 보고 판단합니다.
 
 Current rates 단가표: <https://apick.app/dev_guide/mcp> · Sign up for 1,000 free points 가입 시 1,000포인트 무료: <https://apick.app>
+
+`tools/list`는 API Key와 허용 IP를 검사하지 않으며 실제 검증은 `tools/call`에서 수행됩니다. 마이페이지의 허용 IP 목록이 공란이면 IP 제한이 없고, 제한하려면 APICK에 도착하는 공인 IPv4를 단일 주소 또는 CIDR(`/32` 등)로 등록하세요. 저장 즉시 반영되며 별도 동기화나 대기시간은 없습니다.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "apick-mcp",
-  "version": "2.0.0",
-  "description": "APICK MCP — 79 Korean data & AI tools for AI agents. 사업자조회·신분증 진위확인·OCR·택배 배송조회·계좌 실명조회·파일변환·WHOIS·구글검색·LLM. Korean business registry, ID verification, OCR, parcel tracking, bank account verification, file conversion, web intelligence and LLM over MCP.",
+  "version": "2.2.0",
+  "description": "APICK MCP — 83 Korean data & AI tools for AI agents. 사업자조회·신분증 진위확인·OCR·택배 배송조회·비동기 TTS·파일변환·WHOIS·구글검색·LLM. Korean business registry, ID verification, OCR, parcel tracking, asynchronous TTS, file conversion, web intelligence and LLM over MCP.",
   "type": "module",
   "license": "MIT",
   "author": "APICK",
@@ -80,7 +80,6 @@
     "excel",
     "watermark",
     "speech-to-text",
-    "text-to-speech",
     "face-detection",
     "face-blur",
     "nsfw-detection",